pelican-shiori

Shiori theme for Pelican


Keywords
python, pelican, pelican-theme, static-site
License
MIT
Install
pip install pelican-shiori==0.2.1

Documentation

pelican-shiori

pelican-shiori is a port of the Shiori theme (originally built for Jekyll by Elle Kasai) to Pelican.

Installation

$ pip install pelican-shiori

Requirements

Usage

In your pelican settings.py, set the THEME and ASSET_CONFIG variables like the following -

import pelican_shiori

THEME = pelican_shiori.path()
ASSET_CONFIG = pelican_shiori.asset_config()

Configuration

The following configuration variables are supported.

  • SHIORI_AVATAR_URL: URL of the avatar you'd like to show on the sidebar
  • SHIORI_HIDE_SIDEBAR: whether or not to show the sidebar
  • SHIORI_INDEX_ARTICLES_COUNT: number of articles to show on the index page
  • SHIORI_THEME: which color scheme to use (one of dark, turquoise, green, blue, purple, orange, red)

Color Schemes

This theme is available in multiple color schemes (based on Flat UI Colors). The default value for the color scheme is set to (surprise) default. To change it to one of the supported values, adjust the SHIORI_THEME and ASSET_CONFIG variables as follows -

SHIORI_THEME = 'blue'
ASSET_CONFIG = pelican_shiori.asset_config(SHIORI_THEME)

Please make sure that the argument given to pelican_shiori.asset_config is the same as SHIORI_THEME. Bad things may happen otherwise.