Estructura
Un tema está compuesto completamente por archivos.
Cada tema debe tener un código interno compuesto por letras ASCii (a-z) en minúsculas, sin espacios, sin acentos ni signos de puntuación. Por ejemplo un tema llamado "Île de la Cité" podría tener el siguiente código: "ile_cite".
El nombre interno debe utilizarse como el nombre de la carpeta que contiene todos los archivos de tema. En nuestro ejemplo, el tema se encontraría en:
/www/navigate/themes/ile_cite
Navigate CMS requiere que los temas tengan los siguientes archivos dentro de su carpeta:
- ile_cite.theme
- Definición del tema.
- thumbnail.png
- Una captura de pantalla o una imagen identificativa del tema (205 x 145 px).
- ile_cite.info.html
- Fichero de ayuda para que los usuarios puedan consultar instrucciones en Navigate CMS.
- ile_cite.nvweb.php
- (opcional) Webget del tema, para aplicar opciones del tema o generar contenido en las plantillas con su propia etiqueta "nv".
- demo.html
- (opcional) Página HTML que será cargada como previsualización o demostración del tema.
- ile_cite_sample.zip
- (opcional) Contenido de un sitio de muestra para el tema listo para ser importado en Navigate CMS (creado usando Temas / "Exportar ejemplo de contenido").
Nota: reemplaza "ile_cite" por el nombre interno de tu tema.
Más allá de los archivos necesarios puedes organizar tus otros archivos del tema como prefieras.
Ejemplo real: Tema Ocean
Ocean es un tema gratuito que encontrarás disponible en la tienda de Navigate CMS. Echemos un vistazo a la organización de todos sus archivos:
- /ocean
- css/
- black/
- black.css
- content.css
- global.css
- blue/
- blue.css
- content.css
- global.css
- i18n/
- en.json
- es.json
- img/
- colors/
- black_quotes1.png
- ...
- quotes1.png
- rss.png
- ...
- js/
- jquery-min.js
- ocean.js
- samples/
- content_fullwidth.html
- home.html
- ...
- templates/
- blog.nvt.html
- blog-entry.nvt.html
- contact.nvt.html
- content.nvt.html
- content-fullwidth.nvt.html
- content-right.nvt.html
- footer.nvt.html
- head.nvt.html
- home.nvt.html
- portfolio.nvt.html
- portfolio-item.nvt.html
- search.nvt.html
- demo.html
- ocean.info.html
- ocean.nvweb.html
- ocean.theme
- thumbnail.png
- ocean_sample.zip
Como puedes ver, la carpeta raíz (/ocean) contiene todos los archivos requeridos por Navigate CMS mientras que todos los demás archivos del tema están ubicados en subcarpetas:
- /ocean/css
- Los estilos del tema (una subcarpeta por cada variación de color).
- /ocean/i18n
- Traducciones.
- /ocean/img
- Imágenes del tema.
- /ocean/js
- Librería jQuery y otros ficheros Javascript del tema Ocean.
- /ocean/samples
- Ejemplos de contenido en HTML que pueden ser importados en el editor wysiwyg cuando editamos el contenido del sitio web.
- /ocean/templates
- Plantilla del tema usando etiquetas "nv".
Esta organización de archivos es muy limpia y entendible. También podríamos poner todos los archivos en la capeta raíz pero seria bastante caótico para un tema mediano-grande. De todos modos tú eliges.
Navigate CMS sabe dónde encontrar los archivos del tema examinando la definición del tema, por lo tanto vamos a continuar con el siguiente capítulo.
0 Comentarios