Blog and news

Five layouts turn the theme into a blog or a newsroom. They are Liquid only, so they build on classic GitHub Pages and on Jekyll 4. They load modootoday-blog.css and share.js on their own pages only. Docs pages do not download either file.

Demos

Each demo below is a real page built with one layout, outside the docs. Open it here or in a new window. Links inside the demos that would leave the sample point to #.

The Atom feed for English posts is at feed.xml; Korean and Japanese have their own.

Blog index

---
title: Blog
layout: blog
variant: grid      # list | grid | magazine
category: guides   # optional filter; tag: works too
---

See it rendered on the sample blog, which lists the posts on this site.

With jekyll-paginate on and paginate: set, the root index.html blog page shows pager links. Otherwise the page shows per_page posts and a link to archive_url.

Posts

---
title: Shipping 1.0
author: kim            # or authors: [kim, lee], ids from _data/authors.yml
image: /assets/cover.png
image_alt: The release dashboard
series: launch         # posts with the same series get "Part 2 of 3" and links
last_modified_at: 2026-10-30
---

Author data lives in _data/authors.yml:

kim: {name: Kim, url: "https://example.com", page: /authors/kim/, bio: Writes the docs.}

Each post emits BlogPosting JSON-LD and article:* Open Graph tags. Related posts are scored by shared tags and categories.

News

---
title: News
layout: news
news_sections: [releases, guides]
---

An article uses layout: news-article and adds deck:, breaking: true or live: true, correction:, sources: [...] and credits:. It emits NewsArticle JSON-LD. See the sample front page and the sample article.

Authors and feeds

---
layout: author
author: kim
---

Add a feed.xml page with layout: feed in each language folder (/ko/feed.xml) to get one Atom feed per language. The head links to it. Set feed_content: full for full text.

Settings

modootoday:
  blog:
    variant: list       # default list style
    per_page: 10
    excerpt: true
    reading_time: true
    related: 3          # 0 hides related posts
    share: true         # copy-link button
  news:
    sections: [releases]  # default news_sections