Pelican Git
Pelican Git is a library that makes it easy to embed GitHub files in your Pelican blogs using simple syntax.
Installation
To install pelican-git, simply:
$ pip install pelican-git
Then add a bit of code to your blog configuration:
PLUGINS = [
# ...
'pelican_git',
# ...
]
Usage
In your articles, just add lines to your posts that look like:
[git:repo=yourname/yourrepo,file=somefile,branch=master,hash=xxxxxxx]
branch and hash are optional. If you don't specify branch, it will be master. If you specify hash it will overwrite the branch setting.
The generated code will embed css and html content directly into a div and replace the original tag. This is faster and cleaner than using javascript to rewrite the page content like what gist_it does.
Settings
GIT_CACHE_ENABLED
- Specifies whether to cache the git files on disk or not. Default is False
. (Optional)
Testing
$ make install
$ make test
Authors
Inspired by pelican_gist
Changelog
- 0.1.8 - Fix link to original repo
- 0.1.0 - Initial version
License
Uses the MIT license.