skip to navigation
skip to content

Not Logged In

pelican-gist 0.3.0

Easily embed GitHub Gists in your Pelican articles.

Latest Version: 0.3.2

Pelican Gist Tag is a library to make it easy to GitHub Gists in your Pelican blogs.

Installation

To install pelican-gist, simply:

$ pip install pelican-gist

Then add a bit of code to your blog configuration:

PLUGINS = [
    # ...
    'pelican_gist',
    # ...
]

Usage

In your articles, just add lines to your posts that look like:

[gist:id=3254906,file=brew-update-notifier.sh]

This will tell the plugin to insert gist id 3254906 and choose the file brew-update-notifier.sh into your post. The resulting HTML will look like:

<div class="gist">
    <script src='https://gist.github.com/3254906.js?file=brew-update-notifier.sh'></script>
    <noscript>
        <pre><code>#!/bin/bash ...</code></pre>
    </noscript>
</div>

If your gist has only a single file, you can also specify the gist like so:

[gist:id=3254906]

Notice it is using the id only. The resulting HTML will look like:

<div class="gist">
    <script src='https://gist.github.com/3254906.js'></script>
    <noscript>
        <pre><code>#!/bin/bash ...</code></pre>
    </noscript>
</div>

There is also support for private gists where they have the gist id that looks like e34db4c532a6cfa1f711.

Settings

GIST_CACHE_ENABLED - Specifies whether to cache the gist on disk or not. Default is True. (Optional)

Changelog

  • 0.3.0 - Added Python 3 support

License

Uses the MIT license.

 
File Type Py Version Uploaded on Size
pelican-gist-0.3.0.tar.gz (md5) Source 2013-11-26 4KB
  • Downloads (All Versions):
  • 7 downloads in the last day
  • 112 downloads in the last week
  • 736 downloads in the last month