Name: im-docs
Owner: InterMine
Description: Documentation for the InterMine project
Created: 2012-11-08 15:56:28.0
Updated: 2016-11-16 13:52:57.0
Pushed: 2018-01-12 10:07:07.0
Homepage: https://intermine.readthedocs.org
Size: 3939
Language: Perl
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Documentation for the InterMine project.
The HTML documentation is generated from RST source, using a Python static site generator called Sphinx. RST stands for reStructuredText (see reference). When you push to the GitHub repo for these docs, this triggers a new build of the documentation site, where the changes will be visible within a few minutes. This process is managed by ReadTheDocs, an online service for maintaining documentation.
You should build locally before you push, to make sure your changes are correct. You will need the Sphinx environment for this. Make and Python are required, and we recommend using virtualenv to manage dependencies:
Setting up:
ocs
ualenv .
ce ./bin/activate
install -r requirements.txt
Building the docs:
the docs directory
html
The source for the Sphinx documentation theme can be found in the intermine/design-materials repo.