Logo de Cecil Cecil
Sur cette page

new:site

Crée un nouveau site.

Utilisation

Description:
  Creates a new website

Usage:
  new:site [options] [--] [<path>]

Arguments:
  path                  Use the given path as working directory

Options:
  -f, --force           Override directory if it already exists
      --demo            Add demo content (pages, templates and assets)
  -h, --help            Display help for the given command. When no command is given display help for the list command
      --silent          Do not output any message
  -q, --quiet           Only errors are displayed. All other output is suppressed
  -V, --version         Display this application version
      --ansi|--no-ansi  Force (or disable --no-ansi) ANSI output
  -n, --no-interaction  Do not ask any interactive question
  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Help:
  The new:site command creates a new website in the current directory, or in <path> if provided.
  If you run this command without any options, it will ask you for the website title, baseline, base URL, description, author, language, etc.

    cecil.phar new:site
    cecil.phar new:site path/to/the/working/directory

  To create a new website with demo content, run:

    cecil.phar new:site --demo

  To override an existing website, run:

    cecil.phar new:site --force

Fichiers créés

La commande crée les fichiers suivants :

  • cecil.yml : la configuration, avec des exemples commentés des options courantes
  • pages/index.md : la page d'accueil
  • assets/favicon.png et assets/icon.png : le favicon et l'image par défaut des cartes des réseaux sociaux
  • static/favicon.ico : le favicon historique
  • README.md et .gitignore (_site/, .cache/ et .cecil/), s'ils n'existent pas déjà
  • .github/workflows/build-and-deploy.yml : un workflow GitHub Actions pour déployer sur GitHub Pages, si demandé

Avec l'option --demo, elle ajoute aussi du contenu de démonstration : un blog (avec tags, pagination, un brouillon et une traduction en français), une section de documentation (triée par poids, avec une table des matières activée par cascade), des templates personnalisés, une feuille de style Sass, un fichier de données et des traductions.