A estrutura básica de um tema inclui o design, a navegação e os estilos especificados nas pastas armazenadas no Oracle Content Management. Um tema faz parte do modelo de um site.
Quando um utilizador seleciona um modelo para criar um novo site, os dados do tema associado são carregados automaticamente. Se utilizar o Modelo Inicial JET ou o Modelo Inicial, o tema é automaticamente copiado em vez de referenciado. Como programador, se estiver a utilizar o modelo inicial, pretende a sua própria cópia do tema.
Um tema está organizado numa estrutura específica de pastas e ficheiros, conforme ilustrado neste exemplo que mostra as pastas e os ficheiros básicos:
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
Determinadas pastas contêm tipos específicos de informações, incluindo as pastas seguintes:
assets
: JavaScript, Folha de estilos em cascata (CSS), imagens e outros ficheiros de suporte que são referenciados pelas disposições.
designs
: Ficheiros design.css
e design.json
, que são utilizados para especificar as opções de estilo para os componentes.
layouts
: Ficheiros HTML para os modelos de páginas, que são utilizados para apresentar as páginas do site.
Nota:
Todos os ficheiros HTML devem ter um elemento DOCTYPE no início do ficheiro semelhante ao seguinte:<!DOCTYPE html>
publish
: Depois de um tema ser utilizado num site publicado, este diretório é listado e contém cópias dos ficheiros. Este diretório está visível se tiver sincronizado o tema utilizando a aplicação do ambiente de trabalho, mas não é incluído se tiver exportado o tema como parte de um modelo.
responsepages
: Página especial para o tratamento de erros (404).
Nota:
Se uma página num site estiver indicada como uma Página de Erro, a mensagem de erro 404 do tema será ignorada e a Página de Erro designada será utilizada.viewport.json
: Especifica as definições de Delimitação para o tema.
_folder.json
: Especifica o nome e a GUID para o tema. Por exemplo:
{ "themeName":"MarketingCampaignTheme", "itemGUID":"TB79D65F699B022AC4E11F4D4EE870070A1ADD86BBBB" }
A GUID é criada pelo Oracle Content Management quando o tema é importado pela primeira vez ou quando é copiado. O nome do tema é atribuído pelo programador do tema na respetiva criação.
components.json
: (Obsoleto.) Regista os componentes customizados utilizados no tema. Mantido apenas para compatibilidade com versões anteriores.
Existem dois ficheiros principais com os quais irá trabalhar ao criar um novo tema. Estes ficheiros definem os estilos para os componentes:
design.css
design.json
É recomendável colocar as informações de navegação num ficheiro JavaScript; por exemplo, um ficheiro denominado topnav.js
. A pasta /assets/js/
do tema é uma localização adequada para esse ficheiro.