Antora CLI
The command line interface (CLI) for Antora.
This package provides the antora command (i.e., bin script) to run Antora.
It does not include the site generator, which must be installed separately.
Antora is a modular static site generator designed for creating documentation sites from AsciiDoc documents. Its site generator aggregates documents from versioned content repositories and processes them using Asciidoctor.
To run Antora, you need both the CLI and a site generator.
Once these packages are installed, you can use the antora command to generate your site.
How to Install
Let’s start by installing the CLI.
npm i -g @antora/cli
This package adds the antora command to your PATH.
You can check by running:
antora -v
Next, install a site generator. The site generator provided by Antora will be sufficient for most users.
npm i -g @antora/site-generator
The antora command (specifically the implicit generate subcommand) will look for this package by default.
How to Use
To run Antora, you’ll need a playbook file and at least one content (source) repository. Consult the quickstart to find an example.
Once you have your content sources set up, point the antora command at your playbook file:
antora antora-playbook.yml
The antora command will output the generated site to the build/site folder by default.
Copyright and License
Copyright (C) 2017-present OpenDevise Inc. and the Antora Project.
Use of this software is granted under the terms of the Mozilla Public License Version 2.0 (MPL-2.0).