Contributions to this documentation are welcome. Documentation is written in reStructured Text (rST). A quick rST reference can be found here. Builds are powered by Sphinx and are hosted by ReadTheDocs.
Fork, clone, install¶
First, fork the COSDev repo, clone it, and install the requirements (requires Python 2.7 or 3.4 with pip):
# After forking CenterForOpenScience/COSDev $ git clone https://github.com/<your_github_username>/COSDev.git $ cd COSDev $ pip install -r requirements.txt
Be sure to replace
<your_github_username> with your Github username.
Build the docs¶
To build docs:
$ invoke docs -b
-b (for “browse”) automatically opens up the docs in your browser after building. Alternatively, you can open up the
docs/_build/index.html file manually.
Autobuilding on File Changes¶
You can use
sphinx-autobuild to automatically build the docs when you change a file in the
$ pip install sphinx-autobuild
You can now start the livereload server with:
$ invoke watch
Point your browser to http://localhost:8000 to see your docs.
Use the following underlining conventions for heading levels: