Home

Uyuni Documentation Wiki

Table of Contents

• Welcome!
• For contributors
• Setup Toolchain

Welcome!

This is the official wiki for Uyuni and SUSE Manager documentation. Use the sidebar for common tasks.

For contributors

Writing process and tools

1. Setup Toolchain

2. Build the docs!

Additional Resources

• Getting started with Asciidoc

• Our writing and word usage guide

Setup Toolchain

Procedure: Setup The Toolchain

1. Setup rbenv and Ruby

   Easily manage your Ruby versions and gems with rbenv

2. Install NVM

   Easily manage your node package versions with the Node Version Manager.

3. Install Antora

   Upstream tool for generating our static HTML documentation pages.

4. Install Asciidoctor Gems

   Upstream gems for our adoc and pdf outputs.

5. Install po4a

   We use po4a to convert docs to gettext and back for translation.

6. How to Build Docs

   How to build our docs, tips and some gotchas.

7. Optional Tools