基本主题结构

主题的基本结构包括 Oracle Content Management 中存储的文件夹中指定的设计、导航和样式。主题是站点的模板的一部分。

用户选择模板来创建新站点时,将自动加载关联的主题数据。如果使用 JET 入门级模板或入门级模板,将自动复制主题,而不是引用主题。作为开发人员,如果您使用入门级模板,则需要您自己的主题副本。

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

    theme
         assets
             css
                 main.css
             js
                 topnav.js
         designs
             default
                design.css
                design.json
         layouts
         publish
         responsepages
             404.html
         viewport.json
         _folder.json
         _folder_icon.png
         components.json

某些文件夹包含特定类型的信息,包括以下文件夹:

  • assets:JavaScript、级联样式表 (Cascading style sheet, CSS)、图像以及布局引用的其他支持文件。

  • designsdesign.cssdesign.json 文件,用于指定组件的样式选项。

  • layouts:页模板的 HTML 文件,用于显示站点页。

    注:

    所有 HTML 文件在文件开头都必须具有 DOCTYPE 元素,如下所示:<!DOCTYPE html>
  • publish:主题已用于发布的站点中后,将列出此目录,其中包含文件的副本。如果您使用桌面应用程序同步了主题,则此目录可见,但是如果您作为模板的一部分导出了主题,则不包括此目录。

  • responsepages:用于处理错误 (404) 的特殊页。

    注:

    如果站点中的页标记为错误页,将忽略来自主题的 404 错误消息,改为使用指定的错误页。
  • viewport.json:指定主题的视窗设置。

  • _folder.json:指定主题的名称和 GUID。例如:

    {
          "themeName":"MarketingCampaignTheme",
          "itemGUID":"TB79D65F699B022AC4E11F4D4EE870070A1ADD86BBBB"
    }

    第一次导入主题或者复制主题时,Oracle Content Management 创建 GUID。主题名称在创建主题时由主题开发人员分配。

  • components.json:(已废弃。)记录主题内使用的定制组件。维护此项仅用于向后兼容。

创建新主题时,您将使用两个主要文件。以下文件为组件设置样式:

  • design.css

  • design.json

最好将导航信息放入一个 JavaScript 文件;例如,名为 nav.js 的文件。主题的 /assets/js/ 文件夹是此类文件的合适位置。