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.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.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ecfe3f614416e7d27a7baa7452d7c5c66a5603a722a2ec9db690200584542c78 |
|
MD5 | 343787012bd77c7bd7edd054519408fb |
|
BLAKE2b-256 | a063462f5f74f771e41adbf54916cf9238f1cf3c01762568cc6c68dab0251ff5 |
Close
Hashes for sphinxcontrib_gravatar-0.1.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 28dfb705abe637c9cbb28c1b7f5b4f27c76461fb32b6fe8ddad71414e5fdb67f |
|
MD5 | 406a9be12041af4d3e604ffa718075b9 |
|
BLAKE2b-256 | ed29b54fd0f59c5ca16a388d774646ec9a0c0c4a3ce26913bec9f5274b0ad58c |