--- title: "Tutorial - Instalación y configuración de Cecil, un generador de sitios estáticos (SSG) en PHP" description: "Descubra cómo Cecil le permite crear su sitio estático con un motor de plantillas moderno (Jamstack)" url: https://docs.ovhcloud.com/es/guides/web-cloud/web-hosting/static-website-installation-cecil lang: es lastUpdated: 2026-06-08 --- # 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](https://cecil.app/). 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](https://www.ovhcloud.com/es-es/web-hosting/) 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](/es/guides/web-cloud/web-hosting/ftp-filezilla-user-guide.md). - 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](/es/guides/web-cloud/web-hosting/multisites-configure-multisite.md) en su alojamiento web compartido. - Instalar previamente [Componer](https://getcomposer.org/) 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](https://www.ovhcloud.com/es-es/web-hosting/) 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](/es/guides/web-cloud/web-hosting/multisites-configure-multisite.md) ». ### 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: ```sh mkdir mystaticwebsite ``` Sustituya `mystaticwebsite` por el nombre de la carpeta que desee (sin acentos y sin espacios). A continuación, acceda al directorio: ```sh cd mystaticwebsite ``` Sustituya `mystaticwebsite` por su nombre de carpeta. ### Descarga En el directorio que acaba de crear, descargue Cecil: ```sh curl -OL https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar ``` ### Instalación Ejecute la instalación de Cecil con el siguiente comando: ```sh 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 ![Instalación Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil01.png) Una vez que haya introducido estos elementos, deberá desplegar el sitio web con el siguiente comando: ```sh 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 : ![Instalación Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil02.png) Ahora puede ver el resultado accediendo a su dominio : ![Instalación Cecil](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil03.png) #### 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](/es/guides/web-cloud/domains/dns-zone-edit.md) y la puesta en marcha de un [sitio web en su alojamiento web](/es/guides/web-cloud/web-hosting/multisites-configure-multisite.md). ### Configurar su sitio La información general de su sitio web puede configurarse en el archivo `config.yml`: ```sh nano config.yml ``` Sustituya la información por defecto por su cuenta y guarde el archivo. ![Archivo de configuración YAML](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil04.png) ### 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](https://twig.symfony.com/), que se utiliza por defecto con el _framework_ [Symfony](https://symfony.com/). 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: ```sh 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. ![Instalación Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil05.png) #### Generar los archivos estáticos También en la raíz, escriba la siguiente orden: ```sh php cecil.phar build ``` Su archivo se encuentra en el directorio `_site/mypage/`: ![Instalación Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil06.png) Puede visualizarlo en su servidor escribiendo la URL de su sitio web, seguido de `/mypage/`: ![Resultado del navegador](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil07.png) ### 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. Con un [plan de hosting OVHcloud](https://www.ovhcloud.com/es-es/web-hosting/) que incluya acceso SSH (**a partir del plan Pro**), puede utilizar indistintamente [GNU nano](https://nano-editor.org/), [vi](https://ex-vi.sourceforge.net/) o [vim](https://www.vim.org/). 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 : ```sh nano pages/mypage.md ``` Sustituya `mypage` por el nombre de su propia página. ![Edición del archivo en GNU nano](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil08.png) Añada algunas líneas en la sintaxis _Markdown_: ![Añadir contenido al archivo](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil09.png) Elimine los archivos de la caché utilizando el siguiente comando : ```sh php cecil.phar clear ``` Reconstruya sus páginas tras guardar el archivo : ```sh php cecil.phar build ``` A continuación, vuelva a su página para ver el resultado : ![Página actualizada](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil10.png) #### 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 : ![Descargando con FileZilla](/images/assets/screens/other/web-tools/filezilla/cecil-folder.png) Ahora puede editar los archivos de su I.D.E.: ![Ver en Visual Studio Code](/images/assets/screens/other/web-tools/vscode/static-website-installation-cecil12.png) 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: ```sh 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](/es/guides/web-cloud/web-hosting/static-website-installation-cecil-api-call.md) El [sitio oficial de la aplicación Cecil](https://cecil.app/) Un [guía sobre el formato de Markdown](https://www.markdownguide.org/) Nuestra [guía sobre el uso de FileZilla](/es/guides/web-cloud/web-hosting/ftp-filezilla-user-guide.md) Para servicios especializados (posicionamiento, desarrollo, etc.), contacte con [partners de OVHcloud](https://partner.ovhcloud.com/es-es/directory/). Interactúe con nuestra [comunidad de usuarios](https://community.ovhcloud.com/).