{ "version": "https://jsonfeed.org/version/1.1", "title": "Cecil - Bien démarrer", "home_page_url": "https://cecil.app/fr/documentation/bien-demarrer/", "feed_url": "https://cecil.app/fr/documentation/bien-demarrer/feed.json", "description": "Découvrez Cecil, créez votre premier site web en quelques minutes et comprenez l’organisation d’un projet.", "icon": "https://cecil.app/favicon.7ff4b89eec6dad139a7d2d6561543285.png", "favicon": "https://cecil.app/thumbnails/64x/favicon.7ff4b89eec6dad139a7d2d6561543285.png", "language": "fr", "items": [ { "id": "https://cecil.app/fr/documentation/bien-demarrer/installation/", "url": "https://cecil.app/fr/documentation/bien-demarrer/installation/", "title": "Installation", "summary": "Prérequis, méthodes d’installation (PHAR, gestionnaires de paquets, Composer), mise à jour et dépannage.", "date_published": "2026-10-05T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Installation\nCecil est distribué sous la forme d’un unique fichier exécutable, cecil.phar, qui fonctionne partout où PHP est installé.\nPrérequis\n\nPHP 8.3+\nExtensions PHP : fileinfo, gd et mbstring\n\nVérifiez votre version de PHP et les extensions chargées :\nphp -v\nphp -m\nExtensions optionnelles\n\n\n\nExtension\nUsage\n\n\n\n\nintl\nLocalisation des dates avec d’autres locales que en (améliore les performances sinon).\n\n\nimagick\nTraitement des images, préféré à GD si disponible.\n\n\nffi\nTraitement des images avec libvips (nécessite une installation via Composer).\n\n\n\nTélécharger le PHAR\nTéléchargez cecil.phar depuis votre terminal :\ncurl -LO https:\/\/cecil.app\/cecil.phar\nPuis exécutez-le avec PHP :\nphp cecil.phar --version\nVous pouvez également télécharger une version spécifique ou la version d’aperçu.\nInstallation globale\nInstaller Cecil globalement permet d’exécuter la commande cecil depuis n’importe quel dossier, au lieu de php cecil.phar.\nmacOS et Linux\nAvec Homebrew :\nbrew install cecilapp\/tap\/cecil\nOu manuellement, en déplaçant le PHAR dans un dossier de votre PATH :\nmv cecil.phar \/usr\/local\/bin\/cecil\nchmod +x \/usr\/local\/bin\/cecil\nWindows\nAvec Scoop :\nscoop install https:\/\/cecil.app\/scoop\/cecil.json\nOu manuellement :\n\nDéplacez cecil.phar dans un dossier dédié tel que C:\\bin\nRenommez cecil.phar en cecil\nAjoutez ;C:\\bin à votre variable d’environnement PATH\nCréez un « wrapping batch script » à côté\n\nPHIVE\nAvec PHIVE (The PHAR Installation and Verification Environment) :\nphive install cecil\nComposer\nAvec Composer :\ncomposer global require cecil\/cecil\nAssurez-vous que le dossier des binaires globaux de Composer est dans votre PATH. Exécutez composer global config bin-dir --absolute pour l’obtenir.\nPour utiliser Cecil comme dépendance d’un projet PHP, voir Bibliothèque.\nVérifier l’installation\ncecil --version\nExécutez cecil list pour afficher les commandes disponibles.\nMise à jour\nMettez à jour Cecil vers la dernière version selon votre méthode d’installation :\n# PHAR\nphp cecil.phar self-update\n# Homebrew\nbrew upgrade cecilapp\/tap\/cecil\n# Scoop\nscoop update cecil\n# PHIVE\nphive update cecil\n# Composer\ncomposer global update cecil\/cecil\nLa commande self-update (PHAR uniquement) accepte également les options suivantes :\n\n--rollback : revient à la version précédemment installée\n--stable : force la mise à jour vers la dernière version stable\n--preview : force la mise à jour vers la dernière version instable\n\nLe journal des modifications de chaque version est disponible sur GitHub.\nDépannage\ncommand not found: cecil\nLe dossier d’installation n’est pas dans votre PATH : ajoutez-le, ou exécutez Cecil avec php cecil.phar depuis le dossier contenant le PHAR.\nErreur de version ou d’extension PHP\nLe PHP utilisé en ligne de commande peut différer de celui attendu (plusieurs versions installées) : vérifiez-le avec php -v et php --ini, puis activez les extensions manquantes dans le fichier php.ini chargé.\nDiagnostiquer un site\nUne fois un site créé, exécutez la commande doctor pour diagnostiquer sa configuration.", "content_html": "

Installation

\n

Cecil est distribué sous la forme d’un unique fichier exécutable, cecil.phar, qui fonctionne partout où PHP est installé.

\n

Prérequis

\n

PHP 8.3+
Extensions PHP : fileinfo, gd et mbstring

\n

Vérifiez votre version de PHP et les extensions chargées :

\n

php -v\nphp -m

\n

Extensions optionnelles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Extension	Usage
`intl`	Localisation des dates avec d’autres locales que `en` (améliore les performances sinon).
`imagick`	Traitement des images, préféré à GD si disponible.
`ffi`	Traitement des images avec libvips (nécessite une installation via Composer).

\n

Télécharger le PHAR

\n

Téléchargez cecil.phar depuis votre terminal :

\n

curl -LO https://cecil.app/cecil.phar

\n

Puis exécutez-le avec PHP :

\n

php cecil.phar --version

\n\n

Installation globale

\n

Installer Cecil globalement permet d’exécuter la commande cecil depuis n’importe quel dossier, au lieu de php cecil.phar.

\n

macOS et Linux

\n

Avec Homebrew :

\n

brew install cecilapp/tap/cecil

\n

Ou manuellement, en déplaçant le PHAR dans un dossier de votre PATH :

\n

mv cecil.phar /usr/local/bin/cecil\nchmod +x /usr/local/bin/cecil

\n

Windows

\n

Avec Scoop :

\n

scoop install https://cecil.app/scoop/cecil.json

\n

Ou manuellement :

\n

Déplacez cecil.phar dans un dossier dédié tel que C:\\bin
Renommez cecil.phar en cecil
Ajoutez ;C:\\bin à votre variable d’environnement PATH
Créez un « wrapping batch script » à côté

\n

PHIVE

\n

Avec PHIVE (The PHAR Installation and Verification Environment) :

\n

phive install cecil

\n

Composer

\n

Avec Composer :

\n

composer global require cecil/cecil

\n\n\n

Vérifier l’installation

\n

cecil --version

\n\n

Mise à jour

\n

Mettez à jour Cecil vers la dernière version selon votre méthode d’installation :

\n

# PHAR\nphp cecil.phar self-update\n# Homebrew\nbrew upgrade cecilapp/tap/cecil\n# Scoop\nscoop update cecil\n# PHIVE\nphive update cecil\n# Composer\ncomposer global update cecil/cecil

\n

La commande self-update (PHAR uniquement) accepte également les options suivantes :

\n

--rollback : revient à la version précédemment installée
--stable : force la mise à jour vers la dernière version stable
--preview : force la mise à jour vers la dernière version instable

\n\n

Dépannage

\n

`command not found: cecil`

\n

Le dossier d’installation n’est pas dans votre PATH : ajoutez-le, ou exécutez Cecil avec php cecil.phar depuis le dossier contenant le PHAR.

\n

Erreur de version ou d’extension PHP

\n

Le PHP utilisé en ligne de commande peut différer de celui attendu (plusieurs versions installées) : vérifiez-le avec php -v et php --ini, puis activez les extensions manquantes dans le fichier php.ini chargé.

\n

Diagnostiquer un site

\n

Une fois un site créé, exécutez la commande doctor pour diagnostiquer sa configuration.

", "language": "fr" }, { "id": "https://cecil.app/fr/documentation/bien-demarrer/structure-des-dossiers/", "url": "https://cecil.app/fr/documentation/bien-demarrer/structure-des-dossiers/", "title": "Structure des dossiers", "summary": "Organisation des fichiers sources, arborescence du site généré et routage des fichiers vers les URL.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-03T00:00:00+00:00","content_text": "Structure des dossiers\nArborescence du système de fichiers\nOrganisation des fichiers du projet.\n<monsiteweb>\n├─ pages\n| ├─ blog <- Section\n| | ├─ billet-1.md <- Page dans Section\n| | └─ billet-2.md\n| ├─ projets\n| | └─ projet-a.md\n| └─ about.md <- Page racine\n├─ assets\n| ├─ styles.scss <- Fichier d'asset\n| └─ logo.png\n├─ static\n| └─ fichier.pdf <- Fichier statique\n└─ data\n └─ auteurs.yml <- Collection de données\nArborescence du site généré\nRésultat de la génération.\n<monsiteweb>\n└─ _site\n ├─ index.html <- Page d'accueil générée\n ├─ blog\/\n | ├─ index.html <- Liste des articles générée\n | ├─ billet-1\/index.html <- Article de blog\n | └─ billet-2\/index.html\n ├─ projets\/\n | ├─ index.html <- Liste des projets générée\n | └─ projet-a\/index.html <- Projet individuel\n ├─ about\/index.html <- Page \"À propos\"\n ├─ styles.css\n ├─ logo.png\n └─ fichier.pdf\nPar défaut, chaque page est générée sous la forme nomdufichier-sluglifié\/index.html pour obtenir une « belle » URL comme https:\/\/monsiteweb.tld\/section\/nomdufichier-sluglifié\/.\nPour obtenir une URL « ugly » (comme 404.html au lieu de 404\/), définissez uglyurl: true dans le front matter de la page.\nRoutage basé sur les fichiers\nLes fichiers Markdown du répertoire pages activent un routage basé sur les fichiers. Cela signifie que l’ajout, par exemple, de pages\/mon-projet\/projet-a.md le rendra accessible à l’URL \/projet-a dans votre navigateur.\nFichier :\n pages\/mon-projet\/projet-a.md\n └───── filepath ──────┘\nURL :\n ┌───── baseurl ─────┬─────── path ────────┐\n https:\/\/exemple.com\/mon-projet\/projet-a\/index.html\n └─ section ─┴─ slug ──┘\nDeux types de préfixes peuvent modifier l’URL, voir la section Préfixe de fichier ci-dessous.", "content_html": "

Structure des dossiers

\n

Arborescence du système de fichiers

\n

Organisation des fichiers du projet.

\n

<monsiteweb>\n├─ pages\n|  ├─ blog            <- Section\n|  |  ├─ billet-1.md  <- Page dans Section\n|  |  └─ billet-2.md\n|  ├─ projets\n|  |  └─ projet-a.md\n|  └─ about.md        <- Page racine\n├─ assets\n|  ├─ styles.scss     <- Fichier d'asset\n|  └─ logo.png\n├─ static\n|  └─ fichier.pdf     <- Fichier statique\n└─ data\n   └─ auteurs.yml     <- Collection de données

\n

Arborescence du site généré

\n

Résultat de la génération.

\n

<monsiteweb>\n└─ _site\n   ├─ index.html               <- Page d'accueil générée\n   ├─ blog/\n   |  ├─ index.html            <- Liste des articles générée\n   |  ├─ billet-1/index.html   <- Article de blog\n   |  └─ billet-2/index.html\n   ├─ projets/\n   |  ├─ index.html            <- Liste des projets générée\n   |  └─ projet-a/index.html   <- Projet individuel\n   ├─ about/index.html         <- Page \"À propos\"\n   ├─ styles.css\n   ├─ logo.png\n   └─ fichier.pdf

\n\n

Routage basé sur les fichiers

\n

Les fichiers Markdown du répertoire pages activent un routage basé sur les fichiers. Cela signifie que l’ajout, par exemple, de pages/mon-projet/projet-a.md le rendra accessible à l’URL /projet-a dans votre navigateur.

\n

Fichier :\n                   pages/mon-projet/projet-a.md\n                        └───── filepath ──────┘\nURL :\n    ┌───── baseurl ─────┬─────── path ────────┐\n     https://exemple.com/mon-projet/projet-a/index.html\n                        └─ section ─┴─ slug ──┘

\n", "language": "fr" }, { "id": "https://cecil.app/fr/documentation/bien-demarrer/demarrage-rapide/", "url": "https://cecil.app/fr/documentation/bien-demarrer/demarrage-rapide/", "title": "Démarrage rapide", "summary": "Installez Cecil, créez un site, ajoutez des pages, prévisualisez-le localement, puis générez-le et déployez-le.", "date_published": "2021-11-03T00:00:00+00:00", "date_modified": "2026-10-02T00:00:00+00:00","content_text": "Démarrage rapide\nCréer un site web\nVous pouvez créer un nouveau site web en quelques minutes.\nSuivez les étapes ci-dessous pour créer votre premier site web Cecil.\n\n\n\n\n\n\n\n\nDémo du résultat attendu : https:\/\/cecilapp.github.io\/skeleton\/.\nPrérequis\n\nPHP 8.3+\nTerminal (une compréhension de base du terminal)\nÉditeur de texte, comme VS Code et\/ou Typora\n\n1. Télécharger Cecil\nTéléchargez cecil.phar depuis votre terminal:\ncurl -LO https:\/\/cecil.app\/cecil.phar\nVous pouvez également télécharger Cecil manuellement, ou utiliser :\n\nHomebrew: brew install cecilapp\/tap\/cecil\nScoop: scoop install https:\/\/cecil.app\/scoop\/cecil.json\n\n2. Créer un nouveau site\nCréez un répertoire pour le site Web (ex : <monsiteweb>), placez y cecil.phar, puis exécutez la commande new:site :\nphp cecil.phar new:site\n3. Ajouter une page\nExécutez la commande new:page :\nphp cecil.phar new:page\nVous pouvez maintenant modifier la page nouvellement créée avec votre éditeur Markdown : <monsiteweb>\/pages\/<nouvelle-page>.md.\nNous vous recommandons d’utiliser Typora pour éditer vos fichiers Markdown.\n4. Vérifier l’aperçu\nExécutez la commande suivante pour créer un aperçu du site Web :\nphp cecil.phar serve\nNaviguez ensuite sur http:\/\/localhost:8000.\nLa commande serve démarre un serveur HTTP local et un observateur : si un fichier (une page, un template ou la config) est modifié, la page active du navigateur est automatiquement rechargée.\n5. Générer et déployer\nQuand vous êtes satisfait du résultat, vous pouvez générer le site afin de le déployer sur le Web.\nExécutez la commande suivante pour générer le site :\nphp cecil.phar build\nVous pouvez maintenant copier le contenu du répertoire _site sur un serveur Web 🎉\n", "content_html": "

Démarrage rapide

\n

Créer un site web

\n

Vous pouvez créer un nouveau site web en quelques minutes.

\n

Suivez les étapes ci-dessous pour créer votre premier site web Cecil.

\n

\n\n\n\n\n\n $\"Example$ \n

\n\n

Prérequis

\n

PHP 8.3+
Terminal (une compréhension de base du terminal)
Éditeur de texte, comme VS Code et/ou Typora

\n

1. Télécharger Cecil

\n

Téléchargez cecil.phar depuis votre terminal:

\n

curl -LO https://cecil.app/cecil.phar

\n

Vous pouvez également télécharger Cecil manuellement, ou utiliser :

\n

Homebrew: brew install cecilapp/tap/cecil
Scoop: scoop install https://cecil.app/scoop/cecil.json

\n

2. Créer un nouveau site

\n

Créez un répertoire pour le site Web (ex : <monsiteweb>), placez y cecil.phar, puis exécutez la commande new:site :

\n

php cecil.phar new:site

\n

3. Ajouter une page

\n

Exécutez la commande new:page :

\n

php cecil.phar new:page

\n

Vous pouvez maintenant modifier la page nouvellement créée avec votre éditeur Markdown : <monsiteweb>/pages/<nouvelle-page>.md.

\n\n

4. Vérifier l’aperçu

\n

Exécutez la commande suivante pour créer un aperçu du site Web :

\n

php cecil.phar serve

\n

Naviguez ensuite sur http://localhost:8000.

\n\n

5. Générer et déployer

\n

Quand vous êtes satisfait du résultat, vous pouvez générer le site afin de le déployer sur le Web.

\n

Exécutez la commande suivante pour générer le site :

\n

php cecil.phar build

\n

Vous pouvez maintenant copier le contenu du répertoire _site sur un serveur Web 🎉

\n

", "language": "fr" }, { "id": "https://cecil.app/fr/documentation/bien-demarrer/kits-de-demarrage/", "url": "https://cecil.app/fr/documentation/bien-demarrer/kits-de-demarrage/", "title": "Kits de démarrage", "summary": "Démarrez rapidement avec un modèle de projet prêt à l’emploi.", "date_published": "2021-11-03T00:00:00+00:00", "date_modified": "2026-10-02T00:00:00+00:00","content_text": "Kits de démarrage\nPour démarrer rapidement, utilisez l’un des kits de démarrage Cecil prêts à l’emploi :\n\nThe Butler : starter blog prêt à publier.\nLinks : alternative open source à Linktree.\nPhoto Stream : flux photo auto-hébergé minimaliste.\nStatidocs : site de documentation prêt à l’emploi.\n\n\n\n\n\n", "content_html": "

Kits de démarrage

\n

Pour démarrer rapidement, utilisez l’un des kits de démarrage Cecil prêts à l’emploi :

\n

The Butler : starter blog prêt à publier.
Links : alternative open source à Linktree.
Photo Stream : flux photo auto-hébergé minimaliste.
Statidocs : site de documentation prêt à l’emploi.

\n

\n\n\n $\"Exemple$ \n

", "language": "fr" } ] }