github directives and roles for sphinx
Project description
Installation
$ pip install sphinxcontrib-github
Add sphinxcontrib-github to your extensions in conf.py.
extensions.append('sphinxcontrib.github')
or change:
extensions = ['sphinx.ext.intersphinx', ...]
to:
extensions = ['sphinx.ext.intersphinx', 'sphinxcontrib.github', ...]
Setting up API access
First use will require entering your github username and password. Read the source for logging in. It will create an API key with github and save an api id and api key for future usage in your projects directory.
Add .github.auth to your .gitignore.
Usage
github pull request role
:github-pr:`saltstack/salt/pull/7665`
output:
salt (#7665) Fixed tags for progress events and preload
24 additions(+), 12 deletion(-) 2013-10-08
github repo role
:github-repo:`saltstack/salt`
output:
salt-states-configs: github
github repo directive
.. github-repo:: saltstack/salt
:homepage: http://www.saltstack.org/
:travis: https://www.travis-ci.org/saltstack/salt/
:docs: http://salt.readthedocs.org/en/v0.16.4/
:api: http://salt.readthedocs.org/en/v0.16.4/ref/python-api.html
:pypi: https://pypi-hypernode.com/pypi/salt
output:
github - travis - docs - api - pypi - homepage - 2296 watchers - 813 forks
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
File details
Details for the file sphinxcontrib-github-0.1.0.tar.gz
.
File metadata
- Download URL: sphinxcontrib-github-0.1.0.tar.gz
- Upload date:
- Size: 5.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 71863aef5c2028a6d2c86076a50d9b6a204890c7b472f1084f25043b9a2063c0 |
|
MD5 | a0e081c4af3e40d7df7ed3131844fde7 |
|
BLAKE2b-256 | 9012a05b9cbc7a6c3dd05a25fc06fa91766ea132128e1772d5be9f97fc7538e2 |