Flex

The minimalist Pelican theme.

My mods to the theme

• add new direct template for notes: "til" (things I learned) and related mods:
  • do not display notes on home (index) page - let the short notes do not clutter list of blog posts (loger articles)
  • do not display notes on archive page - for the same reason as above
• modified archives page with my custom groupping by year (inspied by elegant theme)
• support for new meta:
  • til_category
  • featured_image_alt
  • modified (?)
  • suggested_tags
  • ignore_tags - list - Do not add these tags to the suggested tags. When manually editing article with front matter you can review tags and move suggested tags to tags (or til_tags) and move unfortunate tags to ignore_tags to avoid have them suggested next time when automated tag suggention will be running.
  • citation_needed
  • til_tags
  • til_category
  • image for article featured image (not cover or featured_image)
  • changes in styling

Compare differences to original Flex in details: compare this fork

Notes

• If you have questions open an issue
• The theme is not under huge development anymore, it's stable and has a lot of features already
• If you want a Hugo theme check out Soho

Features

• Mobile First
• Responsive
• Semantic
• SEO Best Practices
• Open Graph
• Rich Snippets (JSON-LD)
• Related Posts (via plugin or AddThis)
• Minute read (via plugin)
• Multiple Code Highlight Styles
• Translation Support
• Dark Mode

Integrations

• AddThis
• Disqus
• Gauges Analytics
• Google AdSense
• Google Analytics
• Google Tag Manager
• Matomo Analytics (formerly Piwik)
• StatusCake
• Isso
• Microsoft Clarity

Plugins Support

• Github Corners
• I18N Sub-sites
• Minute read
• Related Posts
• Representative image
• Neighbors
• Tipue Search
• SEO

Install

The best way to install is over pelican-themes.

The alternative way is to clone this repository. The master branch is stable and is safe to checkout, but I would recommend you to checkout a tag branch.

Documentation

The documentation covers most of the settings available and how to use this theme. If something is missing or broken you can open a PR or fix the documentation by yourself.

Flex Wiki

Live example

You can see how this theme looks like at http://flex.alxd.me/.

The code is available in this project under docs folder.

Contributing

ALWAYS open an issue before sending a PR. Discuss the problem/feature that you want to code. After discussing, send a PR with your changes.

As always, if you want something that only makes sense to you, fork Flex and create a new theme.

Translations

Translate this theme to new languages at Transifex.

Read more about Translation Support in the Wiki.

License

MIT