Get the Site Playbook Project

The Docs Site playbook project contains the:

  • staging playbook

  • production playbook

  • site extensions

  • Home docs component

To generate the documentation site on your device, you need its playbook. The playbook provides the site configuration to Antora.

Fork and Clone the Playbook Project

Go to Build the Docs Site if you’ve previously forked and cloned the Docs Site repository. You’ve already completed the steps on this page.
  1. Go to the Docs Site repository on GitHub and click Fork.

  2. Create or select the local folder where you want to store the repository on your device.

  3. Open a terminal and change into the selected folder.

    $ cd path/to/folder
  4. Go to your repository on GitHub, and click Clone or download.

  5. Click the Clipboard icon to copy the repository’s Git URL.

  6. In your terminal type git clone, paste the copied URL, and press Enter.

    $ git clone git@github.com:this-is-you/docs-site.git
  7. Change into the repository folder created by the clone operation.

    $ cd docs-site

Sync with the Upstream Repository

You need to connect your local repository to the upstream repository so you can use the latest playbooks and extensions.

  1. Go to the upstream Docs Site repository and click Clone or download.

  2. Click the Clipboard icon to copy the repository’s Git URL.

  3. In your terminal type git remote add upstream, paste the copied URL, and press Enter.

Now you’re ready to run Antora and build the documentation site on your device.