Bootstrap 5 レイアウトをインポートする
bx_Import の下で Bootstrap-5-テンプレートを header、footer、フレキシブルセクションテンプレート、および LayoutHTML に分割し、その後 bluetronix エディターで組み立てる方法を学びます。
チュートリアルの目的
このチュートリアルでは、既存の Bootstrap-5 レイアウトを bluetronix CMS にインポートします。その際、元のHTMLページをヘッダー、フッター、個々のセクションテンプレート、および実際のレイアウトフレームに分解します。その後、エディターで各ページセクションを自由に挿入、移動、そして再利用できます。
注意: このチュートリアルでは基本的なレイアウトインポートについて説明します。画像のさらなる編集または置き換えについては次のチュートリアルで説明します。
1. bx_Import で元のテンプレートを開く
ファイルマネージャでbx_Importフォルダを開きます。ここにはインポートされたレイアウトが最初はオリジナルの状態であります – たとえば、元の画像フォルダやHTMLファイルが含まれています。このエリアでは、利用可能なオリジナルファイルのみを使用します; 変更はオリジナルのテンプレートに戻されません。
この例では、index.htmlファイルを開き、編集に切り替えます。このファイルはCMSレイアウトの各要素に分解されます。
スクリーンショットプレースホルダー: 開いたフォルダbx_Import、画像フォルダ、元のHTMLファイルを含むファイルマネージャ – dev_bootstrap_import_bx_import_originaldateien.jpeg。画像を撮影し、この場所に埋め込んでください。
スクリーンショットプレースホルダー: HTMLエディタでのbx_Importのindex.html – dev_bootstrap_import_index_html_bearbeiten.jpeg。画像を撮影し、この場所に埋め込んでください。
2. index.html からヘッダーを切り離す
HTMLコード内でCtrl + Fを使用してheaderを検索します。多くのBootstrapテンプレートでは、適切なHTML要素によってヘッダーが素早く見つけられます。いくつかのテンプレートでは、ヘッダーがdiv領域のみで構成されている場合があります; この場合は、構成をより詳細に確認する必要があります。
ヘッダー全体を選択してコピーします。オリジナルテンプレートとCMSプロジェクトの間を切り替えられるように、2つのウィンドウで作業するのが最善です。
スクリーンショットプレースホルダー: 検索で見つけてコピーするためにマークされたindex.htmlのヘッダー領域 – dev_bootstrap_import_header_markieren.jpeg。画像を撮影し、この場所に埋め込んでください。
3. CMS にヘッダーを取り込む
プロジェクトに戻り、メインディレクトリを開き、次にヘッダー → HTMLコードを開きます。コピーしたヘッダーコードをそこに貼り付けます。
次にローカルパスを確認します。多くのレイアウトでは、相対参照と画像パスに先頭のスラッシュが必要であり、そうしないとCMS構造内で正しく機能しません。
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
重要: 再検索と置換にはCtrl + Hを使用しますが、パスを盲目的に置き換えないでください。特に外部URL、アンカー、mailto:-リンク、すでに絶対パスが含まれているかを確認してください。
スクリーンショットプレースホルダー: ヘッダーを挿入した状態のメインディレクトリ → ヘッダー → HTMLコード – dev_bootstrap_import_header_html_einfuegen.jpeg。画像を撮影し、この場所に埋め込んでください。
4. フッターを切り離して取り込む
次に元のindex.htmlからフッターを検索します。フッター全体を切り取りまたはコピーし、プロジェクトのメインディレクトリ内の指定されたフッターファイルに貼り付けます。ここでもすべてのローカルhrefおよびsrcパスを確認してください。
スクリーンショットプレースホルダー: フッターコードを挿入した状態のメインディレクトリのフッターファイル – dev_bootstrap_import_footer_html_einfuegen.jpeg。画像を撮影し、この場所に埋め込んでください。
5. メインエリアを個別のセクションテンプレートに分ける
ヘッダーとフッターの後に残るページコンテンツは、プロジェクトのindex.htmlに直接コピーされません。代わりに、bx_Layout → SectionTemplate.txt → HTMLコードを開きます。
オリジナルテンプレートの残りのメイン領域をこのファイルの最後に貼り付けます。その後、それを個々の領域に分割し、後でエディタで独立して利用できるようにします。
2つのセクションテンプレートの間に、正確に次の区切りを入れます:
<!--__SP_SectionTemplate__-->
このように区切られた各セクションは、後でエディタに独自のテンプレートとして挿入できます。これにより、セクションを自由に配置したり、複数回使用したり、ページ上で省略したりできます。
スクリーンショットプレースホルダー: 複数のセクションと区切り <!--__SP_SectionTemplate__-->を含むbx_Layout → SectionTemplate.txt – dev_bootstrap_import_sectiontemplate_trenner.jpeg。画像を撮影し、この場所に埋め込んでください。
6. レイアウトフレームを 00_layout に取り込む
ヘッダー、フッター、メインセクションを切り取った後、実際のHTMLフレームが残ります。これには、DOCTYPE、head領域、およびその他の親レイアウト要素が含まれます。この残りのコードをコピーします。
次にデータベース管理を開き、データベース00_layoutを編集します。すでにレイアウトテンプレートが利用可能です。既存のテンプレートを編集するか、新しいレイアウトを作成できます。
コピーしたフレームをLayoutHTMLの下に貼り付けます。ヘッダー、メインコンテンツ、フッターの元の位置にCMSマークを使用します:
__DB_Layout_Header__
__DB_Layout_Main__
__DB_Layout_Footer__
ページをレンダリングする際、これらのマークはそれぞれのヘッダー、現在のメインページ、フッターに置き換えられます。対応するPHPコードは、レイアウトを読み込む際に自動的に実行されます。
スクリーンショットプレースホルダー: LayoutHTMLとヘッダー、メイン、フッターのマークを含むデータベース00_layout – dev_bootstrap_import_00_layout_layouthtml.jpeg。画像を撮影し、この場所に埋め込んでください。
7. CSS、JavaScript、および Favicon のパスを確認する
レイアウトコード内で、すべてのCSS、JavaScript、ファビコンファイルへの参照を確認します。ローカルパスには必要な先頭のスラッシュを設定します。CSSおよびJavaScriptファイルには、CMSのファイルバージョンマークも使用します。
JavaScriptの呼び出しは、例えば次のようになります:
<script src="__FV_/bx_script/core.min.js__"></script>
マーク__FV_...__は、システムがファイルバージョンまたは変更日を考慮することを可能にします。これにより、ブラウザは変更後に最新のCSSまたはJavaScriptファイルを読み込み、ユーザーが手動でブラウザキャッシュを更新する必要がなくなります。
8. ヘッドコンテンツを整理し、ヘッダーHTMLを使用する
取り込まれたhead領域を確認し、CMSによってすでに設定された内容や他の場所で読み込まれている内容を削除します。システムによって自動的に生成される場合、固定されているページタイトルも削除できます.
エディターが必要とするHeaderコードで、LayoutHTMLの直接の一部ではないものは、Extras → Header-HTMLの下に保存します。こうすることで、エディターはページの編集時にそこで保存された内容を考慮できます.
スクリーンショットプレースホルダー: Extras → Header-HTMLに移動させたヘッダーコード - dev_bootstrap_import_extras_header_html.jpeg. 画像を撮影し、この場所に埋め込みます.
9. インポートしたレイアウトをページ用に選択する
新しいレイアウトを00_layoutに作成した場合、エディターでページ設定を開き、そこでインポートしたレイアウトを選択します。これにより、該当するページがこのレイアウトフレームで表示されます.
スクリーンショットプレースホルダー: 新しくインポートしたレイアウトの選択を伴うページ設定 - dev_bootstrap_import_seiteneinstellungen_layout.jpeg. 画像を撮影し、この場所に埋め込みます.
10. インポートしたセクションを使ってホームページを組み立てる
ページで編集をクリックします。ホームページは最初は空になっている可能性があります。これは正常であり、まだ新しいページセクションが実際のページに挿入されていないためです.
挿入 → ページセクションを選択します。事前にSectionTemplate.txtでセクション区切りで分けた領域が表示されるはずです.
必要なセクションを順番に挿入して、元のページを再現します。セクションを自由に移動したり、削除したり、複数回挿入することができます.
スクリーンショットプレースホルダー: エディター → 挿入 → インポートしたセクションテンプレートを持つページセクション - dev_bootstrap_import_sections_einfuegen.jpeg. 画像を撮影し、この場所に埋め込みます.
11. 元のページを参照として使用する
ファイル → bx_Importの下で元のindex.htmlをプレビューとして開き続けることができます。これを参照しながら、新しいCMSページを各セクションから組み立てます.
個々のテンプレートに最初に画像が欠けている場合、その正しい取り込みについては次回のチュートリアルで扱います.
12. すべてのセクションのパスと編集可能性を確認する
最後にもう一度Sections → Section Templateを確認し、すべてのローカルパスをチェックします。同様のパスが多くある場合は、Ctrl + Hを使用してテキストエディタで変更を効率的に行うことができます.
次に、エディターで各インポートされたセクションをテストします。すべてのコンテンツが正しく表示され、期待されるテキストや要素が編集できるかどうかを確認します.
例えば、テキストが編集できない場合は、そのHTML構造を確認します。通常のテキストが直接divコンテナ内にある場合、その構造に応じてテキストを適切なp要素に移動することが有効です.
スクリーンショットプレースホルダー: セクションの挿入と配置後に構成された完成版のホームページ - dev_bootstrap_import_fertige_startseite.jpeg. 画像を撮影し、この場所に埋め込みます.
13. なぜレイアウトが分割されるのか
ヘッダー、フッター、レイアウトフレーム、各セクションを分離することで、新しいページでこれらの要素を元のBootstrapファイルから何度もコピーする必要がなくなります.
中央のヘッダーとフッターは再利用可能で、各ページセクションはエディターで柔軟なテンプレートとして利用できます。これにより、Bootstrapテンプレートから異なるページを組み立て、コンテンツの順序をいつでも変更できます.
要約
Bootstrap-5インポートのために、bx_Importの下にあるオリジナルファイルをテンプレートとして使用します。ヘッダーとフッターは、指定されたCMS領域に分離され、メイン領域はSectionTemplate.txtを介して個別のテンプレートに分解され、残りのHTMLフレームは00_layout → LayoutHTMLに保存されます.
その後、ページ設定でレイアウトを選択し、挿入 → ページセクションからインポートしたセクションを組み立てます。最後にすべてのパス、CSSおよびJavaScriptの参照、および各セクションの編集可能性を確認します.
FAQ
お客様からよくある質問
なぜ元のBootstrapテンプレートがbx_Importの下に残るのですか?
フォルダーbx_Importは、インポートされたオリジナルテンプレートの出発点および参照として機能します。必要な要素はそこからそれぞれのCMS領域に移されます.
最初のインポートにはどのファイルを使用すればよいですか?
このチュートリアルでは、index.htmlを出発点として使用します。そこからヘッダー、フッター、メインセクション、および残りのレイアウトフレームが分離されます.
HTMLコードでヘッダーとフッターを素早く見つけるにはどうすればいいですか?
Ctrl + Fを使用して、例えばheaderやfooterを検索します。該当するHTMLタグがないテンプレートでは、周囲のdiv構造を詳しく確認する必要があります。
各ページセクションはどこに保存されますか?
テンプレートはbx_LayoutのSectionTemplate.txtに保存され、区切りは<!--__SP_SectionTemplate__-->で行われます。
LayoutHTMLにはどのブランドが必要ですか?
分離された領域の位置には、__DB_Layout_Header__、__DB_Layout_Main__、__DB_Layout_Footer__を使用します。
なぜCSSとJavaScriptファイルが__FV_でマークされるのですか?
これにより、CMSはレンダリング時にファイルのバージョンや変更日を考慮できます。変更後、ブラウザは古いキャッシュバージョンの代わりに最新のファイルを読み込むことができます。
レイアウトインポート後、なぜホームページは最初は空ですか?
レイアウトは最初に枠組みだけを提供します。実際のページセクションは、挿入 → ページセクションでページに挿入する必要があります。
インポートしたページセクションを複数回使用できますか?
はい。切り出されたセクションテンプレートは、エディタで必要に応じて挿入、移動、複数回使用できます。
相対パスの画像やリンクが機能しない場合はどうすればいいですか?
ローカルのhrefおよびsrcパスを確認し、必要に応じて先頭にスラッシュを追加します。Ctrl + Hで繰り返しのパスを置き換えることができますが、外部URLやアンカー、その他の特殊なパスは盲目的に変更しないでください。
エディタでテキストが編集できない場合はどうすればいいですか?
該当するセクションのHTML構造を確認してください。通常のテキストがdivコンテナ内に直接ある場合、構造に応じて適切なp要素を使用することが理にかなっています。
オリジナルのページと比べて再構築するにはどうすればいいですか?
ファイル → bx_Importの下で元のindex.htmlをプレビューを通じて開き、セクションの順序や構成の参考にします。