模板的基本结构包括站点(具有资产、布局、页和内容)、关联的主题以及任何定制组件。
创建站点时,必须选择模板以提供站点结构和初始内容、包含设计和布局规范的主题以及任何定制组件。
模板在特定结构中进行组织,如以下示例中所示,其中显示了基本文件夹和文件。
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
组件和主题文件夹及文件在本指南的其他位置进行介绍。请参见关于开发组件和基本主题结构。
注释:
通常,主题在模板之间进行共享,除非您使用 JET 入门级模板或入门级模板,其使用主题的副本。请参见使用入门级模板。
主题不再包含站点。站点文件夹和文件位于 /template
文件夹中。
template_name/template
文件夹包含站点的文件夹和文件。
assets
:包含用户界面中的模板详细信息页中显示的图像。
content
:包含站点中使用的托管内容。
layouts
:此时不使用。
pages
:包含所有页 JSON 文件及数据。使用格式 nnn.json
,其中 nnn
是页 ID。
variants
:包含站点的所有更新的详细信息。
_folder.json
:包含模板的元数据,例如站点作者、站点名称、项 GUID、简要和详细站点说明。
_folder_icon.png
:表示用户界面中的站点。
componentsused.json
:(已废弃。)记录站点内使用的定制组件(如果有)。维护此项仅用于向后兼容。
controller.html
:包含在浏览器中显示站点的键代码。如果要对此文件进行更改,Oracle 建议通过界面中的站点设置执行此操作。可以脱机修改该文件。请参见定制控制器文件。
siteinfo.json
:标识站点名称和关联主题的名称,以及站点的其他元数据。不要修改此文件。
structure.json
:为页(父和子页)定义站点的层次。为站点设置导航时,可以使用呈现 API 来提取树结构。请参见站点导航和呈现 API 参考。