Skip to content

Command line interface

Apart from the fact that zensical replaces mkdocs on the command line, there are some key differences. Make sure to review these and update your build and CI scripts accordingly. Refer to the command line interface page in our documentation for further details.

  • build and serve commands:

    • Zensical's differential architecture produces consistent build outputs, which is why we are changing the default for the --clean (-c) option to false.

    • The --theme (-t) option is not supported, and we currently only offer a single theme, though this will change once we start working on the module system.

    • The --use-directory-urls and --no-directory-urls options are not supported. Set use_directory_urls in your configuration file instead, exactly as in MkDocs.

    • --strict mode is currently ignored, but we're working on adding proper validation of configuration options and links between pages, gracefully failing the build.

  • serve command: the --dirty command-line option is unnecessary, and thus ignored, since Zensical ensures performance through differential builds which yield the same result as a full build from scratch.

  • gh-deploy command: we plan to support many more deployment methods, so we're not implementing MkDocs' gh-deploy command. See our publishing your site documentation for alternatives.

  • get-deps command: this command is not supported. Instead, we recommend declaring explicit dependencies in the pyproject.toml file, as per standard Python development practices.