The command line¶

After installing Betty via pip or from source, the betty command is available:

Usage: betty [OPTIONS] COMMAND [ARGS]...

Options:
  -c, --configuration TEXT  The path to a Betty project configuration file.
                            Defaults to betty.json|yaml|yml in the current
                            working directory. This will make additional
                            commands available.
  -v, --verbose             Show verbose output, including informative log
                            messages.
  -vv, --more-verbose       Show more verbose output, including debug log
                            messages.
  -vvv, --most-verbose      Show most verbose output, including all log
                            messages.
  --version                 Show the version and exit.
  --help                    Show this message and exit.

Commands:
  docs                 View the documentation.
  clear-caches         Clear all caches.
  demo                 Explore a demonstration site.
  gui                  Open Betty's graphical user interface (GUI).
  init-translation     Initialize a new translation
  update-translations  Update all existing translations
  generate             Generate a static site.
  serve                Serve a generated site.
  serve-nginx-docker   Serve a generated site with nginx in a Docker...

Generally you will be using Betty for a specific site. When you call betty with a configuration file (e.g. betty -c betty.yaml), additional commands provided by the extensions enabled in the configuration file may become available.