Tutorial - Instalación y configuración de Cecil, un generador de sitios estáticos (SSG) en PHP

Objetivo

Este tutorial explica cómo instalar y configurar Cecil. Se trata de una aplicación escrita en PHP que permite generar y administrar páginas web estáticas.

Un sitio web compuesto principalmente por páginas web estáticas garantiza un mejor tiempo de carga para sus visitantes y una mayor seguridad. Sin un contenido dinámico, sus páginas son más robustas ante los ataques informáticos. La generación de un sitio estático permite disponer de una mayor libertad para crear el sitio web que elija. También ganará tiempo porque no tendrá que empezar desde cero.

Descubra cómo Cecil le permite crear su sitio estático con un motor de plantillas moderno (Jamstack).

Requisitos

• Disponer de un plan de hosting de OVHcloud con acceso SSH. Este acceso permite instalar en línea de comandos una o más soluciones alternativas a las que ofrecen nuestros planes de hosting por defecto.
• Estar familiarizado con la entrada en línea de comandos.
• Poder transferir archivos por FTP con un cliente como FileZilla.
• Configure su zona DNS para que su nombre de dominio (o subdominio) apunte a su alojamiento web compartido. Esto resulta especialmente útil si desea alojar varios sitios web en su alojamiento web compartido.
• Instalar previamente Componer con el archivo composer.phar en la raíz de su alojamiento web compartido o en la carpeta de destino de su nombre de dominio.

Procedimiento

Un alojamiento web compartido permite declarar dominios o subdominios en los sitios web que contiene. Un dominio o subdominio es necesario para desplegar su sitio web realizado con Cecil.

Para ayudarle a declarar un dominio o subdominio en uno de los sitios web de su alojamiento, consulte nuestra página « Compartir su alojamiento entre varios sitios ».

Crear el directorio en el que serán sus archivos

Una vez que se haya conectado al alojamiento web por SSH, cree un directorio en la raíz con el siguiente comando:

mkdir mystaticwebsite

Sustituya mystaticwebsite por el nombre de la carpeta que desee (sin acentos y sin espacios).

A continuación, acceda al directorio:

cd mystaticwebsite

Sustituya mystaticwebsite por su nombre de carpeta.

Descarga

En el directorio que acaba de crear, descargue Cecil:

curl -OL https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar

Instalación

Ejecute la instalación de Cecil con el siguiente comando:

php cecil.phar new:site

Introduzca los elementos solicitados:

• el título de su sitio (title)
• la baseline
• URL de su sitio web (por ejemplo, https://mywebsite.ovh)
• una descripción del sitio web

Una vez que haya introducido estos elementos, deberá desplegar el sitio web con el siguiente comando:

php cecil.phar build

Si se muestra el contenido del directorio, se mostrará un directorio _site. Este directorio contendrá todos los archivos HTML y platos :

Ahora puede ver el resultado accediendo a su dominio :

Configuración del puntero del dominio o subdominio

Para ver el resultado de su sitio en su navegador, cambie el puntero del dominio o subdominio al directorio_sitio creado anteriormente durante la instalación de Cecil.

Si su nombre de dominio o subdominio está alojado en OVHcloud, consulte nuestros guías relacionados con la configuración DNS y la puesta en marcha de un sitio web en su alojamiento web.

Configurar su sitio

La información general de su sitio web puede configurarse en el archivo config.yml:

nano config.yml

Sustituya la información por defecto por su cuenta y guarde el archivo.

Crear una nueva página

Para crear las páginas que contengan los datos del sitio web, utilice archivos en formato Markdown. Estas páginas son personalizables. Cecil integra el motor de template Twig, que se utiliza por defecto con el framework Symfony.

Las carpetas y archivos están organizados de la siguiente forma:

• assets : contiene los widgets, audio y vídeo, los scripts JavaScript y los estilos (CSS, Sass)
• layouts : directorio en el que se debe usar el(los) templates
• páginas : lugar donde serán sus archivos Markdown
• _site : directorio que contiene los archivos generados y que está señalado por el dominio.
• static : todos los archivos estáticos de tipo PDF

Crear un archivo Markdown en línea de comandos

En la raíz del sitio, introduzca el siguiente comando:

php cecil.phar new:page mypage.md

En ese caso, se creará un archivo mypage.md en la raíz del directorio /pages.

Sustituya mypage por el nombre de su propia página.

Generar los archivos estáticos

También en la raíz, escriba la siguiente orden:

php cecil.phar build

Su archivo se encuentra en el directorio _site/mypage/:

Puede visualizarlo en su servidor escribiendo la URL de su sitio web, seguido de /mypage/:

Personalizar los archivos de su sitio web

Modificación del servidor

La edición de los archivos Markdown puede realizarse directamente en el servidor de alojamiento web. En su plan de hosting Performance, su acceso SSH permite utilizar indistintamente GNU nano, vi o vim. Las capturas de pantalla del presente tutorial se han realizado en GNU nano.

Edite el archivo mypage.md situado en el directorio pages introduciendo el siguiente comando si está en la raíz de su sitio :

 nano pages/mypage.md

Sustituya mypage por el nombre de su propia página.

Añada algunas líneas en la sintaxis Markdown:

Elimine los archivos de la caché utilizando el siguiente comando :

php cecil.phar clear

Reconstruya sus páginas tras guardar el archivo :

php cecil.phar build

A continuación, vuelva a su página para ver el resultado :

Modificación de su puesto de trabajo

Si prefiere utilizar su editor de código habitual, conéctese con un cliente FTP a su servidor para recuperar los archivos de su ordenador :

Ahora puede editar los archivos de su I.D.E.:

Solo tiene que volver a enviar sus archivos modificados o a los nuevos a su servidor y rebuilder para tener sus páginas en línea.

Añadir la página generada al menú del sitio web

Para añadir esta nueva página al menú del sitio web, edite manualmente el encabezado del archivo .md, añadiendo la siguiente línea:

menu: main

Conclusión

Cecil es una herramienta que permite construir eficazmente un sitio estático a partir de archivos Markdown, lenguaje de marcado más fácil de implementar que el HTML. La organización de los archivos Markdown condiciona la jerarquía de sus páginas web.
El uso de un motor de plantillas, muy utilizado en la comunidad de desarrolladores web, le permitirá encontrar fácilmente numerosas fuentes en Internet para diseñar una interfaz de apariencia profesional.

Más información

Añadir contenido dinámico a una página web estática generada con Cecil

El sitio oficial de la aplicación Cecil

Un guía sobre el formato de Markdown

Nuestra guía sobre el uso de FileZilla

Para servicios especializados (posicionamiento, desarrollo, etc.), contacte con partners de OVHcloud.

Interactúe con nuestra comunidad de usuarios.