Podstawowa struktura motywu

Podstawowa struktura motywu zawiera projekt, nawigację i style określone w folderach przechowywanych w Oracle Content Management. Motyw jest częścią szablonu serwisu.

Gdy użytkownik wybierze szablon do utworzenia nowego serwisu, dane powiązanego motywu zostaną automatycznie załadowane. Jeśli jest używany szablon początkowy JET lub szablon początkowy, motyw jest automatycznie kopiowany (nie jest używane odwołanie do niego). Jeśli w pracach programistycznych jest używany szablon początkowy, programista potrzebuje własnej kopii motywu.

Motyw jest uporządkowany według określonej struktury folderów i plików, tak jak zostało to przedstawione w poniższym przykładzie, pokazującym podstawowe foldery i pliki:

    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

Niektóre foldery zawierają określone typy informacji:

  • assets: Skrypty JavaScript, arkusze CSS (Cascading Style Sheet), obrazy i inne pliki pomocnicze, do których odwołują się układy.

  • designs: Pliki design.css i design.json, które są używane do określania opcji stylów dla składników.

  • layouts: Pliki HTML szablonów strony, które służą do wyświetlania stron serwisów.

    Uwaga:

    Wszystkie pliki HTML muszą zawierać na początku pliku element DOCTYPE w następującej postaci: <!DOCTYPE html>

  • publish: Gdy motyw zostanie użyty w opublikowanym serwisie, katalog ten będzie uwzględniany na listach i będzie zawierał kopie plików. Jeśli motyw został zsynchronizowany przy użyciu aplikacji typu Desktop, katalog ten jest widoczny, lecz nie jest uwzględniany, jeśli motyw wyeksportowano jako część szablonu.

  • responsepages: Specjalna strona do obsługi błędów (404).

    Uwaga:

    Jeśli strona w serwisie jest oznaczona jako strona błędu, zostanie zignorowany komunikat o błędzie 404 z motywu i zostanie użyta wyznaczona strona błędu.

  • viewport.json: Określa ustawienia portu widoku motywu.

  • _folder.json: Określa nazwę i GUID motywu. Na przykład:

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

    GUID jest tworzony przez Oracle Content Management, kiedy motyw jest importowany po raz pierwszy lub gdy jest kopiowany. Nazwa motywu jest przypisywana przez twórcę motywu podczas jego tworzenia.

  • components.json: (Przestarzałe.) Zapisuje składniki niestandardowe, które są używane w obrębie motywu. Plik ten jest utrzymywany wyłącznie w celu zapewnienia zgodności wstecznej.

Istnieją dwa kluczowe piki, z którymi twórca pracuje podczas tworzenia nowego motywu. Za pomocą tych plików ustawia się style składników:

  • design.css

  • design.json

Dobrą praktyką jest zawieranie informacji nawigacyjnych w jednym pliku JavaScript; na przykład w pliku o nazwie nav.js. Folder /assets/js/ motywu jest dobrym miejscem do przechowywania tego typu pliku.