Skip to content

Latest commit

 

History

History
29 lines (19 loc) · 1.18 KB

README.rst

File metadata and controls

29 lines (19 loc) · 1.18 KB

sphinx-git

https://travis-ci.org/OddBloke/sphinx-git.png?branch=master

sphinx-git is an extension to the Sphinx documentation tool that allows you to include excerpts from your git history within your documentation. This could be used for release changelogs, to pick out specific examples of history in documentation, or just to surface what is happening in the project.

To use it, add 'sphinx_git' to 'extensions' in your Sphinx conf.py, and add:

.. git_changelog::

where you want the list of commits to appear.

For more details, see the documentation on Read the Docs.

Example

You can see a live example in the Read the Docs documentation; the HTML output looks like this:

https://user-images.githubusercontent.com/62736/34072980-a8469baa-e25e-11e7-968f-553caad65e56.png