Estructura de plantilla básica

La estructura básica de una plantilla incluye un sitio (con activos, diseños, páginas y contenido), un tema asociado y todos los componentes personalizados.

Al crear un sitio, debe seleccionar una plantilla para proporcionar la estructura de sitio y el contenido inicial, un tema con especificaciones de diseño y todos los componentes personalizados.

Una plantilla se organiza con una estructura específica, como se ilustra en este ejemplo que muestra las carpetas y los archivos básicos:

template_name
    components
        component_name
            assets
                render.js
                settings.html
            _folder.json
            _folder_icon.jpg
            appinfo.json
    template
        assets
        content
        layouts
        pages
            100.json
            200.json
            300.json
            400.json
        variants
        _folder.json
        _folder_icon.png
        componentsused.json
        controller.html
        siteinfo.json
        structure.json
    theme
        assets
            css
                main.css
            js
                topnav.js
        designs
            default
                design.css
                design.json
                facebook.png
                googleplus.png
                linkedin.png
                twitter.png
                youtube.pgn
        layouts
            index.html
        responsepages
            404.html
        _folder.json
        _folder_icon.png
        components.json
        viewport.json

Las carpetas y los archivos de componentes y temas se describen en otra sección de esta guía. Consulte Acerca del desarrollo de componentes y Estructura básica de un tema.

Notas:

  • Normalmente, se comparte un tema entre plantillas, a menos que se utilice la plantilla de inicio de JET o la plantilla de inicio, que utiliza una copia de un tema. Consulte Trabajar con una plantilla de inicio.

  • El tema ya no contiene el sitio. Las carpetas y los archivos del sitio están en la carpeta /template.

La carpeta nombre_plantilla/template contiene las carpetas y los archivos del sitio.

  • assets: contiene imágenes que se muestran en la página de detalles de plantilla en la interfaz de usuario.

  • content: incluye contenido gestionado que se utiliza en el sitio.

  • layouts: no se utiliza en este momento.

  • pages: contiene todos los archivos JSON de página con los datos. Utiliza el formato nnn.json, donde nnn es el identificador de página.

  • variants: contiene los detalles de todas las actualizaciones del sitio.

  • _folder.json: contiene metadatos para la plantilla, como el autor del sitio, el nombre del sitio, el GUID del elemento y descripciones de sitio cortas y largas.

  • _folder_icon.png: representa el sitio en la interfaz de usuario.

  • componentsused.json: (en desuso). Registra los componentes personalizados, si los hay, que se utilizan en el sitio. Solo se mantiene para la compatibilidad con versiones anteriores.

  • controller.html: contiene el código de clave que muestra el sitio en un explorador. Si desea realizar cambios en este archivo, Oracle le recomienda que lo haga a través de la configuración del sitio en la interfaz. Puede modificar el archivo fuera de línea. Consulte Personalización del archivo controlador.

  • siteinfo.json: identifica el nombre del sitio y el nombre del tema asociado junto con otros metadatos para el sitio. No modifique este archivo.

  • structure.json: define la jerarquía del sitio para las páginas (páginas principales y secundarias). La API de representación se puede utilizar para definir la estructura de árbol al configurar la navegación del sitio. Consulte Navegación del sitio y Referencia de API de representación.