Lataa sovellus nyt ja kokeile 10 päivää ilmaiseksi
Valuutta Valitse kieli Valitse alue

Oppaan tavoite

Tässä oppaassa tuodaan olemassa oleva Bootstrap-5-asettelu bluetronix CMS:ään. Työskentelet alkuperäisen HTML-sivun pilkkomisen parissa, johon kuuluu otsikko, alatunniste, yksittäiset osiomallit ja itse asettelu. Tämän jälkeen voit vapaasti lisätä, siirtää ja käyttää useaan kertaan yksittäisiä sivuosia editorissa.

Huomio: Tämä opas käsittelee perusasetelmaa tuomista. Kuvien lisäys tai vaihto käsitellään seuraavassa oppaassa.

1. Avaa alkuperäinen pohja bx_Importissa

Avaa tiedostohallinnassa kansio bx_Import. Tuotu asettelu löytyy aluksi alkuperäisessä kunnossa – esimerkiksi alkuperäisten kuvatiedostojen ja HTML-tiedostojen kanssa. Tässä alueella työskentelet vain olemassa olevilla alkuperäistiedostoilla; muutoksia ei tallenneta takaisin alkuperäiseen malliin.

Avaa tätä esimerkkiä varten tiedosto index.html ja siirry kohtaan Muokkaa. Tämä tiedosto pilkotaan nyt CMS-asettelun yksittäisiin osiin.

Ruudunkaappauspaikka: Tiedostohallinta avattuna kansiossa bx_Import, kuvatiedostoissa ja alkuperäisissä HTML-tiedostoissa – dev_bootstrap_import_bx_import_originaldateien.jpeg. Ota kuva ja liitä se sitten tänne.

Ruudunkaappauspaikka: index.html bx_Importissa HTML-editorissa – dev_bootstrap_import_index_html_bearbeiten.jpeg. Ota kuva ja liitä se sitten tänne.

2. Erota Header index.html:stä

Etsi HTML-koodista Strg + F avulla header. Monet Bootstrap-mallit voidaan löytää otsikolla nopeasti, koska se on merkitty vastaavalla HTML-elementillä. Joissakin malleissa otsikko koostuu vain yhdestä div-alueesta; tällöin sinun on tarkasteltava rakennetta tarkemmin.

Korosta koko otsikkoalue ja kopioi se. Työskentele mieluiten kahdessa avoimessa ikkunassa, jotta voit vaihtaa alkuperäisen mallin ja CMS-projektisi välillä.

Ruudunkaappauspaikka: index.html:n otsikkoalue haettu haun avulla ja merkitty kopioitavaksi – dev_bootstrap_import_header_markieren.jpeg. Ota kuva ja liitä se sitten tänne.

3. Siirrä Header CMS:ään

Palaa projektiisi, avaa pääkansio ja sen jälkeen Otsikko → HTML-koodi. Liitä aiemmin kopioitu otsikkokoodi sinne.

Tarkista sen jälkeen paikalliset polut. Monilla asetteluilla suhteelliset viittaukset ja kuvapolut on varustettava etuviivalla, jotta ne toimivat oikein CMS-rakenteessa.

href="css/style.css"   →   href="/css/style.css"
src="images/logo.jpg"  →   src="/images/logo.jpg"

Tärkeää: Käytä Strg + H etsiäksesi ja vaihtaaksesi, mutta älä vaihda polkuja sokkona. Tarkista erityisesti ulkoiset URL-osoitteet, ankkurit, mailto-linkit ja jo olemassa olevat absoluuttiset polut.

Ruudunkaappauspaikka: Pääkansio → Otsikko → HTML-koodi, johon on liitetty otsikko – dev_bootstrap_import_header_html_einfuegen.jpeg. Ota kuva ja liitä se sitten tänne.

Etsi seuraavaksi alatunniste alkuperäisestä index.html:sta. Leikkaa tai kopioi koko alatunnistealue ja liitä se viitattuun alatunnistetiedostoon projektiisi pääkansiossa. Tarkista myös paikalliset href- ja src-polut.

Ruudunkaappauspaikka: Alatunnistetiedosto pääkansiossa, jossa on liitetty alatunnistekoodi – dev_bootstrap_import_footer_html_einfuegen.jpeg. Ota kuva ja liitä se sitten tänne.

5. Jaa pääalue erillisiin osamalleihin

Otsikon ja alatunnisteen jälkeinen sivun sisältö ei kopioidu suoraan projektiisi index.html:ään. Avaa sen sijaan bx_Layout → SectionTemplate.txt → HTML-koodi.

Liitä jäljellä oleva pääosuus alkuperäisestä mallista tämän tiedoston loppuun. Pilko se sitten erillisiksi osiksi, jotka ovat myöhemmin saatavilla editorissa erikseen.

Kahden osiomallin väliin laita tarkka seuraava erotin:

<!--__SP_SectionTemplate__-->

Jokainen siten erotettu osa voidaan myöhemmin liittää editorissa omana mallinaan. Tämän avulla voit järjestää osioita vapaasti, käyttää niitä useaan kertaan tai jättää ne pois yhdeltä sivulta.

Ruudunkaappauspaikka: bx_Layout → SectionTemplate.txt useilla osioilla ja erotin <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Ota kuva ja liitä se sitten tänne.

6. Ota Layout-kehys 00_layoutista

Pääotsikon, alatunnisteen ja pääosioiden jälkeen jäljelle jää varsinaiset HTML-rakenteet, esimerkiksi DOCTYPE, head-osa ja muita ylimpiä asettelu-elementtejä. Kopioi tämä jäljelle jäävä koodi.

Avaa sen jälkeen tietokannan hallinta ja muokkaa tietokantaa 00_layout. Siellä on jo saatavilla asettelumalleja. Voit muokata olemassa olevaa mallia tai luoda uuden asettelun.

Liitä kopioitu kehys LayoutHTML alle. Alkuperäisissä paikoissa otsikolle, pääsisällölle ja alatunnisteelle käytät CMS-tageja:

__DB_Layout_Header__

__DB_Layout_Main__

__DB_Layout_Footer__

Sivun renderöinnin yhteydessä nämä tagit korvataan vastaavalla otsikolla, nykyisellä pääsivulla ja alatunnisteella. Liittyvä PHP-koodi LayoutPHP suoritetaan automaattisesti asettelua ladattaessa.

Ruudunkaappauspaikka: Tietokanta 00_layout asettelun HTML:llä ja tageilla otsikolle, pääsisällölle ja alatunnisteelle – dev_bootstrap_import_00_layout_layouthtml.jpeg. Kuva otetaan vielä ja liitetään tämän jälkeen tähän kohtaan.

7. Tarkista CSS-, JavaScript- ja favicon-polut

Tarkista asettelukoodissa kaikki viittaukset CSS-, JavaScript- ja favicon-tiedostoihin. Aseta paikallisille poluille tarvittava eteenpäin suuntautuva viiva. Käytä CSS- ja JavaScript-tiedostoissa lisäksi CMS:n tiedostoversiomerkintää.

JavaScript-kutsu voi näyttää esimerkiksi tältä:

<script src="__FV_/bx_script/core.min.js__"></script>

Merkintä __FV_...__ mahdollistaa järjestelmälle tiedostoversion tai muutospäivämäärän huomioimisen renderöinnissä. Tämä mahdollistaa selaimen ladata nykyisen CSS- tai JavaScript-tiedoston, kun muutoksia on tapahtunut, ilman että käyttäjän täytyy päivittää selaimen välimuistia manuaalisesti.

8. Siivoa Head-sisältö ja käytä Header-HTML:ää

Tarkista hyväksytty head-alue ja poista sisältö, joka on jo asetettu CMS:n toimesta tai ladattu muualta. Voit myös poistaa kiinteästi asetetun sivun otsikon, jos se luodaan automaattisesti järjestelmän toimesta.

Otsikkokoodi, jota muokkaaja tarvitsee eikä sen tulisi olla suoraan osa LayoutHTML:ää, talletetaan Extras → Header-HTML -kohtaan. Tämän avulla muokkaaja voi ottaa huomioon siellä talletetut sisällöt sivua muokatessaan.

Ruudunkaappauspaikka: Extras → Header-HTML siirretyllä otsikkokoodilla – dev_bootstrap_import_extras_header_html.jpeg. Kuva otetaan vielä ja liitetään tämän jälkeen tähän kohtaan.

9. Valitse tuotu layout sivulle

Jos olet luonut uuden asettelun 00_layout:iin, avaa muokkaimessa Sivuasetukset ja valitse sieltä tuotu asettelu. Vasta sitten asianomainen sivu näytetään tämän asettelukehystyksen kanssa.

Ruudunkaappauspaikka: Sivuasetukset valinnan uudelleen tuodusta asettelusta – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Kuva otetaan vielä ja liitetään tämän jälkeen tähän kohtaan.

10. Kokoa kotisivu tuoduista osioista

Napsauta sivullasi Muokkaa. Etusivu voi aluksi näyttää tyhjältä. Tämä on normaalia, koska uusia sivuosia ei ole vielä lisätty varsinaiseen sivuun.

Valitse Lisää → Sivun osa. Siellä tulisi näkyä osiot, jotka olet aiemmin erotellut SectionTemplate.txt:ssä osioerottimella.

Lisää tarvittavat osiot yksi kerrallaan ja rakenna alkuperäinen sivu uudelleen. Voit sen jälkeen siirtää, poistaa tai lisätä osioita mielesi mukaan.

Ruudunkaappauspaikka: Muokkaa → Lisää → Sivun osa tuoduilla osiomalleilla – dev_bootstrap_import_sections_einfuegen.jpeg. Kuva otetaan vielä ja liitetään tämän jälkeen tähän kohtaan.

11. Käytä alkuperäistä sivua vertailuna

Osiossa Tiedostot → bx_Import voit edelleen avata alkuperäisen index.html:n esikatseluna. Käytä sitä vertailukohtana, kun koostan uuden CMS-sivusi eri osista.

Jos yksittäisistä malleista puuttuu aluksi kuvia, niiden oikea siirto käsitellään seuraavassa oppaassa.

12. Tarkista osioiden polut ja muokattavuus

Tarkista vielä kerran Osat → Osamalli ja tarkista kaikki paikalliset polut. Monimutkaisissa vastaavissa poluissa voit tehdä muutokset tehokkaasti tekstieditorissa käyttämällä Ctrl + H.

Testaa sitten jokainen tuotu osa muokkaimessa. Tarkista, näkyvätkö kaikki sisällöt oikein ja voiko suunniteltuja tekstejä ja elementtejä muokata.

Jos joku teksti ei esimerkiksi ole muokattavissa, tarkista sen HTML-rakenne. Jos normaali teksti on suoraan div-säiliössä, voi olla järkevää siirtää teksti soveltuvaan p-elementtiin riippuen asettelusta.

Ruudunkaappauspaikka: Valmis koostettu etusivu osien lisäämisen ja järjestämisen jälkeen – dev_bootstrap_import_fertige_startseite.jpeg. Kuva otetaan vielä ja liitetään tämän jälkeen tähän kohtaan.

13. Miksi asettelu jaetaan

Otsikon, alatunnisteen, asettelun kehyksen ja yksittäisten osien erottamisen ansiosta sinun ei tarvitse aina kopioida näitä osia uusilta sivuilta alkuperäisestä Bootstrap-tiedostosta.

Keskitettyä otsikkoa ja alatunnistetta voidaan käyttää uudelleen, kun taas yksittäiset sivuosat ovat flexibilejä malleja muokkaimessa. Näin voit koostaa eri sivuja Bootstrap-mallista ja muuttaa sisällön järjestystä milloin vain.

Yhteenveto

Bootstrap 5 -tuontiin käytät alkuperäisiä tiedostoja bx_Import mallina. Otsikko ja alatunniste siirretään erikseen määriteltyihin CMS-alueisiin, pääalue jaetaan SectionTemplate.txt:ssä eri malleihin ja jäljellä oleva HTML-kehys tallennetaan 00_layout → LayoutHTML.

Tämän jälkeen valitset sivuasetuksista asettelun ja yhdistät sivun importoiduista osioista valitsemalla Lisää → Sivunosa. Tarkista lopuksi kaikki polut, CSS- ja JavaScript-viittaukset sekä kunkin osion muokattavuus.

UKK

mitä asiakkaat meiltä usein kysyvät

Miksi alkuperäinen Bootstrap-malli säilyy bx_Import -kansiossa?

Kansio bx_Import toimii lähtökohtana ja viitteenä importoidulle alkuperäismallille. Tarvittavat osat siirretään sieltä erilaisiin CMS-alueisiin.

Mitä tiedostoa käytän ensimmäisessä tuonnissa?

Tässä opetusohjelmassa käytetään lähtökohtana tiedostoa index.html. Siitä erotetaan header, footer, pääosat ja muu asettelun kehys.

Miten löydän headerin ja footerin nopeasti HTML-koodista?

Käytä Ctrl + F ja hae esimerkiksi header tai footer. Mallien, joissa ei ole vastaavia HTML-tageja, osalta sinun on tutkittava ympäröiviä div-rakenteita tarkemmin.

Missä yksittäiset sivuosat tallennetaan?

Mallit tallennetaan bx_Layout -kansioon tiedostoon SectionTemplate.txt, ja ne erotellaan toisistaan merkkijonolla <!--__SP_SectionTemplate__-->.

Mitä tageja LayoutHTML tarvitsee?

Erotettujen alueiden kohdissa käytät __DB_Layout_Header__, __DB_Layout_Main__ ja __DB_Layout_Footer__.

Miksi CSS- ja JavaScript-tiedostoja merkitään __FV_?

Näin CMS voi renderöinnin yhteydessä ottaa huomioon tiedoston version tai muutospäivämäärän. Muutoksen jälkeen selain voi ladata nykyisen tiedoston sen sijaan, että se käyttäisi vanhentunutta välimuistiversiota.

Miksi etusivu on tyhjää layout-imen allassa?

Asettelu tarjoaa aluksi vain kehyksen. Itse sivuosat on lisättävä sivulle valitsemalla Lisää → Sivunosa.

Voinko käyttää importoitua sivuosiota useaan kertaan?

Kyllä. Eroitetut osiomallit voidaan lisätä, siirtää ja käyttää useaan kertaan editorissa tarpeen mukaan.

Mitä teen, jos suhteelliset kuva- tai linkkipolut eivät toimi?

Tarkista paikalliset href- ja src-polut ja lisää tarvittaessa johtava viiva. Ctrl + H:lla voit korvata toistuvia polkuja, mutta älä muokkaa ulkoisia URL-osoitteita, ankkureita ja muita erikoispolkuja huolettomasti.

Mitä voin tehdä, jos tekstiä ei voi muokata editorissa?

Tarkista kyseisen osion HTML-rakenne. Jos tavallinen teksti on suoraan div-säilössä, voi olla hyödyllistä käyttää sopivaa p-elementtiä rakenteen mukaan.

Miten voin verrata alkuperäistä sivua uudelleenrakentamisen aikana?

Avaa alkuperäinen index.html tiedostoista → bx_Import esikatselun kautta ja käytä sitä viitteenä osioiden järjestykselle ja rakenteelle.

CMS