Tool for building restructured text documentation for projects with scripts in many languages
Project description
sphinx-script Script Documentation Module
=========================================
[![Travis-CI](https://img.shields.io/travis/ClimateImpactLab/sphinxscript/master.svg?style=flat-square "Travis CI")](https://travis-ci.org/ClimateImpactLab/sphinxscript)
[![PyPi](https://img.shields.io/pypi/v/sphinxscript.svg?style=flat-square "PyPi")](https://pypi.python.org/pypi/sphinxscript)
[![Coveralls](https://img.shields.io/coveralls/delgadom/sphinxscript.svg?style=flat-square "Coveralls")](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
=========================================
[![Travis-CI](https://img.shields.io/travis/ClimateImpactLab/sphinxscript/master.svg?style=flat-square "Travis CI")](https://travis-ci.org/ClimateImpactLab/sphinxscript)
[![PyPi](https://img.shields.io/pypi/v/sphinxscript.svg?style=flat-square "PyPi")](https://pypi.python.org/pypi/sphinxscript)
[![Coveralls](https://img.shields.io/coveralls/delgadom/sphinxscript.svg?style=flat-square "Coveralls")](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 |