Skip to content

Sphinx extension to show some ❤️ to your GitHub contributors(中文)

License

Notifications You must be signed in to change notification settings

daobook/sphinx-contributors

 
 

Repository files navigation

sphinx-contributors

sphinx-contributors is a Sphinx extension that helps you recognize the people who have contributed to an open-source project.

https://raw.githubusercontent.com/dgarcia360/sphinx-contributors/master/docs/source/_static/example_avatars.png

Features

Celebrate contributions

Show the list of users who have contributed to a repository in your docs.

Configurable

Choose how many contributors show and sort them by the number of commits.

Supported platforms

sphinx-contributors only works with GitHub public repositories.

Installation

  1. Install sphinx-contributors using PIP.

    pip install sphinx-contributors
  2. Add the extension to your Sphinx project conf.py file.

    extensions = ['sphinx_contributors']

Usage

Using the directive:

..  contributors:: sphinx-doc/sphinx

Renders:

https://raw.githubusercontent.com/dgarcia360/sphinx-contributors/master/docs/source/_static/example.png

Check out the full documentation for more customizable options at https://sphinx-contributors.readthedocs.io/

Contributing

We encourage public contributions! Please review CONTRIBUTING for details on our code of conduct and development process.

License

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

Licensed under the MIT License.

About

Sphinx extension to show some ❤️ to your GitHub contributors(中文)

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 93.6%
  • CSS 6.4%