Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Social directives for Pelican Blog Generator

Project Description

Social plugin for Pelican

Social directives for Pelican static blog generator.

Easy linking to social networks content through simple inline directives.


pelican-social is compatible with Pelican 3.3+ and Python 2.7.


Install the plugin via pip:

~$ pip install pelican-social


To load the plugin, you have to add it in your settings file.


Once loaded you have access to social rst directives.

Each directive can be called in two forms:


:network:`Displayed text <target>`

As much as possible, the directive give a secure (https) link.


You can use both :twitter: and :tw: directives to link to a Twitter profile, they are equivalent. Using an @ in username will only change the displayed username if a custom display is not specified.


:twitter:`User <username>`
:twitter:`User <@username>`

will result in:

<a href="">username</a>
<a href="">&#64;username</a>
<a href="">User</a>
<a href="">User</a>


Google+ is tricky with usernames. If you are famous and lucky you can have a custom username in +MyUser form. If not you will have a 21 digits identifier.


:gplus:`User <username>`

will result in:

<a href="">username</a>
<a href="">User</a>


You can use both :github: and :gh: directive to link to github profiles, repositories and issues/pull-requests (github will autmatically redirect you to the pull-request if one is associated with the issue).

The following form are accepted:

Target Expected target form
profile username
repository username/repository
issue/pull-request username/repository#issue


:github:`User <username>`
:github:`Repository <username/repository>`
:github:`Issue #2 <username/repository#2>`

will result in:

<a href="">username</a>
<a href="">User</a>
<a href="">repository</a>
<a href="">Repository</a>
<a href="">#2</a>
<a href="">Issue #2</a>


You can use both :facebook: and :fb: directives to link to a Facebook profile, they are equivalent.


:facebook:`User <username>`

will result in:

<a href="">User</a>
<a href="">username</a>


0.2.0 (2017-02-02)

  • Support for Pelican 3.7+ and Python 3.3+
  • Drop support for Python 3.2

0.1.1 (2013-07-02)

  • Handle dot and dashes in Github usernames and repository names

0.1 (2013-06-20)

  • Initial implementation allowing to link to:
    • Facebook profiles
    • Twitter profiles
    • Google+ profiles
    • Github profiles, repositories and issues

Release History

This version
History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(9.3 kB) Copy SHA256 Hash SHA256
Wheel 3.6 Feb 2, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate