Go to file

Vitaly Potyarkin 18996a6c1d Enable alternative themes for Bootstrap (e.g. Boostwatch) Alchemy is a great theme, but it was not using the full potential of underlying technology. Bootstrap provides an easy way to customize look and feel of rendered pages, and a lot of themes for Bootstrap are freely available, e.g. at <https://boostwatch.com> This commit introduces a new configuration variable BOOTSTRAP_CSS to make use of any existing Bootstrap skins. All incompatibilities in `theme.css` were fixed: - Instead of using constant color values we use Bootstrap css variables for colors: <https://getbootstrap.com/docs/4.3/getting-started/theming/#css-variables> - The only hardcoded color value left is the color for header/footer borders. It was moved into a variable `--alchemy-border` for easier overriding if needed. I have tested the current value against both dark and light Boostwatch themes, it works ok. - Pagination template was slightly changed to avoid producing invisible text with some of Bootstrap skins		2019-09-18 17:52:08 +03:00
alchemy	Enable alternative themes for Bootstrap (e.g. Boostwatch)	2019-09-18 17:52:08 +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
README.md	Enable alternative themes for Bootstrap (e.g. Boostwatch)	2019-09-18 17:52:08 +03:00
screenshot.jpg	Maintenance, new screenshot, update README	2017-11-21 15:51:26 +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'

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.

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.