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
Documentation Build Process
Joseph Cayouette edited this page Feb 14, 2017
·
1 revision
elcome to the doc-susemanager wiki!
Use the package(s) from Documentation:Tools
, not the one(s) from openSUSE 13.x or Leap 42.x !
For Tumbleweed users (adapt accordingly if you're not running Tumbleweed)
sudo zypper ar http://download.opensuse.org/repositories/Documentation:/Tools/openSUSE_Tumbleweed doc
sudo zypper in daps
sudo zypper in xerces-j2
sudo zypper in jing
daps -d DC-create-suma3-quickstart html
If you get
ERROR: Could not determine the DocBook stylesheet location by resolving "http://docbook.sourceforge.net/release/xsl-ns/current/" via xmlcatalog
then
sudo zypper in docbook_5 docbook5-xsl-stylesheets
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