Базовая структура темы

Базовая структура темы включает дизайн, навигацию и стили, указанные в папках, хранящихся в 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/ темы — хорошее место для такого файла.