Skip to content
Sphinx extension to show some ❤️ to your GitHub contributors
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


PyPI version Travis Status

People who contribute to open-source projects could be spending their free time. It does not matter if it is a code change, an epic, or fixing a small typo. At the end of the day, this change makes the project better. That's the reason why you should recognize every contribution!

Are you using Sphinx to document the open-source project? Then sphinxcontrib-ghcontributors directive allows you to render all the usernames that have contributed to your repositories directly in your docs.



  1. Install sphinxcontrib-ghcontributors using pip.
pip install sphinxcontrib-ghcontributors
  1. Add the extension to your Sphinx project file.
extensions = ['sphinxcontrib.ghcontributors']


The extension defines the directive ghcontributors. For each repository that you want to render its contributors, state the Github username and the repository name.

..  ghcontributors:: dgarcia360/sphinxcontrib-ghcontributors

Sphinx will render the 10 most active contributors. You can increase the number of results to show, and as well exclude some users from the list adding optional filters.

    ..  ghcontributors:: dgarcia360/sphinxcontrib-ghcontributors
        :limit: 20
        :order: ASC
        :exclude: dgarcia360,sphinx

This directive will render the less active 20 contributors, ordered in ascending order, excluding dgarcia360 and sphinx usernames from the list.


See the open issues for a list of proposed features.


Contributions are welcome and appreciated! Check file.


Copyright (c) 2018 David Garcia (@dgarcia360).

Licensed under MIT license (see for details)

You can’t perform that action at this time.