Skip to content
/ docs Public
forked from foundriesio/docs

FoundriesFactory and Linux microPlatform documentation source for https://docs.foundries.io

Notifications You must be signed in to change notification settings

angolini/docs

 
 

Repository files navigation

docs

microPlatform documentation source for https://docs.foundries.io

Requirements

In order to build documentation at a minimum we require that both python3 and pip for python3 are installed. All of the required python modules are described in the requirements.txt file in this directory and can be installed with the command pip install -r requirements.txt.

The following is the list of packages needed (can be incomplete):

Package
sphinx
sphinx-rtd-theme
sphinx-tabs
sphinxemoji
sphinx_copybutton
sphinxcontrib.asciinema
sphinxcontrib-contentui
sphinx_toolbox
sphinx-prompt

Using virtualenv to provide requirements

The recommended way to build documentation, in order to avoid messing with the global system-wide package storage, is to use virtualenv to set up the necessary environment for sphinx packages:

$ sudo apt-get install python3 python3-virtualenv
$ virtualenv -p /usr/bin/python3 venv
$ . ./venv/bin/activate
$ pip install -r requirements.txt

Build the docs

To build html docs from rst files just run:

$ make html

And open with build/html/index.html in your browser.

About

FoundriesFactory and Linux microPlatform documentation source for https://docs.foundries.io

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 57.1%
  • Shell 19.8%
  • CSS 7.0%
  • C++ 6.7%
  • Makefile 6.0%
  • HTML 2.5%
  • Dockerfile 0.9%