Skip to content

honkit-build-page

Actions
A composite action for building your book website pages using Honkit
v2
Latest
Star (2)

Honkit Build Page GitHub Action

This GitHub Action automates the process of building a Honkit documentation site from source code.

Usage

To use this GitHub Action, follow these steps:

1. Add this Action to your Workflow

- name: Build Pages
  uses: FriesI23/honkit-build-page@v2

or

- name: Build Pages
  uses: FriesI23/honkit-build-page@<version>
  with:
    nodejs-version: <overwrite node.js version>
    output-sitedir: <custom output dir>
    working-directory: <build path>

A specific usage example can be explored in .github/workflows/build-ghpage.yml.

2. Enable GitHub Pages

Navigate to "<your-repo-page> -> Settings -> Pages -> GitHub Pages -> Build and deployment", switch "source" to "GitHub Actions".

Enbale GitHub Pages

3. Commit and Push

Commit the workflow file to your repo and push it to GitHub.

Inputs

Input Description
nodejs-version Node.js version required for building pages
output-sitedir Final directory where the book site is stored
working-directory The working directory for this action

See Action file to view the complete params.

Acknowledgements

This Action was inspired by the need to simplify the process of building Honkit documentation sites.

License

This project is licensed under MIT License.

honkit-build-page is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

A composite action for building your book website pages using Honkit
v2
Latest

honkit-build-page is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.