Pelican Alchemy
Alchemy ✨ is a functional, clean, responsive theme for the Pelican static site generator.
Inspired by crowsfoot and clean-blog, it features:
- Built with Bootstap 4 (v4-alpha)
- Favicon Generator support
- Font Awesome icons
- Pygments syntax highlighting styles
sitemap.xml
support- External analytics (Google Analytics, Gauges, Piwik)
- External comments (Disqus)
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'
As a Submodule
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'
Usage
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.
- 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:
- DISQUS_SITENAME
- GAUGES
- GOOGLE_ANALYTICS
- PIWIK_URL
- PIWIK_SITE_ID
Example pelicanconf.py (demo website).
Tips & Tricks
https://github.com/nairobilug/pelican-alchemy/wiki/Tips
Maintainers
Contribute
Feel free to dive in. Open an issue or submit a PR.
Alchemy follows the Contributor Covenant code of conduct.
License
MIT © Nairobi GNU/Linux Users Group