导入Bootstrap 5布局
学习如何在bx_Import下将一个Bootstrap 5模板分解为Header、Footer、灵活的Section模板和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中分离出Header
在HTML代码中使用Ctrl + F搜索header。对于许多Bootstrap模板,可以通过相应的HTML元素快速找到头部。在某些模板中,头部仅由一个div区域组成;在这种情况下,您需要更仔细地检查结构。
标记完整的头部区域并复制。最好同时打开两个窗口,以便您可以在原始模板和CMS项目之间切换。
截图占位符:通过搜索找到并标记的index.html头部区域以进行复制——dev_bootstrap_import_header_markieren.jpeg。请先拍摄图像,然后在此处嵌入。
3. 将Header导入CMS
返回到您的项目,打开主目录,然后打开Header → HTML代码。在这里粘贴之前复制的头部代码。
然后检查本地路径。对于许多布局,必须以斜杠开头的相对引用和图片路径,以确保它们在CMS结构中正常工作。
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
重要:使用Ctrl + H进行搜索和替换,但不要盲目替换路径。特别要检查外部URL、锚点、mailto:-链接和现有绝对路径。
截图占位符:主目录 → Header → 带有插入头部的HTML代码——dev_bootstrap_import_header_html_einfuegen.jpeg。请先拍摄图像,然后在此处嵌入。
4. 分离并导入Footer
接下来,在原始index.html中搜索底部。剪切或复制完整的底部区域并将其粘贴到项目主目录中指定的底部文件中。请检查所有本地的href和src路径。
截图占位符:主目录中的底部文件,包含插入的底部代码——dev_bootstrap_import_footer_html_einfuegen.jpeg。请先拍摄图像,然后在此处嵌入。
5. 将主区域拆分为单独的Section模板
在头部和底部之后,剩余的页面内容不会直接复制到您项目的index.html中。相反,打开bx_Layout → SectionTemplate.txt → HTML代码。
将原始模板的剩余主区域粘贴到该文件的末尾。然后将其分成各个区域,以便稍后在编辑器中单独提供。
在两个部分模板之间放置如下分隔符:
<!--__SP_SectionTemplate__-->
每个因此分隔的部分都可以作为自己的模板在编辑器中插入。这样,您可以自由排列部分、多次使用或在页面上省略。
截图占位符:bx_Layout → SectionTemplate.txt,其中包含多个部分和分隔符<!--__SP_SectionTemplate__-->——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代码在加载布局时会自动执行。
截图占位符:数据库00_layout,包含LayoutHTML和头部、主体和底部的标记——dev_bootstrap_import_00_layout_layouthtml.jpeg。请先拍摄图像,然后在此处嵌入。
7. 检查CSS、JavaScript和Favicon路径
检查布局代码中所有对 CSS、JavaScript 和 Favicon 文件的引用。在本地路径前添加所需的斜杠。对于 CSS 和 JavaScript 文件,还应该使用 CMS 的文件版本标记。
一个 JavaScript 调用可以如下所示:
<script src="__FV_/bx_script/core.min.js__"></script>
标记 __FV_...__ 使系统在渲染时考虑文件版本或修改日期。这样,浏览器可以在更改后加载当前的 CSS 或 JavaScript 文件,而无需用户手动更新浏览器缓存。
8. 清理Head内容并使用Header HTML
检查引入的 head 部分,并删除已经由 CMS 设置或在其他地方加载的内容。如果系统会自动生成页面标题,你也可以删除固定的页面标题。
编辑器需要的 Header 代码且不应直接包含在 LayoutHTML 中的内容应保存于 Extras → Header-HTML 中。这样,编辑器在编辑页面时可以考虑那里保存的内容。
截图占位符: Extras → Header-HTML 中移至此处的 Header 代码 – dev_bootstrap_import_extras_header_html.jpeg。请拍摄图像并在此处嵌入。
9. 选择要导入的页面布局
如果你在 00_layout 中创建了新的布局,请在编辑器中打开 页面设置,并选择你导入的布局。这样,该页面将以此布局框架呈现。
截图占位符: 页面设置中选择新导入布局的界面 – dev_bootstrap_import_seiteneinstellungen_layout.jpeg。请拍摄图像并在此处嵌入。
10. 从导入的Sections组合首页
点击页面上的 编辑。首页可能会首先显示为空。这是正常的,因为还没有将任何新的页面部分插入到实际页面中。
选择 插入 → 页面部分。在这里应该显示你之前在 SectionTemplate.txt 中用 Section 分隔符分开的区域。
依次插入所需的 Sections,以重建原始页面。你可以随意移动、删除或多次插入这些部分。
截图占位符: 编辑器 → 插入 → 页面部分中与导入的 Section 模板 – dev_bootstrap_import_sections_einfuegen.jpeg。请拍摄图像并在此处嵌入。
11. 将原始页面作为参考
在 文件 → bx_Import 中,你仍然可以预览原始的 index.html。在你从各个 Sections 组装新的 CMS 页面时,使用它作为参考。
如果某些模板中最初缺少图片,将在后续教程中处理它们的正确导入问题。
12. 检查所有Sections的路径和可编辑性
最后再检查一次 Sections → Section Template 并检查所有本地路径。对于许多相似路径,你可以通过 Ctrl + H 在文本编辑器中高效地进行更改。
然后在编辑器中测试每个导入的 Section。检查所有内容是否正确显示,以及所需的文本和元素是否可以编辑。
如果某个文本无法编辑,请检查其 HTML 结构。如果普通文本直接位于 div 容器中,根据布局,可能会将其移动到适当的 p 元素中。
截图占位符: 插入和排列 Sections 后完成的主页 – dev_bootstrap_import_fertige_startseite.jpeg。请拍摄图像并在此处嵌入。
13. 为什么要拆分布局
通过将 Header、Footer、布局框架和各个 Sections 分开,你不必每次都从原始 Bootstrap 文件中复制这些组成部分来创建新页面。
中央的 Header 和 Footer 可以重复使用,而各个页面部分作为灵活的模板在编辑器中使用。这样,你可以从一个 Bootstrap 模板中组合不同的页面,并随时改变内容的顺序。
总结
对于 Bootstrap-5 导入,使用 bx_Import 下的原始文件作为模板。Header 和 Footer 将被分别转移到规定的 CMS 区域,主区域将通过 SectionTemplate.txt 被拆分为单独的模板,剩余的 HTML 框架将在 00_layout → LayoutHTML 中保存。
然后在页面设置中选择布局,并通过 插入 → 页面部分 从导入的 Sections 中组合页面。最后检查所有路径、CSS 和 JavaScript 引用以及各个 Sections 的可编辑性。
常见问题
客户常问我们的问题
为什么原始的 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 在渲染时可以考虑文件版本或修改日期。修改后,浏览器可以加载当前文件,而不是使用过时的缓存版本。
为什么在导入布局后主页最初是空的?
布局首先只提供框架。实际的页面部分必须通过插入 → 页面部分插入到页面中。
我可以多次使用导入的页面部分吗?
可以。分开的 Section 模板可以根据需要在编辑器中插入、移动和重复使用。
如果相对图片或链接路径不工作,我该怎么办?
检查本地 href 和 src 路径,并在需要时添加前导斜杠。使用 Ctrl + H 可以替换重复的路径,但应谨慎修改外部 URL、锚点和其他特殊路径。
如果编辑器中的文本无法编辑,我该怎么办?
检查相关部分的 HTML 结构。如果普通文本直接位于 div 容器中,根据结构,使用合适的 p 元素可能更合适。
如何在重建时比较原始页面?
在文件 → bx_Import 的预览中打开原始的 index.html,并将其作为部分顺序和结构的参考。