Go to file

Vitaly Potyarkin c8f57215aa Add stylesheet to restore old visual style By default this stylesheet is not used, because it may break some Boostwatch themes. User must explicitly enable it via THEME_CSS_OVERRIDES		2019-10-18 16:21:06 +03:00
alchemy	Add stylesheet to restore old visual style	2019-10-18 16:21:06 +03:00
.gitignore	Enable installation with pip	2019-09-27 12:20:52 +03:00
CODE_OF_CONDUCT.md	Refresh code of conduct	2017-11-21 15:25:00 +03:00
LICENSE	Add missing copyright year	2017-11-21 15:25:36 +03:00
MANIFEST.in	Enable installation with pip	2019-09-27 12:20:52 +03:00
README.md	Enable installation with pip	2019-09-27 12:20:52 +03:00
screenshot.jpg	Maintenance, new screenshot, update README	2017-11-21 15:51:26 +03:00
setup.py	Enable installation with pip	2019-09-27 12:20:52 +03:00

Pelican Alchemy

A magical ✨ Pelican theme

Alchemy is a functional, clean, responsive theme for the Pelican static site generator.

Inspired by crowsfoot and clean-blog, it features:

** Features link to external assets (webfonts etc).

Installation

Clone the repo:

git clone https://github.com/nairobilug/pelican-alchemy

Set the THEME variable in your Pelican config:

THEME = '<PATH_TO_REPO>/alchemy'

In your Pelican site:

mkdir themes
git submodule add https://github.com/nairobilug/pelican-alchemy themes/pelican-alchemy

And in Pelican config:

THEME = 'themes/pelican-alchemy/alchemy'

Alternatively, you can install this theme with pip:

pip install "https://github.com/nairobilug/pelican-alchemy/tarball/master"

And import it from Pelican config:

import alchemy
THEME = alchemy.path()

Visit the Settings wiki for examples:

SITESUBTITLE: Subtitle that appears in the header.
SITEIMAGE: Image that appears in the header.
DESCRIPTION: Index HTML head <meta> description.
LINKS: A list of tuples (Title, URL) for menu links.
ICONS: A list of tuples (Icon, URL) for icon links.
BOOTSTRAP_CSS: URL of Bootstrap CSS file. Use this to enable Boostwatch themes.
PYGMENTS_STYLE: Built-in Pygments style for syntax highlighting.
HIDE_AUTHORS: Hide the author(s) of an article - useful for single author sites.
RFG_FAVICONS: Use a Favicon Generator package.
THEME_CSS_OVERRIDES: Sequence of stylesheet URLs to override CSS provided by theme. Both relative and absolute URLs are supported.

Misc settings:

Example pelicanconf.py (demo website).

Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
Fork the repository on GitHub to start making your changes to the master branch (or branch off of it).
Send a pull request and bug the maintainer until it gets merged and published. :)

Alchemy follows the Contributor Covenant code of conduct.