Sphinx "gravatar" extension
Project description
sphinxcontrib-gravatar is a Sphinx extension for Gravatar
Features
Provide gravatar icon for your document.
Set up
Make environment with pip:
$ pip install sphinxcontrib-gravatar
Usage
setup conf.py with:
# set extension extensions += ['sphinxcontrib.gravatar'] # define gravatar users gravatar_users = ( ('tell-k', {'email': 'ffk2005@gmail.com' }), )
write gravatar role:
.. gravatar:: tell-k # If you wanted to write in the text. you can use "Substitution References". .. |tell-k-gravatar| gravatar:: tell-k my gravatar image |tell-k-gravatar|.
and run:
$ make html
Option
TODO more documented.
conf.py options:
gravatar_default_size = 30 gravatar_default_image = "http://www.gravatar.com/avatar/205e460b479e2e5b48aec07710c08d50" gravatar_default_rating = "pg" gravatar_default_target = "http://github.com/tell-k/" gravatar_force_default = True gravatar_force_refresh = True gravatar_unlink = True gravatar_default_class = "custom-classname" gravatar_users = ( ('tell-k', { 'email': 'ffk2005@gmail.com', 'default': 'http://www.gravatar.com/avatar/205e460b479e2e5b48aec07710c08d50', 'force_default': True, 'unlink': True, 'target': "http://github.com/tell-k/", 'rating': "pg", 'class': u"custom-classname", 'alt': "alternative text", }), )
Directive options:
.. gravatar:: tell-k :size: 200 :default: mm :target: http://github.com/tell-k :rating: pg :class: test-gravatar :alt: altnativetext
Requirement
Python 2.7 or later.
Sphinx 1.2.x or later.
Using
License
sphinxcontrib-gravatar Licensed under the BSD License.
See the LICENSE file for specific terms.
History
0.1.2(Jan 1, 2015)
Exclude test code from installed packages
0.1.1(Dec 31, 2014)
Drop Python-3.2 support. #1
Support wheel format.
0.1.0(Oct 2, 2014)
First release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for sphinxcontrib-gravatar-0.1.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8dd2f77cdf05422c23547cd71fabfd46a62919e994037a799293e2bc73410233 |
|
MD5 | aa0a710c4a7478f9d1ad92f4d2783fe1 |
|
BLAKE2b-256 | d26347f30054fd4ea444d0c29262eb7bad47d8b5b20a08279ad41edbb45bea04 |
Close
Hashes for sphinxcontrib_gravatar-0.1.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b10f31885eef2a1375778cdcac807a17704f8f8a77436db20305b1bd58ecc19e |
|
MD5 | dc22f712e0dc4c033cfb217ab0305b35 |
|
BLAKE2b-256 | 9fa41320de929a67f71484214208a98caaed82032c99ed9ac23f8aaedfe1609b |