UForge AppCenter Documentation

This directory contains the source for UForge AppCenter online documentation. This uses Sphinx to build static html files from these source files.

Building locally

Install Sphinx

$ pip install sphinx

Install rst2pdf. This allows users to build pdfs on Windows machines (on Mac or Linux use latex to create pdfs of this documentation).

$ pip install rst2pdf

Install read the docs theme:

$ pip install sphinx_rtd_theme

Build the docs and open them in your browser:

$ cd uforge-appcenter
$ make html

The html files are in the build directory for each sub-project, for example, the end user guide:

$ open uforge-appcenter/build/html/index.html

You can also build each guide individually, note though the end user guide and admin guide depend on the API guide.

Contributions Welcome!

If you find a typo or you feel like you can improve the content of the documentation, we welcome contributions and comments. Feel free to open issues or pull requests like any normal GitHub project.