Skip to content
Tuleap documentation in reStructuredText format, built with Sphinx
CSS HTML JavaScript Python Makefile Dockerfile
Branch: master
Clone or download
nterray and vaceletm Initiate taskboard documentation (#253)
Taskboard should be referenced in the user documentation.
Latest commit 4993636 Jan 28, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_build
docs.tuleap.org
languages/en
tmp
.gitignore
.travis.yml
Dockerfile-linkcheck
Jenkinsfile-build-docs.tuleap.org
Jenkinsfile-linkcheck
LICENSE
Makefile
README.md
package-lock.json
package.json
requirements-dev.txt
requirements.txt
webpack.common.js
webpack.dev.js
webpack.prod.js

README.md

Tuleap Documentation

Tuleap uses Sphinx in order to generate its documentation.

Download the sources from GitHub

git clone git@github.com: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:

npm ci
npm run build
source venv/bin/activate
make SPHINXOPTS="-D html_theme=tuleap_org" html
deactivate

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

npm ci
npm run build
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.

You can’t perform that action at this time.