Den grunnleggende strukturen for en mal omfatter et område (med aktiva, oppsett, sider og innhold), et tilknyttet tema og hvilke som helst egendefinerte komponenter.
Når du oppretter et område, må du velge en mal som kan gi området struktur og opprinnelig innhold, et tema med spesifikasjoner av utforming og oppsett, og hvilke som helst egendefinerte komponenter.
En mal er organisert i en bestemt struktur, som illustrert i dette eksemplet som viser grunnleggende mapper og filer:
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
Mapper og filer med komponenter og temaer beskrives et annet sted i denne veiledningen. Se Om utvikling av komponenter og Grunnleggende temastruktur.
Merknader:
Generelt deles et tema mellom maler, med mindre du bruker JET-startmalen eller startmalen, som bruker en kopi av et tema. Se Arbeide med en oppstartsmal.
Temaet inneholder ikke lenger området. Områdmappene og -filene ligger i mappen /template
.
Mappen template_name/template
inneholder mappene og filene for området.
assets
inneholder bilder som vises på maldetaljsiden i brukergrensesnittet.
content
inneholder adminstrert innhold som brukes i området.
layouts
brukes ikke nå.
pages
inneholder alle side-JSON-filene med data. Bruker formatet nnn.json
, der nnn
er side-ID-en.
variants
inneholder detaljer for alle oppdateringene for området.
_folder.json
inneholder metadata for malen, som områdeforfatter, områdenavn, element-GUID, og korte og lange områdebeskrivelser.
_folder_icon.png
representerer området i brukergrensesnittet.
componentsused.json
(frarådes) Registrerer de egendefinerte komponentene som brukes, hvis noen, i området. Vedlikeholdes bare for bakoverkompatibilitet.
controller.html
inneholder nøkkelkoden som viser området i en nettleser. Hvis du vil gjøre endringer i denne filen, anbefaler Oracle at du gjør det via områdeinnstillingene i grensesnittet. Du kan endre filen i frakoblet modus. Se Tilpasse kontrollerfilen.
siteinfo.json
identifiserer områdenavnet og navnet på det tilknyttede temaet, sammen med andre metadata for området. Du må ikke endre denne filen.
structure.json
definerer hierarkiet i området for sider (over- og underordnede sider). Gjengivelses-API-et kan brukes til å tegne trestrukturen ved oppsett av navigeringen for området. Se Områdenavigering og Referanse for API-er for gjengivelse.