Skip to content
book-open

GitHub Action

Antora Site

v0.2.4 Latest version

Antora Site

book-open

Antora Site

Generate the Antora site

Installation

Copy and paste the following snippet into your .yml file.

              
- name: Antora Site

              
  uses: kameshsampath/[email protected]
Learn more about this action in kameshsampath/antora-site-action

Choose a version

Antora Site GitHub Action

GitHub action that can be used to generate the Antora site.

It supports as opt-in the Lunr index generator for documentation search.

Parameters

The action accepts the following parameters:

  • antora_playbook — that specifies the Antora playbook path within the repository

  • site_sources_path — the path within $GITHUB_WORKSPACE from where to run the site generation

  • antora_generator — Select antora generator for site

  • antora_docsearch_enabled — Flag for enabling antora docsearch

  • antora_docsearch_index_version — Select the document version to be indexed

How to add to your action

name: "Generate site using antora site action"
uses: kameshsampath/[email protected]
with:
    antora_playbook: antora-playbook.yml
    # optional path within the repo, defaults to ${{github.workspace}}
    site_sources_path: 'site-sources-folder'

A complete example is available here.

How to add to your action for Lunr documentation search index

name: "Generate site and doc search index using antora site action"
uses: kameshsampath/[email protected]
with:
    antora_playbook: antora-playbook.yml
    # optional path within the repo, defaults to ${{github.workspace}}
    site_sources_path: 'site-sources-folder'
    antora_generator: 'antora-site-generator-lunr'
    antora_docsearch_enabled: 'true'

A complete example using Lunr is available here.