主题的基本结构包括 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)、图像以及布局引用的其他支持文件。
designs
:design.css
和 design.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/
文件夹是此类文件的合适位置。