/iris

Pelican (the static blog generator) theme based in Flask webpage theme

Primary LanguageCSSBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Iris

What is iris?

Iris is a pelican theme based on Flask webpage This theme is very simple and easy to read, perfect for a minimalist blog without much things and beautiful source code syntax (Thank you pygments!) Also uses various fonts:

Preview

https://gist.github.com/slok/3885420/raw/bbb0c9598f32a7913b16f4ea4c0308e8c701ef9b/iris_marcellus.png

Variables

Some of the variables that could be used:

  • DISQUS_SITENAME: For the disqus comments
  • EMAIL: For the email "mailto:"

For the analytics we have two flavours, one is Go Squared

  • GOSQUARED_SITENAME: For the Go squared analytics

And the other is Google analytics Google analytics has various forms. The basic one is:

  • GOOGLE_ANALYTICS_CODE: this is the code of GA, something similar to: UA-xxxxxxxx-y

If you have analytics across domains you can put this setting:

  • GOOGLE_ANALYTICS_DOMAIN = "xlarrakoetxea.org"

And if you have upper domain level (com, org, co.uk...)

  • GOOGLE_ANALYTICS_DOMAIN_UP = True

Installation

To install, go to your pelican theme directory and clone the repo. For example:

$ cd /home/slok/.virtualenvs/blog/lib/python2.7/site-packages/pelican/themes/
$ git clone https://github.com/slok/iris.git

Set the variable THEME to iris in your pelican settings, like this:

THEME = "iris"

Notes

The theme navigation bar does a fade in if you scroll more than 300 pixels to increase the readability of an article.

ReStructuredText creates tt with ``something`` that is equivalent to markdown code that is created wit `something`. This renders inline source code. So I added tt to the css also, not only code like most themes. Example:

https://gist.github.com/slok/3885420/raw/4d7a8557780ab74c5ae797a4f6e82cbf11aec0c6/iris_inline.png

License

This theme is under the 3 clause BSD license