Импортировать макет Bootstrap 5
Научитесь, как разобрать шаблон Bootstrap-5 в bx_Import на заголовок, подвал, гибкие шаблоны секций и LayoutHTML, а затем собрать их в редакторе bluetronix.
Цель учебного пособия
В этом учебном пособии вы импортируете готовый макет Bootstrap-5 в CMS bluetronix. При этом вы разбиваете исходную HTML-страницу на заголовок, подвал, отдельные шаблоны секций и саму рамку макета. Затем вы можете свободно вставлять, перемещать и многократно использовать отдельные разделы страниц в редакторе.
Примечание: Этот учебник охватывает базовый импорт макета. Дальнейшее редактирование или замена изображений будут рассмотрены в следующем учебнике.
1. Откройте оригинальный шаблон в bx_Import
Откройте в файловом менеджере папку bx_Import. Там импортированный макет изначально находится в оригинальном состоянии – например, с исходными папками изображений и HTML-файлами. В этой области вы работаете только с существующими оригинальными файлами; изменения не сохраняются в оригинальном шаблоне.
Для этого примера откройте файл index.html и перейдите на вкладку Редактировать. Этот файл теперь будет разобран на отдельные составные части макета CMS.
Замена скриншота: файловый менеджер с открытой папкой bx_Import, папками изображений и оригинальными HTML-файлами – dev_bootstrap_import_bx_import_originaldateien.jpeg. Нужно сделать изображение и затем вставить его здесь.
Замена скриншота: index.html из bx_Import в HTML-редакторе – dev_bootstrap_import_index_html_bearbeiten.jpeg. Нужно сделать изображение и затем вставить его здесь.
2. Отделите заголовок от index.html
Искать в HTML-коде с помощью Ctrl + F по запросу header. Во многих шаблонах Bootstrap заголовок можно быстро найти, потому что он помечен соответствующим HTML-элементом. В некоторых шаблонах заголовок состоит только из области div; в этом случае вам нужно будет тщательнее проверить структуру.
Выделите полный заголовок и скопируйте его. Лучше работайте с двумя открытыми окнами, чтобы вы могли переключаться между оригинальным шаблоном и вашим проектом в CMS.
Замена скриншота: область заголовка index.html, найденная по поиску и выделенная для копирования – dev_bootstrap_import_header_markieren.jpeg. Нужно сделать изображение и затем вставить его здесь.
3. Перенесите заголовок в CMS
Вернитесь к вашему проекту, откройте главную директорию и затем Header → 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-код.
Вставьте оставшуюся основную часть оригинального шаблона в конце этого файла. Затем разбейте его на отдельные области, которые позже должны быть доступны по отдельности в редакторе.
Между двумя шаблонами секций вы ставите точно следующий разделитель:
<!--__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-код под LayoutPHP выполняется автоматически при загрузке макета.
Заполнитель для скриншота: База данных 00_layout с LayoutHTML и метками для заголовка, основного и подвала – 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. Очистите содержимое head и используйте HTML заголовка
Проверьте принятый head-раздел и удалите содержимое, которое уже установлено CMS или загружается в другом месте. Также можно удалить установленный заголовок страницы, если он автоматически генерируется системой.
Код заголовка, который требуется редактору и не должен быть непосредственно частью 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. Проверьте пути и возможность редактирования всех секций
Проверьте в конце еще раз Секции → Шаблон секции и проверьте все локальные пути. Для изменения множества одинаковых путей вы можете эффективно использовать текстовый редактор с помощью 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, а также возможность редактирования отдельных секций.
Часто задаваемые вопросы
что часто спрашивают клиенты
Почему оригинальный шаблон 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.
Как я могу сравнить оригинальную страницу при воссоздании?
Открой оригинальный index.html в разделе Файлы → bx_Import через предварительный просмотр и используй его в качестве ссылки для порядка и структуры секций.