Estructura básica de un tema

La estructura básica de un tema incluye el diseño, la navegación y los estilos especificados en carpetas almacenadas en Oracle Content Management. Un tema forma parte de la plantilla de un sitio.

Cuando un usuario selecciona una plantilla para crear un nuevo sitio, se cargan automáticamente los datos de temas asociados. Si utiliza la plantilla de inicio de JET o la plantilla de inicio, el tema se copia automáticamente en lugar de hacer referencia a él. Como desarrollador, si utiliza la plantilla de inicio, deseará tener su propia copia del tema.

Un tema se organiza con una estructura de carpetas y archivos específica, como se ilustra en este ejemplo que muestra las carpetas y los archivos 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

Algunas carpetas contienen tipos de información específicos, como las siguientes carpetas:

  • assets: JavaScript, hoja de estilo en cascada (CSS), imágenes y otros archivos admitidos a los que hacen referencia los diseños.

  • designs: archivos design.css y design.json, que se utilizan para especificar opciones de estilo para los componentes.

  • layouts: archivos HTML para plantillas de página, que se utilizan para mostrar las páginas del sitio.

    Nota:

    Todos los archivos HTML deben tener un elemento DOCTYPE al inicio del archivo similar al siguiente: <!DOCTYPE html>
  • publish: una vez que se ha utilizado un tema en un sitio publicado, se muestra este directorio que contiene copias de los archivos. Este directorio es visible si ha sincronizado el tema utilizando la aplicación de escritorio, pero no se incluye si ha exportado el tema como parte de una plantilla.

  • responsepages: página especial para gestionar los errores (404).

    Nota:

    Si una página de un sitio se ha marcado como página de errores, se ignorará el mensaje de error 404 del tema y se utilizará en su lugar la página de errores designada.
  • viewport.json: especifica la configuración de ventanilla del tema.

  • _folder.json: especifica el nombre y el GUID del tema. Por ejemplo:

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

    El GUID lo crea Oracle Content Management cuando se importa el tema por primera vez o cuando se copia. El nombre de tema lo asigna el desarrollador del tema al crear un tema.

  • components.json: (en desuso). Registra los componentes personalizados que se utilizan en el tema. Solo se mantiene para la compatibilidad con versiones anteriores.

Hay dos archivos clave con los que trabajará al crear un nuevo tema. Los siguientes archivos definen los estilos de los componentes:

  • design.css

  • design.json

Se recomienda colocar la información de navegación en un archivo JavaScript; por ejemplo, en un archivo denominado nav.js. La carpeta /assets/js/ del tema es una buena ubicación para dicho archivo.