Grundläggande temastruktur

Ett temas grundläggande struktur inkluderar den design, den navigering och de format som specificeras i mappar som finns lagrade i Oracle Content Management. Ett tema är en del av mallen för en webbplats.

När en användare väljer en mall för att skapa en ny webbplats laddas associerade temadata automatiskt. Om du använder JET-startmallen eller startmallen kopieras temat automatiskt i stället för att refereras till. Som utvecklare som använder startmallen vill du ha en egen kopia av temat.

Ett tema är organiserat i en specifik mapp- och filstruktur, som följande exempel visar, med grundläggande mappar och 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

Vissa mappar innehåller specifika typer av information, däribland följande mappar:

  • assets: JavaScript, formatmallar (CSS), bilder och andra stödfiler som layouterna refererar till.

  • Filerna designs: design.css och design.json, som används för att specificera formatalternativ för komponenter.

  • layouts: HTML-filer för sidmallar, som används för att visa webbplatsens sidor.

    Obs!:

    Alla HTML-filer måste ha ett DOCTYPE-element i början av filen som ser ut så här: <!DOCTYPE html>
  • publish: När ett tema har använts på en publicerad webbplats listas den här katalogen, som då innehåller kopior av filer. Den här katalogen är synlig om du har synkroniserat temat med hjälp av datorappen, men den inkluderas inte om du har exporterat temat som en del av en mall.

  • responsepages: Särskild sida för hantering av fel (404).

    Obs!:

    Om en sida på en webbplats flaggas som en felsida ignoreras felmeddelandet 404 från temat, och den angivna felsidan används i stället.
  • viewport.json: Specificerar visningsområdesinställningar för temat.

  • _folder.json: Specificerar namn och GUID för temat. Exempel:

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

    GUID skapas av Oracle Content Management när temat först importeras eller när det kopieras. Temanamnet tilldelas av temautvecklaren i samband med att temat skapas.

  • components.json: (inaktuell) Registrerar de anpassade komponenter som används i temat. Underhålls endast för bakåtkompatibilitet.

Det finns två nyckelfiler som du arbetar med när du skapar ett nytt tema. Dessa filer anger format för komponenter:

  • design.css

  • design.json

Det är god praxis att placera navigeringsinformation i en JavaScript-fil, t.ex. en fil med namnet nav.js. Temats /assets/js/-mapp är en bra plats för en sådan fil.