Table of contents

Commands

  • build: Build the website
  • clean: Remove the output directory
  • config: Print configuration
  • help: Get help for individual commands
  • list: List content
  • new: Create a new content
  • newsite: Create a new website
  • self-update: Update Cecil to the latest version
  • serve: Start the built-in web server
  • version: Display the version of the script

newsite

Create a new website in the current directory, or in <path> if provided.

Usage:
 newsite [<path>] [--force|-f]

Arguments:
 <path>      Path to the Website
 --force|-f  Override the directory if already exist

new

Create a new content file (with a default title and current date).

Usage:
 new <name> [<path>] [--force|-f] [--open|-o]

Arguments:
 <name>      Page name
 <path>      Path to the Website
 --force|-f  Override the file if already exist
 --open|-o   Open editor automatically

Use editor configuration key to define your default editor (ie: editor: typora).

build

Build the website in the output directory.

Usage:
 build [<path>] [--drafts|-d] [--verbose|-v] [--quiet|-q] [--baseurl=] [--destination=] [--dry-run]

Arguments:
 <path>         Path to the Website
 --drafts|-d    Include drafts
 --verbose|-v   Print build details
 --quiet|-q     Disable build messages
 --baseurl      Set the base URL
 --destination  Set the output directory
 --dry-run      Build without saving

serve

Start the live-reloading-built-in web server.

Usage:
 serve [<path>] [--drafts|-d] [--open|-o] [--no-watcher|-nw] [--host=] [--port=]

Arguments:
 <path>            Path to the Website
 --drafts|-d       Include drafts
 --open|-o         Open browser automatically
 --no-watcher|-nw  Disable watcher
 --host            Server host
 --port            Server port

Suggest a modification

Configuration Publish