Importovat rozvržení Bootstrap 5
Nauč se, jak rozdělit šablonu Bootstrap-5 v bx_Import na hlavičku, patičku, flexibilní sekční šablony a layoutHTML a poté je spojit v editoru bluetronix.
Cíl tutoriálu
V tomto tutorálu importuješ existující Bootstrap-5 layout do bluetronix CMS. Při tom rozebíráš původní HTML stránku na hlavičku, patičku, jednotlivé sekční šablony a samotný layout rámec. Poté můžeš jednotlivé části stránek volně vkládat, přesouvat a opakovaně používat.
poznámka: Tento tutorál se zabývá základním importem layoutu. Další úprava nebo nahrazení obrázků bude probíhat v následujícím tutoriálu.
1. Otevři původní šablonu v bx_Import
Otevři ve správci souborů složku bx_Import. Zde se importovaný layout zpočátku nachází v původním stavu - například s původními složkami obrázků a HTML soubory. V této oblasti pracuješ pouze s existujícími originálními soubory; změny nebudou uloženy zpět do původní šablony.
Pro tento příklad otevři soubor index.html a přepni na Úpravy. Tento soubor bude nyní rozebrán na jednotlivé komponenty layoutu CMS.
Placeholder pro snímek obrazovky: Správce souborů se otevřenou složkou bx_Import, složkami obrázků a originálními HTML soubory – dev_bootstrap_import_bx_import_originaldateien.jpeg. Snímek obrazovky pořiď a poté jej zde vlož.
Placeholder pro snímek obrazovky: index.html z bx_Import v HTML editoru – dev_bootstrap_import_index_html_bearbeiten.jpeg. Snímek obrazovky pořiď a poté jej zde vlož.
2. Odděl hlavičku z index.html
Hledej v HTML kódu pomocí Ctrl + F termín header. U mnoha šablon Bootstrap se tak hlavička rychle najde, protože je označena příslušným HTML elementem. U některých šablon se hlavička skládá pouze z oblasti div; v tomto případě musíš strukturu zkontrolovat podrobněji.
Ozannotuj celý oblast hlavičky a zkopíruj ji. Nejlépe pracuj se dvěma otevřenými okny, abys mohl přepínat mezi původní šablonou a svým projektem CMS.
Placeholder pro snímek obrazovky: Oblast hlavičky index.html nalezena pomocí vyhledávání a označena pro kopírování – dev_bootstrap_import_header_markieren.jpeg. Snímek obrazovky pořiď a poté jej zde vlož.
3. Přenést hlavičku do CMS
Vrať se zpět k projektu, otevři hlavní adresář a poté Header → HTML kód. Vlož tam zkopírovaný hlavičkový kód.
Zkontroluj místní cesty. U mnoha layoutů je třeba relativní odkazy a cesty k obrázkům začít úvodním lomítkem, aby správně fungovaly v rámci struktury CMS.
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
Důležité: Použij Ctrl + H pro hledání a nahrazování, ale nezapomínej kontrolovat cesty. Zvláštní pozornost věnuj externím URL, ukazatelům, mailto:-odkazům a již absolutním cestám.
Placeholder pro screenshot: Hlavní adresář → Hlava → HTML kód se vloženou hlavou – dev_bootstrap_import_header_html_einfuegen.jpeg. Ještě pořiď obrázek a poté jej na tomto místě vlož.
4. Odděl a přenést patičku
Následně vyhledej patičku v původní index.html. Vyjmout nebo zkopírovat celou oblast patičky a vložit ji do příslušného souboru patičky v hlavním adresáři tvého projektu. Zkontroluj také všechny lokální href a src cesty.
Placeholder pro screenshot: Patičkový soubor v hlavním adresáři se vloženým kódem patičky – dev_bootstrap_import_footer_html_einfuegen.jpeg. Ještě pořiď obrázek a poté jej na tomto místě vlož.
5. Rozděl hlavní oblast na jednotlivé sekční šablony
Obsah stránky zbývající po hlavě a patičce nebude přímo zkopírován do index.html tvého projektu. Místo toho otevři bx_Layout → SectionTemplate.txt → HTML kód.
Na konci tohoto souboru vlož zbývající hlavní oblast původní šablony. Poté ji rozděl na jednotlivé části, které by měly být později dostupné samostatně v editoru.
Mezi dvěma šablonami sekcí vlož přesně následující oddělovač:
<!--__SP_SectionTemplate__-->
Každá sekce oddělená tímto oddělovačem může být později vložena jako vlastní šablona v editoru. Díky tomu můžeš sekce svobodně uspořádat, opakovaně používat nebo na stránce vynechat.
Placeholder pro screenshot: bx_Layout → SectionTemplate.txt s několika sekcemi a oddělovačem <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Ještě pořiď obrázek a poté jej na tomto místě vlož.
6. Přenést layout rámec do 00_layout
Po vyjmutí hlavy, patičky a hlavních sekcí zůstává skutečný rámec HTML, například s DOCTYPE, oblastí head a dalšími nadřazenými layoutovými elementy. Zkopíruj tento zbývající kód.
Následně otevři správu databáze a uprav databázi 00_layout. K dispozici jsou již šablony layoutu. Můžeš upravit existující šablonu nebo vytvořit nový layout.
Vlož zkopírovaný rámec pod LayoutHTML. Na původních pozicích hlavy, hlavního obsahu a patičky použij značky CMS:
__DB_Layout_Header__
__DB_Layout_Main__
__DB_Layout_Footer__
Při vykreslování stránky budou tyto značky nahrazeny příslušnou hlavou, aktuální hlavní stránkou a patičkou. Příslušný PHP kód pod LayoutPHP se při načítání layoutu automaticky spustí.
Placeholder pro screenshot: databáze 00_layout s LayoutHTML a značkami pro hlavu, hlavní a patičku – dev_bootstrap_import_00_layout_layouthtml.jpeg. Ještě pořiď obrázek a poté jej na tomto místě vlož.
7. Zkontroluj cesty pro CSS, JavaScript a favicon
Zkontroluj v kódu layoutu všechny odkazy na CSS, JavaScript a soubory favicon. U lokálních cest nastav potřebný úvodní lomítko. Pro CSS a JavaScriptové soubory navíc použij značkování verzí souborů CMS.
JavaScriptový výstup může vypadat například takto:
<script src="__FV_/bx_script/core.min.js__"></script>
Označení __FV_...__ umožňuje systému zohlednit verzi souboru nebo datum změny při vykreslování. Díky tomu může prohlížeč po změnách načíst aktuální CSS nebo JavaScript soubor, aniž by uživatel musel ručně aktualizovat mezipaměť prohlížeče.
8. Uprav obsah hlavičky a použij HTML hlavičky
Zkontroluj převzatou oblast head a odstraň obsah, který již nastavilo CMS nebo je načten jinde. Také můžeš odstranit pevně uvedený název stránky, pokud je generován automaticky systémem.
Kód hlavy, který editor potřebuje a neměl by být přímo součástí LayoutHTML, ulož pod Extras → Header-HTML. Editor tak může při úpravě stránky zohlednit tam uložený obsah.
Placeholder pro screenshot: Extras → Header-HTML se tam přesunutým kódem hlavy – dev_bootstrap_import_extras_header_html.jpeg. Ještě pořiď obrázek a poté jej na tomto místě vlož.
9. Vyber importovaný layout pro stránku
Pokud jsi vytvořil nový layout v 00_layout, otevři v editoru Nastavení stránky a tam vyber svůj importovaný layout. Teprve potom bude dotyčná stránka zobrazena s tímto rámcem layoutu.
Placeholder pro screenshot: Nastavení stránky s výběrem nově importovaného layoutu – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Ještě pořiď obrázek a poté jej na tomto místě vlož.
10. Sestav domovskou stránku z importovaných sekcí
Klikej na tvé stránce na Upravit. Domovská stránka se může zprvu zdát prázdná. To je normální, protože zatím nebyly do skutečné stránky přidány žádné nové sekce.
Vyber Vložit → Sekce stránky. Tam by se měly objevit oblasti, které jsi dříve oddělil v SectionTemplate.txt pomocí oddělovače sekcí.
Vlož potřebné sekce postupně a tím replikuj původní stránku. Poté můžeš sekce libovolně přesouvat, vynechávat nebo víc než jednou vkládat.
Placeholder pro snímek obrazovky: Editor → Vložit → Oddíl stránky s importovanými sekčními šablonami – dev_bootstrap_import_sections_einfuegen.jpeg. Snímek ještě pořiďte a poté jej na tomto místě vložte.
11. Použij původní stránku jako referenci
Pod Soubory → bx_Import můžeš stále otevřít původní index.html jako náhled. Použij ji jako referenci, zatímco sestavuješ svou novou stránku CMS z jednotlivých sekcí.
Pokud u jednotlivých šablon zpočátku chybí obrázky, bude správný převod těchto obrázků řešen v následujícím tutoriálu.
12. Zkontroluj cesty a editovatelnost všech sekcí
Nakonec zkontroluj ještě jednou Sections → Section Template a ověř všechny místní cesty. U mnoha podobných cest můžeš změny efektivně provádět v textovém editoru pomocí Ctrl + H.
Poté otestuj každou importovanou sekci v editoru. Zkontroluj, zda se všechny obsahy správně zobrazují a zda lze upravit zamýšlené texty a prvky.
Pokud například text nelze upravit, zkontroluj jeho HTML strukturu. Leží-li běžný text přímo v div kontejneru, může být v závislosti na struktuře rozumné přesunout text do vhodného p prvku.
Placeholder pro snímek obrazovky: Hotově sestavená úvodní stránka po vložení a uspořádání sekcí – dev_bootstrap_import_fertige_startseite.jpeg. Snímek ještě pořiďte a poté jej na tomto místě vložte.
13. Proč je layout rozdělen
Díky oddělení hlavičky, patičky, layoutového rámce a jednotlivých sekcí nemusíš tyto komponenty u nových stránek neustále z originální Bootstrap souboru kopírovat.
Centrální hlavičku a patičku lze znovu použít, zatímco jednotlivé sekce jsou k dispozici jako flexibilní šablony v editoru. Tak můžeš z Bootstrap šablony sestavit různé stránky a pořadí obsahu kdykoliv měnit.
Shrnutí
Pro import Bootstrap 5 používáš originální soubory v bx_Import jako šablonu. Hlavička a patička se přenesou odděleně do určených oblastí CMS, hlavní část se přes SectionTemplate.txt rozdělí na jednotlivé šablony a zbytek HTML rámce se uloží pod 00_layout → LayoutHTML.
Poté vybereš rozvržení v nastavení stránky a sestavíš stránku pomocí Vložit → Oddíl stránky z importovaných sekcí. Na závěr zkontroluj všechny cesty, CSS a JavaScript odkazy, stejně jako upravitelnost jednotlivých sekcí.
Často kladené otázky
co se nás zákazníci často ptají
Proč zůstává původní Bootstrap šablona v bx_Import?
Složka bx_Import slouží jako výchozí bod a reference pro importovanou originální šablonu. Potřebné komponenty se z ní přenesou do odpovídajících oblastí CMS.
Jaký soubor použiji pro první import?
V tomto tutoriálu je index.html použit jako výchozí bod. Z něj se vytrhnou hlavička, patička, hlavní sekce a zbytek layoutového rámce.
Jak rychle najdu hlavičku a patičku v HTML kódu?
Použij Ctrl + F a hledej například slova header nebo footer. U šablon bez odpovídajících HTML tagů musíš podrobněji zkontrolovat okolní struktury div.
Kde jsou uloženy jednotlivé stránky?
Šablony jsou uloženy v bx_Layout v SectionTemplate.txt a odděleny pomocí oddělovače <!--__SP_SectionTemplate__-->.
Jaké značky potřebuje LayoutHTML?
Na pozicích oddělených oblastí používáš __DB_Layout_Header__, __DB_Layout_Main__ a __DB_Layout_Footer__.
Proč jsou CSS a JavaScript soubory označeny __FV_?
Tímto může CMS při renderování brát v úvahu verzi souboru nebo datum změny. Po změně tak může prohlížeč načíst aktuální soubor místo zastaralé verze z cache.
Proč je úvodní stránka po importu layoutu nejprve prázdná?
Layout nejprve poskytuje pouze rámec. Skutečné stránky je třeba vložit přes Vložit → Oddíl stránky.
Mohu importovanou sekci použít vícekrát?
Ano. Oddělené šablony sekcí mohou být v editoru vkládány, přesouvány a také použity vícekrát.
Co dělat, když relativní cesty k obrázkům nebo odkazům nefungují?
Zkontroluj místní href a src cesty a případně doplň vedoucí lomítko. S Ctrl + H můžeš nahradit opakující se cesty, ale neměl bys bezmyšlenkovitě měnit externí URL, kotvy a jiné speciální cesty.
Co mám dělat, když nelze text v editoru upravit?
Zkontroluj HTML strukturu příslušné sekce. Pokud je běžný text například přímo v div kontejneru, může být na základě struktury vhodným p-element užitečný.
Jak mohu porovnat originální stránku během kopírování?
Otevři původní index.html pod Soubory → bx_Import přes náhled a použij ji jako referenci pro pořadí a strukturu sekcí.