A minimal theme for Pelican that uses uikit. The theme is suited for a single author blog. Feeds are provided via ATOM.
This theme was developped with accessibility in mind, but may not be perfectly WCAG-compliant.
Here is how the home page look like
This is the article page
The home page on a smartphone
This is the article layout on a smartphone screen
Check out my blog.
- Open Graph support.
- Twitter Summary Card support.
- Schema.org & microformats2 support: embed a h-card in all your website pages, and add the required markup to make your articles valid h-entries.
- Search with DuckDuckGo.
- Responsive design.
- Comment with Disqus or isso
- SCSS style sheets.
- Analytics with Google Analytics, PIWIK and StatCounter.
- Share buttons built with share urls.
- Custom footer notice.
- W3C-Validated HTML
- Home page images lazy-loading
./run.sh install && ./run.sh dev_install
The following settings are required for a correct behaviour of this theme.
If you want to use the theme with search enabled (and probably you want it).
TAG_SAVE_AS = '' AUTHOR_SAVE_AS = '' DIRECT_TEMPLATES = ('index', 'categories', 'archives', 'past_readings')
If you want to use mg with search disabled.
TAG_SAVE_AS = '' AUTHOR_SAVE_AS = '' DIRECT_TEMPLATES = ('index', 'categories', 'archives') DISABLE_SEARCH = True
ALT_NAME An alternative name for your site. It appears in the header bar.
DESCRIPTION A brief description of your site, for social networks and search engines.
DISABLE_SEARCH Disable search, boolean.
FAVICON The relative path of your favicon, this is needed for Disqus forum favicon.
FAVICON_TYPE The MIME type of your favicon, this is needed for Disqus forum favicon.
FOOTER A custom footer notice.
The absolute URL of a custom image for the
og:image meta property, Twitter
summary card, and
image meta property of Schema.org. This image is used in
every page of the blog. Articles and pages can override the default
META_IMAGE by setting the "image" metadata in the relative file.
The MIME type for META_IMAGE, this is needed for
SC_PROJECT The StatCounter project number.
SC_SECURITY The StatCounter security code for the project.
SHARE Enable share buttons, boolean.
SOCIAL A list of tuples (icon, URL). The icons are from [Font Awesome] (http://fortawesome.github.io/Font-Awesome/). The suffix "-square" is removed in the footer icons of the small screen layout. e.g.
SOCIAL = (('twitter', 'https://twitter.com/luca_chr'), ('google-plus-square', 'https://plus.google.com/117284397605208270870'), ('github', 'https://github.com/lucachr'), ('envelope', 'mailto:firstname.lastname@example.org'),)
SUPPORTS An optional list of tuples (img_alt, url, logo_url, title)
An optional list of
description fields, of books you read, from most recent to oldest.
Specify your Disqus short sitename (the portion of your Disqus account URL before
Enable insertion of a Disqus comments section.
An optional URL to an isso endpoint (serving
Enable insertion of an isso comments section.
More configuration options can be set using
Also enable comments on
pages/. Disabled by default.
If you do not manually provide a summary on your articles, set this to
True so that that the articles summary is not included on the index / search result pages.
Set this to
True, if you do not want to display the last article in full on the index page.
MG_FILTER_TAGS and MG_LANG_FILTER_TAGS Define those variables as list of tag names if you want to enable the tag filtering buttons.
EXTRA_ATOM_FEED An extra URL providing an Atom feed of updates that you want inserted along the blog Atom feed.
COUNTRY Specify the country you live in. Will be included in your h-card.
LOCALITY Specify the city you live in. Will be included in your h-card.
SHORT_BIO GitHub/Twitter-like short bio. Will be included in your h-card.
mg is released under the MIT License.