Skip to content
Go to file
This branch is 113 commits ahead of lucachr:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Build Status

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

mg home page screenshot

This is the article page

mg article page screenshot

The home page on a smartphone

mg home page smartphone top screenshot mg home page smartphone bottom screenshot

This is the article layout on a smartphone screen

mg article page smartphone top screenshot

Live Example

Check out my blog.


  • Open Graph support.
  • Twitter Summary Card support.
  • & 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


This template uses the representative_image and image_process plugins, so you will need to:

./ install && ./ 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 = ''
    DIRECT_TEMPLATES = ('index', 'categories', 'archives', 'past_readings')

If you want to use mg with search disabled.

    TAG_SAVE_AS = ''
    DIRECT_TEMPLATES = ('index', 'categories', 'archives')

Optional settings

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.

META_IMAGE The absolute URL of a custom image for the og:image meta property, Twitter summary card, and image meta property of 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.

META_IMAGE_TYPE The MIME type for META_IMAGE, this is needed for og:image:type.

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] ( The suffix "-square" is removed in the footer icons of the small screen layout. e.g.

    SOCIAL = (('twitter', ''),
              ('google-plus-square', ''),
              ('github', ''),
              ('envelope', ''),)

SUPPORTS An optional list of tuples (img_alt, url, logo_url, title)

READINGS An optional list of dict, with img_url & description fields, of books you read, from most recent to oldest.

DISQUS_SITENAME Specify your Disqus short sitename (the portion of your Disqus account URL before Enable insertion of a Disqus comments section.

ISSO_BASE_URL An optional URL to an isso endpoint (serving /js/ Enable insertion of an isso comments section. More configuration options can be set using ISSO_REQUIRE_AUTHOR, ISSO_REPLY_NOTIFICATIONS & ISSO_ENABLE_VOTE

ENABLE_COMMENTS_ON_PAGES Also enable comments on pages/. Disabled by default.

WEBMENTION_IO_API_KEY An optional API key for service, to display webmentions using webmention.js.

MG_DISABLE_SUMMARY 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.

MG_NO_EXCERPT 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.

WEBMENTION_URL / PINGBACK_URL Linkback URLs, that can be provided by example by

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.

Example Configuration


Developper tools

HTML linters:


mg is released under the MIT License.


A responsive, minimal theme for Pelican that uses UIkit.




No packages published