Grunnleggende temastruktur

Den grunnleggende strukturen for et tema omfatter utforming, navigering og stiler som er angitt i mapper som er lagret i Oracle Content Management. Et tema er en del av malen for et område.

Når en bruker velger en mal til å opprette et nytt område, lastes de tilknyttede temadataene automatisk. Hvis du bruker JET-startmalen eller startmalen, kopieres temaet automatisk i stedet for at det blir referert til. Som utvikler vil du ha en egen kopi av temaet hvis du bruker startmalen.

Et tema er organisert i en bestemt mappe- og filstruktur, som illustrert i dette eksemplet som viser grunnleggende mapper og filer:

    theme
         assets
             css
                 main.css
             js
                 topnav.js
         designs
             default
                design.css
                design.json
         layouts
         publish
         responsepages
             404.html
         viewport.json
         _folder.json
         _folder_icon.png
         components.json

Noen mapper inneholder bestemte typer opplysninger, inkludert følgende mapper:

  • assets: JavaScript, CSS (Cascading Style Sheet), bilder og andre støttefiler som det refereres til av oppsettene.

  • designs: Filene design.css og design.json som brukes til å angi stilvalg for komponenter.

  • layouts: HTML-filer for sidemaler, som brukes til å vise sider for området.

    Merknad:

    Alle HTML-filer må ha et DOCTYPE-element i begynnelsen av filen som ser ut som dette: <!DOCTYPE html>
  • publish: Når et tema er brukt i et publisert område, vises katalogen, og den inneholder kopier av filer. Denne katalogen er synlig hvis du har synkronisert temaet ved hjelp av skrivebordsappen, men den er ikke inkludert hvis du har eksportert temaet som en del av en mal.

  • responsepages: Spesialside for håndtering av feil (404).

    Merknad:

    Hvis en side er flagget som en feilside, ignoreres 404-feilmeldingen fra temaet, og den utpekte feilsiden brukes i stedet.
  • viewport.json: Angir visningsportinnstillinger for temaet.

  • _folder.json: Angir navn og GUID for temaet. For eksempel:

    {
          "themeName":"MarketingCampaignTheme",
          "itemGUID":"TB79D65F699B022AC4E11F4D4EE870070A1ADD86BBBB"
    }

    GUID-en opprettes av Oracle Content Management første gang temaet importeres eller når det kopieres. Temanavnet tilordnes av temautvikleren ved opprettelse av et tema.

  • components.json: (frarådet) Registrerer de egendefinerte komponentene som brukes i temaet. Vedlikeholdes bare for bakoverkompatibilitet.

Det finnes to nøkkelfiler du arbeider med når du oppretter et nytt tema. Disse filene definerer stiler for komponenter:

  • design.css

  • design.json

Det er god praksis å legge navigeringsopplysninger i en JavaScript-fil, for eksempel en fil med navnet nav.js. Temaets /assets/js/-mappe er en god plassering for en slik fil.