Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alysbrooks/iris-tufte

My modifications to the Iris theme.
https://github.com/alysbrooks/iris-tufte

Last synced: 27 days ago
JSON representation

My modifications to the Iris theme.

Awesome Lists containing this project

README

        

====
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:

- For social icons: `Font awesome `_
- For the title: `The girl next door `_
- For the headers: `Marcellus `_
- For the soure code: `Inconsolata `_

Preview
-------

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

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:

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

License
-------

This theme is under the `3 clause BSD license `_