Introduction
As I've informed you at post Pelican blog with Fabric and FTP deployment part 2/2 I've started working on Pelican Bootstrap3 Theme.
it's a MIT licensed theme that supports categories, github project's information, social information and few others that I'm currently not interested in.
How to use pelican-bootstrap3 theme
To use this theme, first thing you need is to git clone
this repository:
git clone https://github.com/getpelican/pelican-themes/ themes
Then add information about path for your selected theme in pelicanconf.py
as presented below:
PLUGIN_PATHS = ['plugins']
PLUGINS = ['i18n_subsites']
THEME = "themes/pelican-bootstrap3"
JINJA_ENVIRONMENT = {
"extensions": ['jinja2.ext.i18n'],
}
Then please install i18n plugin from here, using below mini-script (unfortunatelly they all are in one repository, not as git sub-modules.)
git clone https://github.com/getpelican/pelican-plugins plugins
You may want to remove all other plugins besides i18n_subsites
:
cd plugins && mv i18n_subsites ../ && rm -rf . && mv ../i18n_subsites .
And it will start working.
What tips and tricks I've checked with this theme:
1. Github Repositories.
Great idea that you can use your github account and just use without additional plugins gh-repos visible at right banner.
You may want to trick it to only view your own source
projects with:
GITHUB_USER = 'anselmos'
GITHUB_SKIP_FORK = True
2. About me banner information.
There is an information for something similar to About-Page, but available all-the-time in right-banner, it's "ABOUT_ME".
Just add in your pelicanconf.py
variable ABOUT_ME
that will contain all information you want to say about yourself. This variable will also properly decode all html-type metadata.
3. Your code-blocks are customizable!!!
You can change your code-blocks style to different if you want. There are a lot of them because it's using Pygments.
To check what type of Pygments style you can use, check pelican-bootstrap3-theme-page
4. Many many other options
This options can be setup, by reading first information about theme that is available here.
Code commits done for this post:
Tools and applications used:
- Vi/vIM
- pelican
- Docker
Comments
comments powered by Disqus