This repository has been archived by the owner on Apr 12, 2022. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 34
building documentation
Joseph Cayouette edited this page Aug 8, 2019
·
21 revisions
Table of Contents
- Assumptions
-
-
You have followed the steps to setup our toolchain
-
You have cloned the doc-susemanager repository
-
Procedure: Building SUMA Docs
-
From your local git checkout run the following command to see all available build options:
make help
-
To build the suma static HTML pages and PDF documents run:
make antora-suma
Procedure: Building UYUNI Docs
-
From your local git checkout run the following command to see all available build options:
make help
-
To build the Uyuni static HTML pages and PDF documents run:
make antora-uyuni
Setup and Build
- Setup rbenv and Ruby
- Install nvm
- Install Antora
- Install Asciidoctor Gems
- Building the Docs
- Optional Tools
How to Publish
Publish to OBS
Publish Enterprise Docs
Publishing to Github Pages
Want to Help?
Get Started with Asciidoc
Quick Syntax Reference
Asciidoctor Writer's Guide
Asciidoctor User's Manual
Resources
YAML Documentation