Importere Bootstrap 5 layout
Lær hvordan du deler opp en Bootstrap-5-mal under bx_Import i header, footer, fleksible seksjonsmaler og layout-HTML, for så å montere dem i bluetronix-editoren.
Målet med veiledningen
I denne veiledningen importerer du et eksisterende Bootstrap-5-layout til bluetronix CMS. Du deler original HTML-siden opp i header, footer, separate seksjonsmaler og selve layout-rammen. Deretter kan du fritt sette inn, flytte og bruke de enkelte sideseksjonene i editoren.
Merk: Denne veiledningen handler om grunnleggende layout-import. Videre redigering eller erstatning av bilder vil bli behandlet i en senere veiledning.
1. Åpne originalmalen under bx_Import
Åpne mappen bx_Import i filbehandleren. Det importerte layoutet finnes først i originaltilstanden – for eksempel med de originale bildefolderne og HTML-filene. I dette området jobber du kun med de eksisterende originalfilene; endringer blir ikke tilbakeført til originalmalen.
Åpne filen index.html for dette eksemplet og gå til Rediger. Denne filen vil nå bli delt opp i de enkelte komponentene av CMS-layoutet.
Skjermbilde-plassholder: Filbehandler med åpnet mappe bx_Import, bildefolder og de originale HTML-filene – dev_bootstrap_import_bx_import_originaldateien.jpeg. Ta bildet og legg det deretter til her.
Skjermbilde-plassholder: index.html fra bx_Import i HTML-editoren – dev_bootstrap_import_index_html_bearbeiten.jpeg. Ta bildet og legg det deretter til her.
2. Skille ut headeren fra index.html
Søk i HTML-koden med Ctrl + F etter header. I mange Bootstrap-maler finner du headeren raskt fordi den er merket med et tilsvarende HTML-element. I noen maler består headeren kun av et div-område; i dette tilfellet må du sjekke oppbyggingen nærmere.
Merk hele headerområdet og kopier det. Det er best å jobbe med to åpne vinduer, slik at du kan bytte mellom originalmalen og CMS-prosjektet ditt.
Skjermbilde-plassholder: Header-området av index.html funnet via søk og merket for kopiering – dev_bootstrap_import_header_markieren.jpeg. Ta bildet og legg det deretter til her.
3. Overføre header til CMS
Gå tilbake til prosjektet ditt, åpne hovedkatalogen og deretter Header → HTML-kode. Lim inn den tidligere kopierte header-koden der.
Sjekk deretter de lokale stiene. I mange layout må relative henvisninger og bildeveier begynne med en skråstrek for at de skal fungere korrekt innenfor CMS-strukturen.
href="css/style.css" → href="/css/style.css"
src="images/logo.jpg" → src="/images/logo.jpg"
Viktig: Bruk Ctrl + H for å søke og erstatte, men erstatt ikke stier blindt. Sjekk spesielt eksterne URL-er, anker, mailto:-lenker og allerede absolutte stier.
Skjermbildeplassholder: Hovedmappe → Header → HTML-kode med innlagt header – dev_bootstrap_import_header_html_einfuegen.jpeg. Ta opp bildet og bind det deretter inn her.
4. Skille ut og overføre footer
Søk deretter etter footeren i den opprinnelige index.html. Klipp eller kopier den komplette footer-seksjonen og lim den inn i den tilsvarende footer-filen i hovedmappen til prosjektet ditt. Sjekk også der alle lokale href- og src-stier.
Skjermbildeplassholder: Footer-fil i hovedmappen med innlagt footer-kode – dev_bootstrap_import_footer_html_einfuegen.jpeg. Ta opp bildet og bind det deretter inn her.
5. Dele opp hovedområdet i separate seksjonsmaler
Innholdet på siden som gjenstår etter header og footer blir ikke kopiert direkte inn i index.html i prosjektet ditt. I stedet åpner du bx_Layout → SectionTemplate.txt → HTML-kode.
Lim inn den gjenværende main-seksjonen fra den originale malen på slutten av denne filen. Del den deretter opp i de enkelte seksjonene som senere skal være tilgjengelige separat i editoren.
Mellom to seksjonsmaler setter du akkurat følgende skille:
<!--__SP_SectionTemplate__-->
Hver seksjon som er delt på denne måten kan senere settes inn som egen mal i editoren. Dette gir deg frihet til å arrangere seksjoner, bruke dem flere ganger eller utelate dem på en side.
Skjermbildeplassholder: bx_Layout → SectionTemplate.txt med flere seksjoner og skilletegnet <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Ta opp bildet og bind det deretter inn her.
6. Overføre layout-rammen til 00_layout
Etter å ha skåret ut header, footer og main-seksjoner gjenstår selve HTML-rammen, for eksempel med DOCTYPE, head-seksjonen og andre overordnede layout-elementer. Kopier denne gjenværende koden.
Åpne deretter databaseadministrasjonen og rediger databasen 00_layout. Her er det allerede tilgjengelige layout-maler. Du kan redigere en eksisterende mal eller opprette et nytt layout.
Lim inn den kopierte rammen under LayoutHTML. På de opprinnelige posisjonene for header, hovedinnhold og footer bruker du CMS-merkene:
__DB_Layout_Header__
__DB_Layout_Main__
__DB_Layout_Footer__
Ved gjengivelse av siden blir disse merkene erstattet av den respektive headeren, den aktuelle hovedsiden og footeren. Den tilhørende PHP-koden under LayoutPHP kjøres automatisk når layoutet lastes.
Skjermbildeplassholder: Database 00_layout med LayoutHTML og merkene for header, main og footer – dev_bootstrap_import_00_layout_layouthtml.jpeg. Ta opp bildet og bind det deretter inn her.
7. Sjekke CSS-, JavaScript- og favicon-stier
Sjekk alle referanser til CSS-, JavaScript- og favicon-filer i layout-koden. Sett inn nødvendig førende skråstrek for lokale stier. For CSS- og JavaScript-filer bruker du i tillegg filversjonsmarkeringen fra CMS.
Et JavaScript-anrop kan for eksempel se slik ut:
<script src="__FV_/bx_script/core.min.js__"></script>
Merkingen __FV_...__ gjør det mulig for systemet å ta hensyn til filversjonen eller endringsdatoen ved rendering. Dermed kan nettleseren laste den aktuelle CSS- eller JavaScript-filen etter endringer, uten at brukeren må oppdatere nettleserens cache manuelt.
8. Rense head-innholdet og bruke header-HTML
Sjekk den overtagne head-seksjonen og fjern innhold som allerede settes av CMS eller lastes inn et annet sted. Også en fastsatt sidetittel kan fjernes hvis denne genereres automatisk av systemet.
Header-kode som editoren trenger, og som ikke skal være en del av LayoutHTML, lagrer du under Ekstra → Header-HTML. Editor kan dermed ta hensyn til innholdet som er lagret der når siden redigeres.
Skjermbildeplassholder: Ekstra → Header-HTML med header-koden som ble flyttet dit – dev_bootstrap_import_extras_header_html.jpeg. Ta opp bildet og bind det deretter inn her.
9. Velge importert layout for siden
Hvis du har opprettet et nytt layout i 00_layout, åpner du i editoren Sideinnstillinger og velger der ditt importerte layout. Først da blir den aktuelle siden vist med denne layout-rammen.
Skjermbildeplassholder: Sideinnstillinger med valg av det nyimporterte layoutet – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Ta opp bildet og bind det deretter inn her.
10. Sammenstille startsiden fra de importerte seksjonene
Klikk på siden din på Rediger. Hjemmesiden kan først se tom ut. Dette er normalt, fordi ingen av de nye seksjonene har blitt innført i den faktiske siden.
Velg Sett inn → Sideavsnitt. Der skal områdene vises som du tidligere har skilt med seksjonskilleren i SectionTemplate.txt.
Sett inn de nødvendige seksjonene en etter en, og gjenskap den opprinnelige siden. Du kan deretter flytte, utelate eller sette inn seksjonene flere ganger.
Skjermbilde-plassholder: Redigerer → Sett inn → Sideavsnitt med de importerte seksjonsmalene – dev_bootstrap_import_sections_einfuegen.jpeg. Ta opp bildet og bind det deretter inn her.
11. Bruke original siden som referanse
Under Filer → bx_Import kan du fortsatt åpne den originale index.html som forhåndsvisning. Bruk den som referanse mens du setter sammen den nye CMS-siden fra de enkelte seksjonene.
Hvis det mangler bilder i enkelte maler, vil korrekt overføring bli behandlet i en senere tutorial.
12. Sjekke stier og redigerbarhet av alle seksjoner
Sjekk til slutt Seksjoner → Seksjonsmal og kontroller alle lokale stier. For mange like stier kan du effektivt gjøre endringene i en tekstredigerer med Ctrl + H.
Test deretter hver importert seksjon i redigereren. Sjekk om alle innhold vises korrekt og om de angitte tekstene og elementene kan redigeres.
Hvis en tekst for eksempel ikke kan redigeres, sjekk HTML-strukturen. Hvis normal tekst ligger direkte i en div-container, kan det avhengig av oppsettet være fornuftig å flytte teksten inn i et passende p-element.
Skjermbilde-plassholder: Ferdig sammensatt startside etter innsetting og organisering av seksjonene – dev_bootstrap_import_fertige_startseite.jpeg. Ta opp bildet og bind det deretter inn her.
13. Hvorfor layoutet deles opp
Ved å skille header, footer, layout-ramme og enkelte seksjoner trenger du ikke alltid å kopiere disse delene fra den opprinnelige Bootstrap-filen til nye sider.
Den sentrale headeren og footer kan gjenbrukes, mens de enkelte sideavsnittene er tilgjengelige som fleksible maler i redigereren. Slik kan du sette sammen ulike sider fra en Bootstrap-mal og endre rekkefølgen på innholdet når som helst.
Sammendrag
For Bootstrap-5-import bruker du originalfilene under bx_Import som mal. Header og footer overføres separat til de angitte CMS-områdene, hovedområdet deles opp i individuelle maler via SectionTemplate.txt, og den gjenværende HTML-rammen lagres under 00_layout → LayoutHTML.
Deretter velger du layoutet i sideinnstillingene og setter sammen siden via Sett inn → Sideavsnitt fra de importerte seksjonene. Sjekk til slutt alle stier, CSS- og JavaScript-referanser samt redigerbarheten til de enkelte seksjonene.
FAQ
hva kunder ofte spør oss om
Hvorfor forblir den opprinnelige Bootstrap-malen under bx_Import?
Mappen bx_Import fungerer som utgangspunkt og referanse for den importerte originalmalen. De nødvendige komponentene overføres derfra til de respektive CMS-områdene.
Hvilken fil bruker jeg for den første importen?
I denne tutorialen brukes index.html som utgangspunkt. Fra denne skilles header, footer, hovedseksjoner og den gjenværende layout-rammen.
Hvordan finner jeg raskt header og footer i HTML-koden?
Bruk Ctrl + F og søk for eksempel etter header eller footer. Ved maler uten tilsvarende HTML-tagger må du se nærmere på de omliggende div-strukturene.
Hvor blir de enkelte sideavsnittene lagret?
Malene lagres under bx_Layout i SectionTemplate.txt og er skilt fra hverandre med gruppeskiller <!--__SP_SectionTemplate__-->.
Hvilke merker trenger LayoutHTML?
På posisjonene til de utlagte områdene bruker du __DB_Layout_Header__, __DB_Layout_Main__ og __DB_Layout_Footer__.
Hvorfor er CSS- og JavaScript-filer merket med __FV_?
Dette gjør at CMS kan ta hensyn til filversjonen eller endringsdatoen ved rendering. Etter en endring kan nettleseren laste den aktuelle filen i stedet for en utdatert cache-versjon.
Hvorfor er startsiden først tom etter layout-impot?
Layoutet gir først bare rammen. De faktiske sideavsnittene må settes inn via Sett inn → Sideavsnitt.
Kan jeg bruke en importert seksjonsdel flere ganger?
Ja. De separate seksjonsmalene kan settes inn, flyttes og brukes flere ganger i redigeringsverktøyet etter behov.
Hva gjør jeg hvis relative bilde- eller lenkeveier ikke fungerer?
Sjekk lokale href- og src-stier, og legg til et ledende skråstrek om nødvendig. Med Ctrl + H kan du erstatte gjentatte stier, men du bør ikke blindt endre eksterne URL-er, anker og andre spesielle stier.
Hva kan jeg gjøre hvis en tekst ikke kan redigeres i redigeringsverktøyet?
Sjekk HTML-strukturen til den aktuelle seksjonen. Hvis vanlig tekst for eksempel ligger direkte i en div-container, kan det være hensiktsmessig med et passende p-element avhengig av oppsettet.
Hvordan kan jeg sammenligne originalsiden når jeg gjenbygger?
Åpne den originale index.html under Filer → bx_Import via forhåndsvisning og bruk den som referanse for rekkefølge og oppsett av seksjonene.