Minimal Mistakes Front Matter, Rendered by DataLog

The compatibility layer in action

A post written entirely with Minimal Mistakes front matter, rendered by DataLog without a single field renamed.

Published
May 5, 2026
Author
Reading time
2 mins read
Difficulty
Intermediate
Saved articles

Online at https://diogoribeiro7.github.io/analytics-blog-jekyll/tutorials/2026/05/05/minimal-mistakes-front-matter-compatibility/

This post's front matter is written the way the Minimal Mistakes theme expects it, and none of it has been renamed for DataLog. The hero image above, the teaser on the home page cards, the title in the browser tab, the meta description, the wide body class and the editorial note below all come from Minimal Mistakes fields.

What was mapped

Minimal Mistakes field DataLog field Where it shows
header.overlay_image post_hero.image with post_hero.overlay: true The title sits over the image at the top of this page
header.overlay_filter post_hero.overlay_filter The darkening over the hero image
header.teaser teaser Thumbnail on the home page and related-post cards
header.og_image, header.twitter_image og_image, twitter_image Social sharing previews
seo_title <title> and social titles The browser tab reads the SEO title, the heading reads the real one
seo_description description The meta description
classes: wide body class wide Paragraphs use the full content width
subtitle subtitle under the title The line under the heading
why_this_exists, evidence, methodology, reviewed_at provenance note The editorial note above the article body
redirect_from redirect page /legacy/minimal-mistakes-post/ redirects here

What is ignored

author_profile controls the Minimal Mistakes sidebar, which DataLog does not have; DataLog shows the author card at the end of the post instead. seo_type: article is redundant, because DataLog already marks posts as articles for social cards and structured data.

Where the rules live

The mapping is a single build hook in _plugins/front_matter_compat.rb. It only fills DataLog fields that are absent, so a post that sets image or description explicitly keeps those values. The full field table and the URL-preservation settings are in the migration guide.

Your private highlights

Kept in this browser only and never sent anywhere. These are your notes, not comments. With text selected, Alt+Shift+H highlights it and Alt+Shift+N adds a note.

Select a passage of the article to highlight it.

    Your reading data

    Embed interactive plots, widgets, and demos using <figure>, <iframe>, or <div class="interactive-embed"> containers. Ensure each embed includes descriptive captions for accessibility.

    © 2026 Diogo Ribeiro. Text and figures under CC BY 4.0.

    How to cite

    Use the quick export buttons to save citations for reference managers or copy the formatted text directly.

    Diogo Ribeiro (2026). Minimal Mistakes Front Matter, Rendered by DataLog. DataLog | Data Science & Research Theme. https://diogoribeiro7.github.io/analytics-blog-jekyll/tutorials/2026/05/05/minimal-mistakes-front-matter-compatibility/.

    BibTeX

    RIS

    EndNote

    Open science & reproducibility badges

    These badges highlight the transparency practices applied to this work. Hover or focus on each badge to learn more about the criteria.

    • Open Data Dataset and code repository published with permissive license. Public repository, DOI issued, README with reproduction steps.
    • Reproducible Workflow Containerized environment and automated tests provided. Continuous integration pipeline with reproducibility checks.
    • Transparent Peer Review Peer review reports archived with DOI and linked to article. Open peer review statement and archived reports on Zenodo.

    Related posts