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.