基本模板结构

模板的基本结构包括站点(具有资产、布局、页和内容)、关联的主题以及任何定制组件。

创建站点时,必须选择模板以提供站点结构和初始内容、包含设计和布局规范的主题以及任何定制组件。

模板在特定结构中进行组织,如以下示例中所示,其中显示了基本文件夹和文件。

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 参考