Bootstrap 5 elrendezés importálása
Tudd meg, hogyan lehet egy Bootstrap-5 sablont a bx_Import alatt a fejlécre, láblécre, rugalmas szekció-sablonokra és LayoutHTML-re bontani, majd a bluetronix szerkesztőjében összeszerelni.
A tutoriál célja
Ebben a bemutatóban egy meglévő Bootstrap-5 elrendezést importálsz a bluetronix CMS-be. E közben az alap HTML-oldalt fejlécre, láblécre, egyedi szekció-sablonokra és a tényleges elrendezéskeretre bontod. Ezt követően a különböző oldalszekciókat szabadon beillesztheted, áthelyezheted és többször felhasználhatod a szerkesztőben.
Megjegyzés: Ez a bemutató az alapvető elrendezés-importálását tárgyalja. A képek további módosítása vagy cseréje egy következő bemutatóban lesz bemutatva.
1. Eredeti sablon megnyitása bx_Import alatt.
Nyisd meg a fájlkezelőben a bx_Import mappát. Az importált elrendezés itt eredeti állapotában található – például az eredeti képmappák és HTML fájlokkal. Ebben a területen csak a meglévő eredeti fájlokkal dolgozol; a módosítások nem kerülnek vissza az eredeti sablonba.
Nyisd meg a példához a index.html fájlt, és lépj a Szerkesztés fülre. Ez a fájl most az egyes összetevőkre lesz bontva a CMS-elrendezésben.
Képernyőfelvétel helyőrző: Fájlkezelő bx_Import mappával, képmappákkal és az eredeti HTML fájlokkal – dev_bootstrap_import_bx_import_originaldateien.jpeg. Képet még rögzíts, majd ezen a ponton illeszd be.
Képernyőfelvétel helyőrző: index.html a bx_Importból a HTML-szerkesztőben – dev_bootstrap_import_index_html_bearbeiten.jpeg. Képet még rögzíts, majd ezen a ponton illeszd be.
2. Fejléc elválasztása az index.html-ből.
A HTML-kódban Strg + F billentyűkombinációval keresd meg a header-t. Sok Bootstrap sablonban a fejléc könnyen megtalálható, mivel megfelelő HTML-elemmel van megjelölve. Néhány sablon esetén a fejléc csupán egy div-területből áll; ebben az esetben alaposabban kell ellenőrizned a felépítést.
Jelöld ki a teljes fejlécet és másold ki. A legjobban két nyitott ablakban dolgozhatsz, így váltogathatsz az eredeti sablon és a CMS-projekted között.
Képernyőfelvétel helyőrző: index.html fejléc területe a keresés során találva, másolásra kijelölve – dev_bootstrap_import_header_markieren.jpeg. Képet még rögzíts, majd ezen a ponton illeszd be.
3. Fejléc átvétele a CMS-be.
Térj vissza a projektedhez, nyisd meg a főkönyvtárat, majd a Fejléc → HTML-kód részt. Itt illeszd be a korábban kimásolt fejléc kódot.
Ezután ellenőrizd a helyi útvonalakat. Sok elrendezés esetén a relatív hivatkozásokat és a képkönyvtárakat egy vezető perjellel kell ellátni, hogy helyesen működjenek a CMS-struktúrában.
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
Fontos: Használj Strg + H-t a kereséshez és helyettesítéshez, de ne cseréld ki a hivatkozásokat vakon. Különös figyelmet szentelj a külső URL-eknek, horgoknak, mailto:-linkeknek és az esetleg már létező abszolút hivatkozásoknak.
Képernyőfelvétel helyőrző: Főkönyvtár → Fejléc → HTML-kód a beillesztett fejléc kóddal – dev_bootstrap_import_header_html_einfuegen.jpeg. Képet még rögzíts, majd ezen a ponton illeszd be.
4. Lábléc elválasztása és átvétele.
Ezután keresd meg a láblécet az eredeti index.html-ben. Vágd ki vagy másold ki a teljes láblécet, és illeszd be a főkönyvtáradban a megfelelő lábléc fájlba. Ellenőrizd ott is az összes helyi href és src hivatkozást.
Képernyőfelvétel helyőrző: Lábléc fájl a főkönyvtárban a beillesztett lábléc kóddal – dev_bootstrap_import_footer_html_einfuegen.jpeg. Képet még rögzíts, majd ezen a ponton illeszd be.
5. A fő részt szekció-sablonokra bontani.
A fejléc és lábléc után megmaradó oldal tartalom nem kerül közvetlenül a projekted index.html-jébe. Ehelyett a bx_Layout → SectionTemplate.txt → HTML-kód sort nyisd meg.
Illeszd be az eredeti sablon hátramaradó fő részét ennek a fájlnak a végére. Ezt követően oszd fel az egyes részek közé, amelyeket később külön érhetnek el a szerkesztőben.
Két szekciós sablon között pontosan a következő elválasztót kell elhelyezned:
<!--__SP_SectionTemplate__-->
Minden így elválasztott szakasz később a saját sablonként beilleszthető a szerkesztőbe. Ez lehetővé teszi a szekciók szabad elrendezését, többszöri használatát vagy egy oldalon való kihagyását.
Képernyőfelvétel helyőrző: bx_Layout → SectionTemplate.txt több szekcióval és a <!--__SP_SectionTemplate__--> elválasztóval – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Képet még rögzíts, majd ezen a ponton illeszd be.
6. Elrendezéskeret átírása a 00_layout-ba.
A fejléc, lábléc és fő szekciók kiemelése után maga a HTML-keret marad meg, például a DOCTYPE-tal, a head-résszel és egyéb felsőbbrendű elrendezési elemekkel. Másold ki ezt a megmaradó kódot.
Ezután nyisd meg az adatbázis-kezelőt, és szerkeszd az 00_layout adatbázist. Itt már elérhetők az elrendezés-sablonok. Szerkeszthetsz egy meglévő sablont vagy létrehozhatsz egy új elrendezést.
Illeszd be a kimásolt keretet a LayoutHTML alá. A fejléc, fő tartalom és lábléc eredeti helyein a CMS-jelöléseket használd:
__DB_Layout_Header__
__DB_Layout_Main__
__DB_Layout_Footer__
Az oldal renderelésekor ezeket a jelöléseket a megfelelő fejléc, az aktuális főoldal és a lábléc váltja fel. A hozzá tartozó PHP kód a LayoutPHP-nál automatikusan végrehajtódik az elrendezés betöltésekor.
Képernyőfelvétel helyőrző: 00_layout adatbázis a LayoutHTML-lal és a fejléc, fő és lábléc jelölésekkel – dev_bootstrap_import_00_layout_layouthtml.jpeg. Képet még rögzíts, majd ezen a ponton illeszd be.
7. CSS-, JavaScript- és Favicon-útvonalak ellenőrzése.
Ellenőrizd az elrendezés kódján belül minden CSS-, JavaScript- és Favicon-fájl hivatkozását. A helyi útvonalakhoz add meg a szükséges vezető perjelet. A CSS- és JavaScript-fájlokhoz emellett a CMS fájlverziós jelölését használod.
Egy JavaScript-hívás például így nézhet ki:
<script src="__FV_/bx_script/core.min.js__"></script>
A __FV_...__ jelölés lehetővé teszi a rendszer számára, hogy a fájl verzióját vagy a módosítás dátumát figyelembe vegye a renderelés során. Így a böngésző az új módosítások után betöltheti a legfrissebb CSS vagy JavaScript fájlt anélkül, hogy a felhasználónak manuálisan kellene frissítenie a böngésző gyorsítótárát.
8. Fej tartalmának tisztítása és fejléc HTML használata.
Ellenőrizd a megörökölt head részt, és távolítsd el azokat a tartalmakat, amelyeket már a CMS állított be, vagy más helyen töltöttek be. Egy rögzített oldalcímet is eltávolíthatsz, ha azt a rendszer automatikusan létrehozza.
A fejléc kód, amely a szerkesztő részére szükséges, és nem közvetlenül a LayoutHTML részét képezi, a Extras → Header-HTML alatt tárolható. Így a szerkesztő figyelembe tudja venni a szerkesztés során az ott tárolt tartalmakat.
Képhelyőrző: Extras → Header-HTML a költöztetett fejléc kóddal – dev_bootstrap_import_extras_header_html.jpeg. Képet még fel kell venni, majd ezen a ponton be kell illeszteni.
9. Importált elrendezés kiválasztása az oldalhoz.
Ha új elrendezést hoztál létre a 00_layout alatt, nyisd meg a szerkesztőben az Oldalbeállítások menüpontot, és válaszd ki az importált elrendezésedet. Csak így jelenik meg az érintett oldal ezen az elrendezés keretei között.
Képhelyőrző: Oldalbeállítások az újonnan importált elrendezés kiválasztásával – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Képet még fel kell venni, majd ezen a ponton be kell illeszteni.
10. A kezdőlap összeszerelése az importált szekciókból.
Kattints az oldaladra az Szerkesztés gombra. A kezdőlap kezdetben üresnek tűnhet. Ez normális, mivel még egyetlen új szakasz sem lett beillesztve a tényleges oldalba.
Válaszd az Beszúrás → Oldalszakasz lehetőséget. Itt azok a területek kell, hogy megjelenjenek, amelyeket korábban a SectionTemplate.txt fájlban a Section elválasztóval választottál el.
Illeszd be a szükséges szakaszokat egyesével, hogy visszaállítsd az eredeti oldalt. A szakaszokat később tetszés szerint áthelyezheted, eltávolíthatod vagy többször is beillesztheted.
Képhelyőrző: Szerkesztő → Beszúrás → Oldalszakasz az importált Szakasz-újdonságokkal – dev_bootstrap_import_sections_einfuegen.jpeg. Képet még fel kell venni, majd ezen a ponton be kell illeszteni.
11. Eredeti oldal referenciaként való használata.
A Fájlok → bx_Import alatt a korábbi index.html-t még mindig előnézetként megnyithatod. Használjd referenciaként, miközben új CMS-oldaladat a különálló szakaszokból állítod össze.
Ha egyes sablonoknál eleinte hiányoznak a képek, azok helyes átvételét egy következő oktatóanyagban fogjuk megvitatni.
12. Minden szekció útvonalának és szerkeszthetőségének ellenőrzése.
A végén még egyszer ellenőrizd a Szakaszok → Szakaszminta lehetőséget, és ellenőrizd az összes helyi elérési utat. Sok hasonló elérési út esetén a módosításokat egy szövegszerkesztőben a Ctrl + H kombinációval hatékonyan végezheted el.
Ezután teszteld minden importált szakaszt a szerkesztőben. Ellenőrizd, hogy minden tartalom helyesen jelenik-e meg, és hogy a kívánt szövegek és elemek szerkeszthetők-e.
Ha például egy szöveg nem szerkeszthető, ellenőrizd a HTML-szerkezetét. Ha a normál szöveg közvetlenül egy div tartályban található, a felépítéstől függően érdemes lehet a szöveget egy megfelelő p elembe mozgatni.
Képhelyőrző: Készre összerakott kezdőoldal a szakaszok beillesztése és elrendezése után – dev_bootstrap_import_fertige_startseite.jpeg. Képet még fel kell venni, majd ezen a ponton be kell illeszteni.
13. Miért bontják le az elrendezést?
A fejléc, a lábléc, az elrendezési keretek és az egyes szakaszok megkülönböztetésével nem kell ezeket az elemeket minden új oldalnál megint az eredeti Bootstrap fájlból másolni.
A központi fejléc és lábléc újra felhasználható, míg az egyes oldal szakaszok rugalmas sablonokként állnak rendelkezésre a szerkesztőben. Így különböző oldalakat állíthatsz össze egy Bootstrap sablonból, és bármikor megváltoztathatod a tartalom sorrendjét.
Összefoglalás
A Bootstrap-5 importálásához használd az eredeti fájlokat a bx_Import alatt mint sablont. A fejléc és a lábléc külön kerülnek a megfelelő CMS területekre, a fő terület pedig a SectionTemplate.txt fájlon keresztül kerül szétbontásra további sablonokra, míg a maradék HTML keretet a 00_layout → LayoutHTML alatt tároljuk.
Ezután válaszd ki az elrendezést az oldalbeállításoknál, és állítsd össze az oldalt az importált szakaszokból az Beszúrás → Oldalszakasz lehetőséggel. A végén ellenőrizd az összes elérési utat, CSS- és JavaScript-hivatkozásokat, valamint a különböző szakaszok szerkeszthetőségét.
GYIK
Miket kérdeznek tőlünk gyakran az ügyfelek?
Miért marad meg az eredeti Bootstrap sablon a bx_Import mappában?
A bx_Import mappa kiindulópontként és referenciaként szolgál az importált eredeti sablonhoz. A szükséges elemeket innen másolják a megfelelő CMS területekre.
Melyik fájlt használjam az első importáláshoz?
Ebben az oktatóanyagban az index.html-t használják kiindulópontként. Ebből különítik el a fejlécet, a láblécet, a fő szakaszokat és a fennmaradó elrendezési keretet.
Hogyan találom meg gyorsan a fejlécet és a láblécet a HTML-kódban?
Használj Ctrl + F-et, és keress például fejléc vagy lábléc után. Ha a sablonok nem tartalmaznak megfelelő HTML-címkéket, akkor a környező div-szerkezetet alaposabban kell átnézni.
Hol vannak tárolva az egyes oldalrészletek?
A sablonok a bx_Layout alatt találhatók a SectionTemplate.txt fájlban, és a
Milyen márkákra van szüksége a LayoutHTML-nek?
A kiemelt területek helyén használod az __DB_Layout_Header__, __DB_Layout_Main__ és __DB_Layout_Footer__-t.
Miért jelölik a CSS és JavaScript fájlokat __FV_-vel?
Ez lehetővé teszi a CMS számára, hogy a renderelés során figyelembe vegye a fájlverziót vagy a módosítás dátumát. Módosítás után így a böngésző a legfrissebb fájlt tölti le, ahelyett, hogy egy elavult cache-verziót használná.
Miért üres a kezdőlap a layout importálása után először?
A layout kezdetben csak a keretet biztosítja. A tényleges oldalrészleteket a Beszúrás → Oldalrészlet menüpont segítségével kell a lapra beilleszteni.
Többször is felhasználhatom az importált oldalrészletet?
Igen. A különálló szekciós sablonokat az editorban szükség szerint beillesztheted, áthelyezheted és többször is felhasználhatod.
Mit tegyek, ha a relatív kép- vagy linkútvonalak nem működnek?
Ellenőrizd a helyi href- és src-útvonalakat, és ha szükséges, egészítsd ki egy vezető perjellel. A Ctrl + H segítségével cserélheted le a visszatérő útvonalakat, de az külső URL-eket, horgonyokat és egyéb különleges útvonalakat ne módosítsd vakon.
Mit tehetek, ha egy szöveget az editorban nem tudok szerkeszteni?
Ellenőrizd a szóban forgó szekció HTML-struktúráját. Ha a szöveg például közvetlenül egy div-konténerben található, a felépítéstől függően egy megfelelő p-element hasznos lehet.
Hogyan hasonlíthatom össze az eredeti oldalt az újraépítés során?
Nyisd meg az eredeti index.html fájlt a Fájlok → bx_Import menüpont alatt az előnézeten, és használd referenciaként a részletek sorrendjéhez és felépítéséhez.