sphinxcontrib-mercurial

Sphinx "mercurial" extension


License
GPL-3.0
Install
pip install sphinxcontrib-mercurial==0.2

Documentation

================================== Mercurial extension for Sphinx ================================== Overview ======== This allows you to include a Mercurial extension of your Sphinx documentation within the documentation. Installation ============ :: $ pip install sphinxcontrib-mercurial How to setup ============ Once you enable this extension, :: # Add any Sphinx extension module names here, as strings. They can be extensions # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. extensions = ['sphinxcontrib.mercurial'] Configulation ============= How to use hg_changelog directive --------------------------------- :: .. hg_changelog:: where you want the list of commits to appear. Options of hg_changelog ----------------------- repo_root_path specify repository root (default: ".") max_commits set max commits to include (default: 10) branch specify which branch to include (default: "default") path specify the path to include (default: all) NOTE: you need to set from repository root. Example of hg_changelog ----------------------- :: .. hg_changelog:: :repo_root_path: ../.. :max_commits: 2 :path: test/rst How to use hg_version directive ------------------------------- :: .. hg_version:: where you want the version to appear, Acknowledgement ================ https://github.com/OddBloke/sphinx-git