Importovať Bootstrap 5 rozloženie
Nauč sa, ako rozložiť Bootstrap-5 šablónu v bx_Import na hlavičku, pätičku, flexibilné sekcie a LayoutHTML a následne ich zložiť v editore bluetronix.
Cieľ tutoriálu
V tomto návode importuješ existujúce Bootstrap-5 rozloženie do bluetronix CMS. Rozdelíš pôvodnú HTML stránku na hlavičku, pätičku, jednotlivé sekčné šablóny a samotný rámec rozloženia. Následne môžeš jednotlivé časti stránky vo editore voľne vkladať, prenášať a opakovane používať.
Poznámka: Tento návod sa zaoberá základným importom rozloženia. Ďalšie úpravy alebo nahradenie obrázkov budú riešené v nasledujúcom návode.
1. Otvor originálnu šablónu v bx_Import
Otvor v správci súborov zložku bx_Import. Tam sa importované rozloženie spočiatku nachádza v originálnom stave – napríklad s pôvodnými priečinkami obrázkov a HTML súbormi. V tejto oblasti pracuješ iba s existujúcimi originálnymi súbormi; zmeny sa neukladajú späť do originálnej šablóny.
Pre tento príklad otvor súbor index.html a prepnúť na Úpravy. Tento súbor sa teraz rozdelí na jednotlivé komponenty rozloženia CMS.
Placeholder pre snímku obrazovky: správca súborov s otvorenou zložkou bx_Import, priečinkami obrázkov a originálnymi HTML súbormi – dev_bootstrap_import_bx_import_originaldateien.jpeg. Obraz ešte zachyti a neskôr ho tu vlož.
Placeholder pre snímku obrazovky: index.html z bx_Import v HTML editore – dev_bootstrap_import_index_html_bearbeiten.jpeg. Obraz ešte zachyti a neskôr ho tu vlož.
2. Oddel hlavičku z index.html
Vyhľadávaj v HTML kóde pomocou Ctrl + F slovo header. V mnohých Bootstrap šablónach sa hlavička rýchlo nájde, pretože je označená príslušným HTML prvkom. V niektorých šablónach sa hlavička skladá len z oblasti div; v takom prípade musíš skontrolovať štruktúru podrobnejšie.
Označ celý oblasť hlavičky a skopíruj ju. Najlepšie pracuj s dvoma otvorenými oknami, aby si mohol prepínať medzi originálnou šablónou a svojím CMS projektom.
Placeholder pre snímku obrazovky: Oblasť hlavičky index.html nájdená cez vyhľadávanie a označená na kopírovanie – dev_bootstrap_import_header_markieren.jpeg. Obraz ešte zachyti a neskôr ho tu vlož.
3. Prenes hlavičku do CMS
Vráť sa späť k svojmu projektu, otvor hlavný priečinok a potom Hlavná hlavička → HTML kód. Vlož tam predtým skopírovaný kód hlavičky.
Následne skontroluj miestne cesty. V mnohých rozloženiach musia byť relatívne odkazy a cesty k obrázkom predchádzané lomítkom, aby správne fungovali v rámci štruktúry CMS.
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
Dôležité: Použi Ctrl + H na vyhľadávanie a nahrádzanie, ale cesty nenahraj bez rozmyslu. Osobitne skontroluj externé URL, kotvy, mailto:-odkazy a už absolútne cesty.
Placeholder pre snímku obrazovky: Hlavný adresár → Hlavička → HTML kód so zadanou hlavičkou – dev_bootstrap_import_header_html_einfuegen.jpeg. Obraz pripraviť a následne na tomto mieste vložiť.
4. Oddel a prenes pätičku
Následne vyhľadaj pätičku v pôvodnej index.html. Vystrihni alebo skopíruj celý oblasť pätičky a vlož ju do predpísanej súboru pätičky v hlavnom adresári tvojho projektu. Skontroluj aj tam všetky miestne href a src cesty.
Placeholder pre snímku obrazovky: Súbor pätičky v hlavnom adresári so zadaným kódom pätičky – dev_bootstrap_import_footer_html_einfuegen.jpeg. Obraz pripraviť a následne na tomto mieste vložiť.
5. Rozdel hlavný obsah na jednotlivé sekčné šablóny
Obsah stránky, ktorý zostane po hlavičke a pätičke, sa nekopíruje priamo do index.html tvojho projektu. Namiesto toho otvorte bx_Layout → SectionTemplate.txt → HTML kód.
Na konci tohto súboru vlož zostávajúcu hlavnú oblasť pôvodnej šablóny. Následne ju rozdel na jednotlivé časti, ktoré budú neskôr k dispozícii v editore.
Medzi dvoma rôznymi sekciami vlož presne nasledujúci oddelovač:
<!--__SP_SectionTemplate__-->
Každá takto oddelená časť môže byť neskôr vložená ako vlastná šablóna v editore. Týmto spôsobom môžeš sekcie voľne usporiadať, viackrát používať alebo na stránke vynechať.
Placeholder pre snímku obrazovky: bx_Layout → SectionTemplate.txt s viacerými sekciami a oddelovačom <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Obraz pripraviť a následne na tomto mieste vložiť.
6. Prenes rámec rozloženia do 00_layout
Po oddelení hlavičky, pätičky a hlavných sekcií zostane vlastný HTML rámec, napríklad s DOCTYPE, oblasťou head a ďalšími nadradenými rozloženiami. Skopíruj tento zostávajúci kód.
Následne otvorte správu databázy a uprav databázu 00_layout. Tam sú už k dispozícii šablóny rozloženia. Môžeš upraviť existujúcu šablónu alebo vytvoriť nové rozloženie.
Vlož skopírovaný rámec pod LayoutHTML. Na pôvodných pozíciách hlavičky, hlavného obsahu a pätičky použiješ značky CMS:
__DB_Layout_Header__
__DB_Layout_Main__
__DB_Layout_Footer__
Pri vykresľovaní stránky budú tieto značky nahradené príslušnou hlavičkou, aktuálnou hlavnou stránkou a pätičkou. Príslušný PHP kód pod LayoutPHP sa pri načítaní rozloženia automaticky vykoná.
Placeholder pre snímku obrazovky: Databáza 00_layout s LayoutHTML a značkami pre hlavičku, hlavnú časť a pätičku – dev_bootstrap_import_00_layout_layouthtml.jpeg. Obraz pripraviť a následne na tomto mieste vložiť.
7. Skontroluj cesty k CSS, JavaScriptu a favikonu
Skontroluj v kóde rozloženia všetky odkazy na CSS, JavaScript a favicon súbory. Pri miestnych cestách pridaj potrebný úvodný lomítko. Pre CSS a JavaScript súbory navyše používaš značku verzie súboru CMS.
JavaScriptový príkaz môže vyzerať takto:
<script src="__FV_/bx_script/core.min.js__"></script>
Označenie __FV_...__ umožňuje systému zohľadniť verziu súboru alebo dátum zmeny pri renderovaní. Týmto spôsobom môže prehliadač načítať aktuálny CSS alebo JavaScript súbor po zmenách, bez toho, aby musel používateľ manuálne aktualizovať cache prehliadača.
8. Vyčisti obsah hlavičky a použi HTML hlavičky
Skontroluj prevzatú oblasť head a odstráň obsahy, ktoré už boli nastavené CMS alebo sú načítané na inom mieste. Taktiež môžeš odstrániť pevne zadaný názov stránky, ak sa tento generuje automaticky zo systému.
Kód hlavičky, ktorý editor potrebuje a nemá byť priamou súčasťou LayoutHTML, ulož pod Extras → Header-HTML. Editor tak môže zohľadniť obsahy uložené tam pri úprave stránky.
Placeholder pre snímku obrazovky: Extras → Header-HTML s presunutým kódom hlavičky – dev_bootstrap_import_extras_header_html.jpeg. Obraz pripraviť a následne na tomto mieste vložiť.
9. Vyber importované rozloženie pre stránku
Ak si vytvoril nové rozloženie v 00_layout, otvorte v editore Nastavenia stránky a vyber si tam svoje importované rozloženie. Iba tak sa dotknutá stránka zobrazí s týmto rámcom rozloženia.
Placeholder pre snímku obrazovky: Nastavenia stránky s výberom novovloženej šablóny – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Obraz pripraviť a následne na tomto mieste vložiť.
10. Zloženie úvodnej stránky z importovaných sekcií
Klikni na tvoju stránku na Upraviť. Úvodná stránka sa môže najprv ukázať prázdna. To je normálne, pretože žiadna z nových častí stránky ešte nebola vložená do skutočnej stránky.
Vyber Vložiť → Časť stránky. Tam by mali byť oblasti, ktoré si predtým oddelil v SectionTemplate.txt pomocou oddelovača sekcií.
Vlož potrebné sekcie postupne a vytvor tak pôvodnú stránku. Následne môžeš časti podľa potreby presúvať, vynechávať alebo viackrát vkladať.
Obrázkový placeholder: Editor → Vložiť → Časť stránky s importovanými šablónami sekcií – dev_bootstrap_import_sections_einfuegen.jpeg. Obrázok ešte zachyť a následne ho na tomto mieste vlož.
11. Použi originálnu stránku ako referenciu
Pod Soubor → bx_Import môžeš stále otvoriť pôvodný index.html ako náhľad. Použi ho ako referenciu, keď zostavuješ svoju novú CMS-stránku z jednotlivých sekcií.
Ak pri jednotlivých šablónach najskôr chýbajú obrázky, ich správne zaradenie bude riešené v nasledujúcom tutoriáli.
12. Skontroluj cesty a upraviteľnosť všetkých sekcií
Na záver ešte raz skontroluj Sections → Section Template a prever všetky lokálne cesty. Pri mnohých podobných cestách môžeš vykonať zmeny efektívne v textovom editore pomocou Ctrl + H.
Potom otestuj každú importovanú sekciu v editore. Skontroluj, či sa všetky obsahujúce údaje správne zobrazujú a či je možné upravovať požadované texty a elementy.
Ak je napríklad text nemožné upraviť, skontroluj jeho HTML štruktúru. Ak sa normálny text nachádza priamo v div kontajneri, môže byť v závislosti od štruktúry rozumné presunúť text do vhodného p elementu.
Obrázkový placeholder: Hotová zostavená úvodná stránka po vložení a usporiadaní sekcií – dev_bootstrap_import_fertige_startseite.jpeg. Obrázok ešte zachyť a následne ho na tomto mieste vlož.
13. Prečo je rozloženie rozdelené
Vďaka rozdeleniu záhlavia, päty, rámca rozloženia a jednotlivých sekcií nemusíš tieto časti znova kopírovať z pôvodného Bootstrap súboru pri nových stránkach.
Centrálne záhlavie a päta môžu byť znovu použité, zatiaľ čo jednotlivé sekčné časti sú k dispozícii ako flexibilné šablóny v editore. Tak môžeš zostaviť rôzne stránky z Bootstrap šablóny a kedykoľvek zmeniť poradie obsahu.
Zhrnutie
Na import Bootstrap-5 používaš originálne súbory pod bx_Import ako šablónu. Záhlavie a päta sú oddelene prenesené do príslušných CMS oblastí, hlavná časť je rozdelená do jednotlivých šablón cez SectionTemplate.txt a zvyšný HTML rámec je uložený pod 00_layout → LayoutHTML.
Následne si vyberieš rozloženie v nastaveniach stránky a zostavíš stránku cez Vložiť → Časť stránky z importovaných sekcií. Nakoniec skontroluj všetky cesty, CSS a JavaScript odkazy, ako aj upraviteľnosť jednotlivých sekcií.
Často kladené otázky
čo sa nás zákazníci často pýtajú
Prečo zostáva pôvodná Bootstrap šablóna pod bx_Import?
Adresár bx_Import slúži ako východiskový bod a referencia pre importovanú originálnu šablónu. Potrebné časti sa prenášajú do príslušných CMS oblastí.
Ktorý súbor použijem na prvý import?
V tomto tutoriáli sa používa index.html ako východiskový bod. Z nej sú oddelené záhlavie, päta, hlavné sekcie a zvyšný rámec rozloženia.
Ako rýchlo nájdem záhlavie a pätu v HTML kóde?
Použi Ctrl + F a hľadaj napríklad po záhlaví alebo päte. Pri šablónach bez príslušných HTML tagov budeš musieť presnejšie preskúmať okolie div štruktúr.
Kde sú uložené jednotlivé sekčné časti?
Šablóny sú uložené pod bx_Layout v SectionTemplate.txt a sú oddelené pomocou oddeľovača <!--__SP_SectionTemplate__-->.
Aké značky potrebuje LayoutHTML?
Na miestach oddelených sekcií používate __DB_Layout_Header__, __DB_Layout_Main__ a __DB_Layout_Footer__.
Prečo sú CSS a JavaScript súbory označené __FV_?
Týmto spôsobom môže CMS pri renderovaní zohľadniť verziu súboru alebo dátum zmeny. Po zmene môže prehliadač načítať aktuálny súbor namiesto zastaranej verzie z cache.
Prečo je úvodná stránka po importe rozloženia najskôr prázdna?
Rozloženie spočiatku poskytuje iba rámec. Skutočné sekčné časti musia byť vložené do stránky cez Vložiť → Časť stránky.
Môžem importovaný sekčný úsek použiť viackrát?
Áno. Oddelené sekčné šablóny môžu byť v editore podľa potreby vložené, presunuté a tiež použité viackrát.
Čo robiť, ak relatívne obrazové alebo odkazové cesty nefungujú?
Skontroluj miestne href a src cesty a podľa potreby doplň vedúci lomítko. Pomocou klávesovej skratky Ctrl + H môžeš nahradiť opakujúce sa cesty, ale nemal by si bez rozmyslu meniť externé URL, kotvy a iné špeciálne cesty.
Čo môžem robiť, ak nie je možné upraviť text v editore?
Skontroluj HTML štruktúru dotknutej sekcie. Ak sa obyčajný text nachádza priamo v div kontejneri, môže byť v závislosti od štruktúry vhodné použiť p prvok.
Ako môžem porovnať pôvodnú stránku pri stavbe?
Otvor pôvodný index.html pod Súbory → bx_Import cez náhľad a použij ho ako referenciu pre poradie a štruktúru sekcií.