Tutoriel - Installation et configuration de Cecil, un générateur de sites statiques (SSG) en PHP
Découvrez comment Cecil vous permet de créer votre site statique à l'aide d'un moteur de template moderne (Jamstack)
Découvrez comment Cecil vous permet de créer votre site statique à l'aide d'un moteur de template moderne (Jamstack)
Dernière mise à jour le 16/01/2023
Ce tutoriel vous explique comment installer et configurer Cecil. 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).
composer.pharà la racine de votre hébergement web mutualisé ou dans le dossier cible de votre nom de domaine.
Les hébergements web mutualisés permettent de déclarer des domaines ou sous-domaines en multisites. 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 en multisite sur votre hébergement, consultez notre page « Partager son hébergement entre plusieurs sites ».
Une fois connecté en SSH à votre hébergement web, créez un répertoire à la racine avec la commande suivante :
mkdir mystaticwebsite
Remplacez
mystaticwebsite par le nom de dossier de votre choix (sans accents et sans espaces).
Allez ensuite dans ce répertoire:
cd mystaticwebsite
Remplacez
mystaticwebsite par votre nom de dossier.
Dans le répertoire que vous venez de créer, téléchargez Cecil:
curl -OL https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar
Lancez l'installation de Cecil avec la commande suivante:
php cecil.phar new:site
Renseignez les éléments demandés:
https://mywebsite.ovh)
Une fois ces éléments renseignés, vous devez maintenant déployer le site en tapant la commande suivante:
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:
Vous pouvez maintenant voir le résultat en vous rendant sur votre nom de 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.
Les informations générales de votre site peuvent être configurées dans le fichier
config.yml:
nano config.yml
Remplacez les informations par défaut par les vôtres et sauvegardez le fichier.
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 qui est utilisé par défaut avec le framework Symfony.
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
À la racine du site, tapez la commande suivante:
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.
Toujours à la racine, tapez la commande suivante :
php cecil.phar build
Votre fichier se trouve dans le répertoire
_site/mypage/:
Vous pouvez le visualiser sur votre serveur en tapant l'URL de votre site, suivi de
/mypage/:
L'édition des fichiers Markdown peut se faire directement sur le serveur d'hébergement web. Sur votre offre d'hébergement Performance, votre accès SSH pour permet d'utiliser indifféremment GNU nano, vi ou vim. 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:
nano pages/mypage.md
Remplacez
mypage par le nom de votre propre page.
Ajoutez quelques lignes en respectant la syntaxe Markdown:
Supprimez les fichiers dans le cache à l'aide de la commande suivante:
php cecil.phar clear
Reconstruisez vos pages après avoir sauvegardé votre fichier:
php cecil.phar build
Puis retournez sur votre page pour voir le résultat:
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:
Vous pouvez maintenant éditer les fichiers dans votre I.D.E.:
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.
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:
menu: main
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.
N'hésitez pas à nous proposer des suggestions d'amélioration afin de faire évoluer cette documentation.
Images, contenu, structure… N'hésitez pas à nous dire pourquoi afin de la faire évoluer ensemble !
Vos demandes d'assistance ne seront pas traitées par ce formulaire. Pour cela, utilisez le formulaire "Créer un ticket" .
Merci beaucoup pour votre aide ! Vos retours seront étudiés au plus vite par nos équipes..
Accedez à votre espace communautaire. Posez des questions, recherchez des informations, publiez du contenu et interagissez avec d'autres membres d'OVHcloud Community.Echanger sur OVHcloud Community