Grunnleggende malstruktur

Den grunnleggende strukturen for en mal omfatter et område (med aktiva, oppsett, sider og innhold), et tilknyttet tema og hvilke som helst egendefinerte komponenter.

Når du oppretter et område, må du velge en mal som kan gi området struktur og opprinnelig innhold, et tema med spesifikasjoner av utforming og oppsett, og hvilke som helst egendefinerte komponenter.

En mal er organisert i en bestemt struktur, som illustrert i dette eksemplet som viser grunnleggende mapper og filer:

template_name
    components
        component_name
            assets
                render.js
                settings.html
            _folder.json
            _folder_icon.jpg
            appinfo.json
    template
        assets
        content
        layouts
        pages
            100.json
            200.json
            300.json
            400.json
        variants
        _folder.json
        _folder_icon.png
        componentsused.json
        controller.html
        siteinfo.json
        structure.json
    theme
        assets
            css
                main.css
            js
                topnav.js
        designs
            default
                design.css
                design.json
                facebook.png
                googleplus.png
                linkedin.png
                twitter.png
                youtube.pgn
        layouts
            index.html
        responsepages
            404.html
        _folder.json
        _folder_icon.png
        components.json
        viewport.json

Mapper og filer med komponenter og temaer beskrives et annet sted i denne veiledningen. Se Om utvikling av komponenter og Grunnleggende temastruktur.

Merknader:

  • Generelt deles et tema mellom maler, med mindre du bruker JET-startmalen eller startmalen, som bruker en kopi av et tema. Se Arbeide med en oppstartsmal.

  • Temaet inneholder ikke lenger området. Områdmappene og -filene ligger i mappen /template.

Mappen template_name/template inneholder mappene og filene for området.

  • assets inneholder bilder som vises på maldetaljsiden i brukergrensesnittet.

  • content inneholder adminstrert innhold som brukes i området.

  • layouts brukes ikke nå.

  • pages inneholder alle side-JSON-filene med data. Bruker formatet nnn.json, der nnn er side-ID-en.

  • variants inneholder detaljer for alle oppdateringene for området.

  • _folder.json inneholder metadata for malen, som områdeforfatter, områdenavn, element-GUID, og korte og lange områdebeskrivelser.

  • _folder_icon.png representerer området i brukergrensesnittet.

  • componentsused.json (frarådes) Registrerer de egendefinerte komponentene som brukes, hvis noen, i området. Vedlikeholdes bare for bakoverkompatibilitet.

  • controller.html inneholder nøkkelkoden som viser området i en nettleser. Hvis du vil gjøre endringer i denne filen, anbefaler Oracle at du gjør det via områdeinnstillingene i grensesnittet. Du kan endre filen i frakoblet modus. Se Tilpasse kontrollerfilen.

  • siteinfo.json identifiserer områdenavnet og navnet på det tilknyttede temaet, sammen med andre metadata for området. Du må ikke endre denne filen.

  • structure.json definerer hierarkiet i området for sider (over- og underordnede sider). Gjengivelses-API-et kan brukes til å tegne trestrukturen ved oppsett av navigeringen for området. Se Områdenavigering og Referanse for API-er for gjengivelse.