Tool for building restructured text documentation for projects with scripts in many languages
Project description
sphinx-script Script Documentation Module
=========================================
[](https://travis-ci.org/ClimateImpactLab/sphinxscript)
[](https://pypi.python.org/pypi/sphinxscript)
[](https://coveralls.io/github/ClimateImpactLab/sphinxscript)
Produced by the [Climate Impact Lab](http://impactlab.org)
Overview
--------
Tool for building restructured text documentation for projects with scripts in many languages
Installation
------------
To install use pip:
$ pip install sphinxscript
Or clone the repo:
$ git clone https://github.com/ClimateImpactLab/sphinxscript.git
$ python setup.py install
Usage
-----
Set up your repository using sphinx. Near the top of the `conf.py` configuration
file, place the following lines:
import sphinxscript
sphinxscript.build_docs()
Finally, in your sphinx index file `index.rst`, include the following:
.. toctree::
sphinxscript
Using Sphinx-script with ReadTheDocs
------------------------------------
Include `sphinxscript` in the file `requirements.txt` in your root project
directory. Then follow the usage steps above.
Contributing
------------
TBD
Example
-------
TBD
=========================================
[](https://travis-ci.org/ClimateImpactLab/sphinxscript)
[](https://pypi.python.org/pypi/sphinxscript)
[](https://coveralls.io/github/ClimateImpactLab/sphinxscript)
Produced by the [Climate Impact Lab](http://impactlab.org)
Overview
--------
Tool for building restructured text documentation for projects with scripts in many languages
Installation
------------
To install use pip:
$ pip install sphinxscript
Or clone the repo:
$ git clone https://github.com/ClimateImpactLab/sphinxscript.git
$ python setup.py install
Usage
-----
Set up your repository using sphinx. Near the top of the `conf.py` configuration
file, place the following lines:
import sphinxscript
sphinxscript.build_docs()
Finally, in your sphinx index file `index.rst`, include the following:
.. toctree::
sphinxscript
Using Sphinx-script with ReadTheDocs
------------------------------------
Include `sphinxscript` in the file `requirements.txt` in your root project
directory. Then follow the usage steps above.
Contributing
------------
TBD
Example
-------
TBD
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sphinxscript-0.0.6.tar.gz
(5.7 kB
view details)
Built Distribution
File details
Details for the file sphinxscript-0.0.6.tar.gz
.
File metadata
- Download URL: sphinxscript-0.0.6.tar.gz
- Upload date:
- Size: 5.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
53aae26381622b1009dc3cc777154d78c1d3f2f011afdb5a9c3a9713e7706918
|
|
MD5 |
8abcd862c43beefe7ace7ba4d5061b41
|
|
BLAKE2b-256 |
92742b846913c154fc5fcb4bb757fb32980c146bd4941e3c2fed8945e9f91793
|
File details
Details for the file sphinxscript-0.0.6-py2.py3-none-any.whl
.
File metadata
- Download URL: sphinxscript-0.0.6-py2.py3-none-any.whl
- Upload date:
- Size: 7.4 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
2a16448d6458c4f9631b71bc77317156f9d58093d233224d0e63c6cd756a514c
|
|
MD5 |
15cb57a34f93dfc1f15cd6bb913bf8a6
|
|
BLAKE2b-256 |
abc1a8b4eb88674cdcdc658986c478958883942f60f7594f47803affe1662f48
|