Podstawowa struktura szablonu

Podstawowa struktura szablonu zawiera serwis (z zasobami, układami, stronami i zawartością), powiązany motyw oraz wszelkie składniki niestandardowe.

Tworząc serwis, trzeba wybrać szablon, zapewniający serwisowi strukturę i zawartość początkową, motyw z projektem i specyfikacjami układu oraz wszelkie składniki niestandardowe.

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

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

Foldery i pliki składników i motywów zostały opisane w innym rozdziale tego podręcznika. Zob. Tworzenie składników — informacje podstawowe i Podstawowa struktura motywu.

Uwagi:

  • Ogólnie motyw jest współużytkowany przez szablony, chyba że zostanie użyty szablon początkowy JET lub szablon początkowy, który korzysta z kopii motywu. Zob. Praca z szablonem początkowym.

  • Motyw nie zawiera już serwisu. Foldery i pliki serwisu są przechowywane w folderze /template.

Folder nazwa_szablonu/template zawiera foldery i pliki serwisu.

  • assets: Zawiera obrazy, które są wyświetlane na stronie szczegółów szablonu w interfejsie użytkownika.

  • content: Zawiera zarządzaną zawartość, która jest używana w serwisie.

  • layouts: Obecnie nie jest używany.

  • pages: Zawiera wszystkie pliki JSON strony wraz z danymi. Używa formatu nnn.json, gdzie nnn to ID strony.

  • variants:Zawiera szczegóły wszystkich aktualizacji serwisu.

  • _folder.json: Zawiera metadane szablonu, takie jak autor szablonu, nazwa serwisu, GUID elementu, krótki oraz długi opis serwisu.

  • _folder_icon.png: Reprezentuje serwis w interfejsie użytkownika.

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

  • controller.html: Zawiera kod klucza, który wyświetla serwis w przeglądarce. Jeśli trzeba dokonać zmian w tym pliku, Oracle zaleca skorzystanie z ustawień serwisu w interfejsie. Plik ten można modyfikować w trybie offline. Zob. Dostosowywanie pliku kontrolera.

  • siteinfo.json: Identyfikuje nazwę serwisu i nazwę powiązanego motywu wraz z innymi metadanymi serwisu. Tego pliku nie należy modyfikować.

  • structure.json: Definiuje hierarchię stron w serwisie (stron nadrzędnych i podrzędnych). Render API można używać do tworzenia struktury drzewa podczas konfigurowania nawigacji dla serwisu. Zob. Nawigacja serwisu i Render API — opis.