Importera Bootstrap 5-layout
Lär dig hur du dissekerar en Bootstrap 5-mall under bx_Import i Header, Footer, flexibla sektionmallar och LayoutHTML och sedan bygger ihop det i bluetronix-redigeraren.
Målet med guiden
I denna handledning importerar du en befintlig Bootstrap-5-layout till bluetronix CMS. Du delar upp den ursprungliga HTML-sidan i header, footer, separata sektionmallar och den faktiska layoutramen. Sedan kan du fritt infoga, flytta och använda om de olika sidodelarna i redigeringsverktyget.
Observera: Denna handledning handlar om grundläggande layoutimport. Vidare redigering eller ersättning av bilder behandlas i en följande handledning.
1. Öppna originalmallen i bx_Import
Öppna mappen bx_Import i filhanteraren. Där finns den importerade layouten i sitt ursprungliga skick – till exempel med de ursprungliga bildmapparna och HTML-filer. I detta område arbetar du endast med de befintliga originalfilerna; ändringar kommer inte att sparas tillbaka till originalmallen.
Öppna för detta exempel filen index.html och gå till Redigera. Denna fil kommer nu att delas upp i de enskilda delarna av CMS-layouten.
Skärmdumpsplatshållare: Filhanterare med öppnad mapp bx_Import, bildmappar och de ursprungliga HTML-filerna – dev_bootstrap_import_bx_import_originaldateien.jpeg. Ta gärna nästa bild och inkludera den här senare.
Skärmdumpsplatshållare: index.html från bx_Import i HTML-redigeraren – dev_bootstrap_import_index_html_bearbeiten.jpeg. Ta gärna nästa bild och inkludera den här senare.
2. Separera header från index.html
Sök i HTML-koden med Ctrl + F efter header. I många Bootstrap-mallar kan du snabbt hitta headern eftersom den är markerad med ett motsvarande HTML-element. I vissa mallar består headern endast av ett div-område; i sådana fall måste du kontrollera strukturen noggrant.
Markera hela headerområdet och kopiera det. Arbeta helst med två öppna fönster så att du kan växla mellan originalmallen och ditt CMS-projekt.
Skärmdumpsplatshållare: Headerområdet av index.html som hittades genom sökningen och markerades för kopiering – dev_bootstrap_import_header_markieren.jpeg. Ta gärna nästa bild och inkludera den här senare.
3. Överför header till CMS
Gå tillbaka till ditt projekt, öppna huvudmappen och sedan Header → HTML-kod. Klistra in den tidigare kopierade headerkoden där.
Kontrollera sedan de lokala sökvägarna. I många layouter måste relativa referenser och bildsökvägar ha en inledande snedstreck för att fungera korrekt inom CMS-strukturen.
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
Viktigt: Använd Ctrl + H för sök och ersätt, men ersätt inte sökvägar blint. Kontrollera särskilt externa URL:er, ankare, mailto:-länkar och redan absoluta sökvägar.
Skärmdump-platsinnehavare: Huvudkatalog → Header → HTML-kod med inbäddad header – dev_bootstrap_import_header_html_einfuegen.jpeg. Ta gärna en bild och länka in den här.
4. Separera footer och överför den
Sök därefter efter footern i den ursprungliga index.html. Klipp eller kopiera hela footer-sektionen och klistra in den i den avsedda footer-filen i projektets huvudkatalog. Kontrollera även alla lokala href- och src-vägar där.
Skärmdump-platsinnehavare: Footer-fil i huvudkatalogen med inbäddad footer-kod – dev_bootstrap_import_footer_html_einfuegen.jpeg. Ta gärna en bild och länka in den här.
5. Dela in main-området i separata sektionmallar
Innehållet som återstår efter headern och footern kopieras inte direkt in i index.html för ditt projekt. Öppna istället bx_Layout → SectionTemplate.txt → HTML-kod.
Klistra in den återstående huvudsektionen av originalmallen i slutet av denna fil. Dela sedan upp den i de olika sektioner som senare ska finnas tillgängliga separat i redigeraren.
Mellan två sektion-mallar sätter du exakt följande avskiljare:
<!--__SP_SectionTemplate__-->
Varje avskild sektion kan senare infogas som en egen mall i redigeraren. Detta gör att du kan ordna sektioner fritt, använda dem flera gånger eller utelämna dem på en sida.
Skärmdump-platsinnehavare: bx_Layout → SectionTemplate.txt med flera sektioner och avskiljaren <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Ta gärna en bild och länka in den här.
6. Överför layoutramen till 00_layout
Efter att ha separerat header, footer och huvudsektioner återstår den faktiska HTML-ramen, till exempel med DOCTYPE, head-området och andra övergripande layout-element. Kopiera denna kvarvarande kod.
Öppna därefter databasadministrationen och redigera databasen 00_layout. Där finns redan layout-mallar tillgängliga. Du kan redigera en befintlig mall eller skapa en ny layout.
Klistra in den kopierade ramen under LayoutHTML. På de ursprungliga positionerna för header, huvud innehåll och footer använder du CMS-märken:
__DB_Layout_Header__
__DB_Layout_Main__
__DB_Layout_Footer__
Vid rendering av sidan ersätts dessa märken med respektive header, nuvarande huvudsida och footer. Den tillhörande PHP-koden under LayoutPHP körs automatiskt vid inläsning av layouten.
Skärmdump-platsinnehavare: Databas 00_layout med LayoutHTML och märkena för header, main och footer – dev_bootstrap_import_00_layout_layouthtml.jpeg. Ta gärna en bild och länka in den här.
7. Kontrollera CSS-, JavaScript- och Favicon-sökvägar
Kontrollera inom layout-koden alla hänvisningar till CSS-, JavaScript- och Favicon-filer. Sätt det nödvändiga ledande snedstrecket för lokala vägar. För CSS- och JavaScript-filer använder du dessutom filversionsmarkeringen från CMS.
En JavaScript-anrop kan se ut så här:
<script src="__FV_/bx_script/core.min.js__"></script>
Märkningen __FV_...__ gör det möjligt för systemet att ta hänsyn till filversionen respektive ändringsdatumet vid rendering. Detta gör att webbläsaren kan ladda den aktuella CSS- eller JavaScript-filen efter ändringar utan att användaren behöver uppdatera webbläsarens cache manuellt.
8. Rensa head-innehåll och använd header-HTML
Kontrollera den överförda head-sektionen och ta bort innehåll som redan har ställts in av CMS eller laddas på annat håll. Ett fastställt sidtitel kan också tas bort om denna genereras automatiskt av systemet.
Header-kod som behövs av redigeraren och som inte ska vara en direkt del av LayoutHTML sparar du under Extras → Header-HTML. Redigeraren kan därigenom ta hänsyn till det innehåll som lagts in där vid redigering av sidan.
Skärmdump-platsinnehavare: Extras → Header-HTML med den flyttade header-koden – dev_bootstrap_import_extras_header_html.jpeg. Ta gärna en bild och länka in den här.
9. Välj den importerade layouten för sidan
Om du har skapat en ny layout i 00_layout, öppna i redigeraren Sidinställningar och välj din importerade layout där. Endast då visas den aktuella sidan med denna layout-ram.
Skärmdump-platsinnehavare: Sidinställningar med val av den nyligen importerade layouten – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Ta gärna en bild och länka in den här.
10. Sätt ihop startsidan av de importerade sektionerna
Klicka på Redigera för din sida. Startsidan kan först verka tom. Det är normalt, eftersom inget av de nya sidavsnitten har lagts till på den faktiska sidan än.
Välj Infoga → Sidavsnitt. Där bör områdena som du tidigare separerat med sektion-avskiljaren i SectionTemplate.txt visas.
Infoga de nödvändiga sektionerna en i taget och återskapa därmed den ursprungliga sidan. Du kan sedan flytta, utelämna eller infoga avsnitten hur som helst.
Skärmdump-platsinnehavare: Redigerare → Infoga → Sidavsnitt med de importerade sektion-mallarna – dev_bootstrap_import_sections_einfuegen.jpeg. Ta gärna en bild och länka in den här.
11. Använd originalsidans mall som referens
Under Filer → bx_Import kan du fortfarande öppna den ursprungliga index.html som en förhandsvisning. Använd den som referens medan du sätter ihop din nya CMS-sida från de olika sektionerna.
Om vissa mallar saknar bilder i början behandlas deras korrekta överföring i en följande handledning.
12. Kontrollera sökvägar och redigerbarhet för alla sektioner
Kontrollera till sist Sektioner → Sektionmall och kontrollera alla lokala vägar. För många lika vägar kan du göra ändringarna effektivt i en textredigerare med Ctrl + H.
Testa sedan varje importerad sektion i redigeraren. Kontrollera att allt innehåll visas korrekt och att de avsedda texterna och elementen kan redigeras.
Om en text till exempel inte går att redigera, kontrollera dess HTML-struktur. Om en vanlig text ligger direkt i en div-behållare kan det beroende på strukturen vara meningsfullt att flytta texten till ett lämpligt p-element.
Screenshots-placeholder: Färdig sammansatt startsida efter att ha infogat och ordnat sektionerna – dev_bootstrap_import_färdig_startsida.jpeg. Ta bilden och infoga den här.
13. Varför layouten delas upp
Genom att separera header, footer, layoutramar och individuella sektioner behöver du inte alltid kopiera dessa komponenter från den ursprungliga Bootstrap-filen för nya sidor.
Den centrala headern och footern kan återanvändas, medan de individuella sidavsnitten finns tillgängliga som flexibla mallar i redigeraren. Så kan du sätta ihop olika sidor från en Bootstrap-mall och ändra ordningen på innehållet när som helst.
Sammanfattning
För Bootstrap-5-importen använder du originalfilerna under bx_Import som mall. Headern och footern överförs separat till de avsedda CMS-områdena, huvudområdet delas upp i individuella mallar via SectionTemplate.txt och den resterande HTML-ramen lagras under 00_layout → LayoutHTML.
Välj sedan layouten i sidinställningarna och sätt ihop sidan via Infoga → Sidsektion från de importerade sektionerna. Kontrollera till sist alla vägar, CSS- och JavaScript-referenser samt redigerbarheten för de enskilda sektionerna.
FAQ
vad kunder ofta frågar oss
Varför sparas den ursprungliga Bootstrap-mallen under bx_Import?
Mappen bx_Import fungerar som en utgångspunkt och referens för den importerade originalmallen. De nödvändiga komponenterna överförs därifrån till respektive CMS-områden.
Vilken fil använder jag för den första importen?
I den här handledningen används index.html som utgångspunkt. Därifrån separeras header, footer, huvudsektioner och den kvarvarande layoutramen.
Hur hittar jag snabbt header och footer i HTML-koden?
Använd Ctrl + F och sök till exempel efter header eller footer. I mallar utan motsvarande HTML-taggar måste du noga kontrollera de omgivande div-strukturerna.
Var lagras de enskilda sidavsnitten?
Mallarna lagras under bx_Layout i SectionTemplate.txt och separeras med avgränsaren <!--__SP_SectionTemplate__-->.
Vilka etiketter behövs för LayoutHTML?
Vid positionerna för de särskilda sektionerna använder du __DB_Layout_Header__, __DB_Layout_Main__ och __DB_Layout_Footer__.
Varför märks CSS- och JavaScript-filer med __FV_?
Detta gör att CMS:et kan ta hänsyn till filversionen eller ändringsdatumet vid rendering. Efter en ändring kan webbläsaren sålunda ladda den aktuella filen istället för en gammal cache-version.
Varför är startsidan tom efter layoutimporten?
Layouten ger först och främst bara ramen. De faktiska sidavsnitten måste infogas på sidan via Infoga → Sidsektion.
Kan jag använda en importerad sidsektion flera gånger?
Ja. De separata sektionmallarna kan infogas, flyttas och även användas flera gånger i redigeraren.
Vad gör jag om relativa bild- eller länkvägar inte fungerar?
Kontrollera lokala href- och src-vägar och lägg till en ledande snedstreck om det behövs. Med Ctrl + H kan du ersätta återkommande vägar, men du bör inte ändra externa URL:er, ankar- och andra specialvägar utan eftertanke.
Vad kan jag göra om en text inte kan redigeras i redigeraren?
Kontrollera HTML-strukturen för den aktuella sektionen. Om vanlig text till exempel ligger direkt i en div-container kan ett lämpligt p-element vara användbart beroende på strukturen.
Hur kan jag jämföra den ursprungliga sidan när jag bygger om?
Öppna den ursprungliga index.html under Filer → bx_Import via förhandsgranskningen och använd den som referens för ordning och konstruktion av sektionerna.