Skip to content

Tuleap documentation in reStructuredText format, built with Sphinx

License

Notifications You must be signed in to change notification settings

vhemery/tuleap-documentation-en

 
 

Repository files navigation

Tuleap Documentation

Tuleap uses Sphinx in order to generate its documentation.

Download the sources from GitHub

git clone [email protected]:Enalean/tuleap-documentation-en.git
cd tuleap-documentation-en/

Set-up your environment

virtualenv venv
source venv/bin/activate
pip install -r requirements.txt -r requirements-dev.txt
deactivate

Build the documentation

source venv/bin/activate
make html
deactivate

The documentation is generated in tuleap-documentation-en/_build/html/en/ You can check the modifications by opening index.html with your web browser. You need to build the documentation in order to see your modifications.

To build documentation for tuleap.org:

source venv/bin/activate
make SPHINXOPTS="-D html_theme=tuleap_org" html
deactivate

To add a Google Analytics snippet, use the following theme options:

source venv/bin/activate
make SPHINXOPTS="-D html_theme=tuleap_org -D html_theme_options.ga_id=UA-XXXXXXXX-Y -D html_theme_options.ga_content_group_index=YYYYYYYYYYY -D html_theme_options.ga_content_group_name=WWWWWWWW" html
deactivate

To build the documentation in watch mode:

source venv/bin/activate
make SPHINXOPTS="-D html_theme=tuleap_org" watch-html
deactivate

A web-server will start, the modifies pages will be rebuilt and reloaded automatically each time you save your work.

Modify/ add to the documentation

cd tuleap-documentation-en/languages/en/

There will be a few main folders in here which correspond to documentation sections. To add a new page, create the file in the correct directory then add the reference in index.rst.

Note: All changes must be pushed on the master branch.

License

Tuleap and its documentation are licensed under GPLv2 or above.

About

Tuleap documentation in reStructuredText format, built with Sphinx

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 44.8%
  • Python 23.7%
  • JavaScript 23.4%
  • Makefile 5.9%
  • Dockerfile 2.2%