Базовая структура темы включает дизайн, навигацию и стили, указанные в папках, хранящихся в 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, каскадная таблица стилей (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" }
GUID создается средой Oracle Content Management при первом импорте или копировании темы. Имя темы назначается разработчиком темы при ее создании.
components.json
: (устарело) Запись пользовательских компонентов, используемых в теме. Поддерживается только для обратной совместимости.
Есть два ключевых файла, с которыми вы будете работать при создании новой темы. Эти файлы задают стили компонентов:
design.css
design.json
Рекомендуется поместить информацию о перемещении в один файл JavaScript, например в файл nav.js
. Папка /assets/js/
темы — хорошее место для такого файла.