--- title: "Tutoriel - Installation et configuration de Cecil, un générateur de sites statiques (SSG) en PHP" description: "Découvrez comment Cecil vous permet de créer votre site statique à l'aide d'un moteur de template moderne (Jamstack)" url: https://docs.ovhcloud.com/fr/guides/web-cloud/web-hosting/static-website-installation-cecil lang: fr lastUpdated: 2026-06-08 --- # Tutoriel - Installation et configuration de Cecil, un générateur de sites statiques (SSG) en PHP ## Objectif Ce tutoriel vous explique comment installer et configurer [Cecil](https://cecil.app/). Il s’agit d’une application écrite en PHP permettant de générer et d’administrer des pages web statiques. Un site web composé essentiellement de pages web statiques garantit un meilleur temps de chargement pour vos visiteurs et une plus grande sécurité. Sans contenu dynamique, vos pages sont plus robustes face aux attaques informatiques. La génération d’un site statique permet de disposer d’une liberté plus grande pour créer le site web de votre choix. Vous gagnerez également du temps puisque vous n’aurez pas à partir de zéro. **Découvrez comment Cecil vous permet de créer votre site statique à l’aide d’un moteur de template moderne (Jamstack).** ## Prérequis - Disposer d’une [offre d’hébergement web OVHcloud](https://www.ovhcloud.com/fr/web-hosting/) incluant un accès SSH. Cet accès permet d’installer en ligne de commande une ou plusieurs solutions alternatives à celles proposées par défaut dans nos offres d’hébergements web. - Être familiarisé à la saisie en ligne de commande. - Être en capacité de transférer des fichiers en FTP avec un client comme [FileZilla](/fr/guides/web-cloud/web-hosting/ftp-filezilla-user-guide.md). - Paramétrer votre zone DNS pour faire pointer votre nom de domaine (ou sous-domaine) vers votre hébergement web mutualisé. Cela s’avère notamment utile si vous souhaitez héberger plusieurs [sites web](/fr/guides/web-cloud/web-hosting/multisites-configure-multisite.md) sur votre hébergement web mutualisé. - Installer préalablement [Composer](https://getcomposer.org/) avec le fichier `composer.phar` à la racine de votre hébergement web mutualisé ou dans le dossier cible de votre nom de domaine. ## En pratique Un [hébergement web mutualisé](https://www.ovhcloud.com/fr/web-hosting/) permet de déclarer des domaines ou sous-domaines sur les sites web qu’ils contient. Un domaine ou un sous-domaine est nécessaire pour déployer votre site web réalisé avec **Cecil**. Pour vous aider à déclarer un domaine ou un sous-domaine sur l’un des sites web de votre hébergement, consultez notre page « [Partager son hébergement entre plusieurs sites](/fr/guides/web-cloud/web-hosting/multisites-configure-multisite.md) ». ### Créer le répertoire dans lequel seront vos fichiers Une fois connecté en SSH à votre hébergement web, créez un répertoire à la racine avec la commande suivante : ```sh mkdir mystaticwebsite ``` Remplacez `mystaticwebsite` par le nom de dossier de votre choix (sans accents et sans espaces). Allez ensuite dans ce répertoire: ```sh cd mystaticwebsite ``` Remplacez `mystaticwebsite` par votre nom de dossier. ### Téléchargement Dans le répertoire que vous venez de créer, téléchargez Cecil: ```sh curl -OL https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar ``` ### Installation Lancez l’installation de Cecil avec la commande suivante: ```sh php cecil.phar new:site ``` Renseignez les éléments demandés: - le titre de votre site _(title)_ - la _baseline_ - l’URL de votre site web (par exemple, `https://mywebsite.ovh`) - une description de votre site web ![Installation Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil01.png) Une fois ces éléments renseignés, vous devez maintenant déployer le site en tapant la commande suivante: ```sh php cecil.phar build ``` En affichant le contenu du répertoire, vous constaterez la présence d’un répertoire `_site`. Ce répertoire contiendra l’ensemble des fichiers HTML et des assets: ![Installation Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil02.png) Vous pouvez maintenant voir le résultat en vous rendant sur votre nom de domaine: ![Installation Cecil](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil03.png) #### Configuration du pointage du domaine ou sous-domaine Pour visualiser le résultat de votre site sur votre navigateur, modifiez le pointage de votre nom de domaine ou de sous-domaine dans le répertoire `_site` créé précédemment lors de l’installation de **Cecil**. Si votre nom de domaine ou sous-domaine est hébergé chez OVHcloud, consultez nos guides relatifs à la [configuration DNS](/fr/guides/web-cloud/domains/dns-zone-edit.md) et à la mise en place d’un [site web sur votre hébergement web](/fr/guides/web-cloud/web-hosting/multisites-configure-multisite.md). ### Configurer son site Les informations générales de votre site peuvent être configurées dans le fichier `config.yml`: ```sh nano config.yml ``` Remplacez les informations par défaut par les vôtres et sauvegardez le fichier. ![Fichier de configuration YAML](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil04.png) ### Créer une nouvelle page La création des pages qui contiendront les données de votre site se fait via des fichiers au format _Markdown_. Ces pages sont personnalisables. **Cecil** intègre le moteur de _template_ [Twig](https://twig.symfony.com/) qui est utilisé par défaut avec le _framework_ [Symfony](https://symfony.com/). Les dossiers et fichiers sont organisés comme suit: - `assets` : contient les éléments graphiques, audio et vidéo, les scripts JavaScript et les styles (CSS, Sass) - `layouts` : répertoire dans lequel seront le ou les _templates_ - `pages` : endroit où seront vos fichiers _Markdown_ - `_site` : répertoire qui contient les fichiers générés et qui est pointé par votre nom de domaine - `static` : tous les fichiers statiques de type PDF #### Créer un fichier _Markdown_ en ligne de commande À la racine du site, tapez la commande suivante: ```sh php cecil.phar new:page mypage.md ``` Un fichier `mypage.md` est alors créé à la racine du répertoire `/pages`. Remplacez `mypage` par le nom de votre propre page. ![Installation Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil05.png) #### Générer les fichiers statiques Toujours à la racine, tapez la commande suivante : ```sh php cecil.phar build ``` Votre fichier se trouve dans le répertoire `_site/mypage/`: ![Installation Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil06.png) Vous pouvez le visualiser sur votre serveur en tapant l’URL de votre site, suivi de `/mypage/`: ![Résultat navigateur](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil07.png) ### Personnaliser les fichiers de votre site #### Modification sur le serveur L’édition des fichiers _Markdown_ peut se faire directement sur le serveur d’hébergement web. Avec une offre d’[hébergement web OVHcloud](https://www.ovhcloud.com/fr/web-hosting/) disposant d’un accès SSH (**à partir de l’offre Pro**), vous pouvez utiliser indifféremment [GNU nano](https://nano-editor.org/), [vi](https://ex-vi.sourceforge.net/) ou [vim](https://www.vim.org/). Les captures d’écran du présent tutoriel ont été réalisées sous **GNU nano**. Éditez le fichier `mypage.md` situé dans le répertoire `pages` en tapant la commande suivante si vous êtes à la racine de votre site: ```sh nano pages/mypage.md ``` Remplacez `mypage` par le nom de votre propre page. ![Édition du fichier dans GNU nano](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil08.png) Ajoutez quelques lignes en respectant la syntaxe _Markdown_: ![Ajout de contenu dans le fichier](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil09.png) Supprimez les fichiers dans le cache à l’aide de la commande suivante: ```sh php cecil.phar clear ``` Reconstruisez vos pages après avoir sauvegardé votre fichier: ```sh php cecil.phar build ``` Puis retournez sur votre page pour voir le résultat: ![Page mise à jour](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil10.png) #### Modification sur votre poste de travail Si vous préférez utiliser votre éditeur de code habituel, connectez-vous avec un client FTP sur votre serveur pour récupérer les fichiers sur votre ordinateur: ![Téléchargement avec FileZilla](/images/assets/screens/other/web-tools/filezilla/cecil-folder.png) Vous pouvez maintenant éditer les fichiers dans votre I.D.E.: ![Affichage dans Visual Studio Code](/images/assets/screens/other/web-tools/vscode/static-website-installation-cecil12.png) Il vous suffit de renvoyer vos fichiers modifiés ou vos nouveaux fichiers sur votre serveur et de _rebuilder_ pour avoir vos pages en ligne. ### Ajouter la page générée au menu de votre site Pour ajouter cette nouvelle page dans le menu du site web, modifiez manuellement l’en-tête du fichier `.md` en rajoutant la ligne suivante: ```sh menu: main ``` ### Conclusion **Cecil** est un outil permettant de construire efficacement un site statique à partir de fichiers _Markdown_ , langage de balisage plus simple à mettre en œuvre que le HTML. L’organisation des fichiers Markdown conditionne la hiérarchie de vos pages web. L’utilisation d’un moteur de template, très utilisé dans la communauté des développeurs web, vous permettra de trouver facilement de nombreuses sources sur Internet pour concevoir une interface d’apparence professionnelle. ## Aller plus loin [Ajouter du contenu dynamique dans une page web statique générée avec Cecil](/fr/guides/web-cloud/web-hosting/static-website-installation-cecil-api-call.md) Le [site officiel de l’application Cecil](https://cecil.app/) Un [guide sur le format Markdown](https://www.markdownguide.org/) Notre [guide sur l’utilisation de FileZilla](/fr/guides/web-cloud/web-hosting/ftp-filezilla-user-guide.md) Pour des prestations spécialisées (référencement, développement, etc), contactez les [partenaires OVHcloud](https://partner.ovhcloud.com/fr/directory/). Échangez avec notre [communauté d’utilisateurs](https://community.ovhcloud.com/).