Skip to content
This repository has been archived by the owner on Feb 14, 2023. It is now read-only.

Github action for building documentation using a Docker image

License

Notifications You must be signed in to change notification settings

Consensys/doctools.action-builder

Repository files navigation

Build and publish Docker image

Consensys Doctools Github action and Docker image

Consensys Doctools suite provides the required software to write, build, test and publish Consensys branded and homogeneous documentation.

Github Action

The Github actions hosted in the repository provides a way to build and publish static documentation site using the common template.

Example usage

See Github Actions Workflow on the Template doc site repository.

doctools Docker image

The Doctools Docker image is built from this repository and is used in the Github Actions.

The image is hosted on Consensys Github Container Registry (ghcr).

It is also made to ease doc preview and local development. Documentation contributors do not have to install and configure Python, Node.Js and other tools locally to preview and test their doc work. Docker is the only required tool.

Using the Docker Image also enables to ensure that it will build everywhere in the same way. What you build locally will be exactly the same in the final hosted site.

Using the Docker image for doc site preview

See Doctools preview documentation

Using the Docker image for template development

See Doctools developer documentation