Rafael Laboissiere a09f5c6207 libravatar: Encode email address before hashing 9 lat temu
..
test_data 0c2ea17d68 Add the Libravatar plugin 9 lat temu
.gitignore 0c2ea17d68 Add the Libravatar plugin 9 lat temu
Readme.md 17f1d318da Use fenced code blocks 9 lat temu
__init__.py 0c2ea17d68 Add the Libravatar plugin 9 lat temu
libravatar.py a09f5c6207 libravatar: Encode email address before hashing 9 lat temu
test_libravatar.py 1e9b6249cd Delay the string casting of the size parameter 9 lat temu

Readme.md

Libravatar plugin for Pelican

Description

This plugin allows the inclusion of Libravatar user profile pictures, according to the email address of the article's author.

Usage

Specifying the author's email address

The default email address is taken from the LIBRAVATAR_AUTHOR_EMAIL variable in the Pelican configuration file. This default value can be overridden in a per-article basis, according to the email address found in the article's metadata.

In ReSTructuredText:

:email: bart.simpson@example.com

In Markdown:

Email: bart.simpson@example.com

If the avatar for the specified email address is not found at Libravatar, it is searched at Gravatar. If it is not found there neither, a default picture is shown. The default for the "missing picture" can be defined in the configuration variable LIBRAVATAR_MISSING.

Adjusting the template

This plugin assigns the author_libravatar variable to the Libravatar URL and makes the variable available within the article's context. For instance, you can add the following to a template file (for example, to the article_infos.html template file of the notmyidea theme), just before the infomation about the author:

{% if article.author_libravatar %}
<div align="center">
        <img src="{{ article.author_libravatar }}">
</div>
{% endif %}

Settings

The following variables can be set in the Pelican configuration file:

  • LIBRAVATAR_AUTHOR_EMAIL: site-wide default for the author's email address.

  • LIBRAVATAR_MISSING: The default for the missing picture. This can be either a url (e.g. 'http://example.com/nobody.png') or the name of a library of logos (e.g. 'wavatar'; for the full set of alternativas, see the Libravatar API).

  • LIBRAVATAR_SIZE: The size, in pixels, of the profile picture (it is always square, so the height is equal to the width). If not specified, the default size (80×80) is returned by Libravatar.

Credits

Inspiration for this plugin came from the gravatar plugin.

Author

Copyright (C) 2015 Rafael Laboissiere (rafael@laboissiere.net)

Released under the GNU Affero Public License, version 3 or later. No warranties.