lauraviles / appcenter-docs Goto Github PK

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

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.

Launch the venv.sh script to prepare the virtualenv or to activate it:

$ source ./venv.sh

Compile the docs with the make-doc function:

$ make-doc apis
$ make-doc end-user
$ make-doc admin

Launch a local web server to view the compiled doc with the serve-doc function:

$ serve-doc apis
$ serve-doc end-user
$ serve-doc admin

Terminate the virtual env with deactivate command:

$ deactivate

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.