블로그와 뉴스

레이아웃 다섯 개로 테마를 블로그나 뉴스 사이트로 쓸 수 있습니다. 모두 Liquid만 쓰기 때문에 기본 GitHub Pages와 Jekyll 4에서 그대로 빌드됩니다. modootoday-blog.css와 share.js는 이 레이아웃을 쓰는 페이지에서만 불러옵니다. 문서 페이지는 두 파일을 받지 않습니다.

레이아웃	용도
`blog`	글 목록과 페이지 이동. `list`, `grid`, `magazine` 중에서 고릅니다
`post`	글 하나. 작성자 정보, 읽는 시간, 표지, 시리즈, 이전·다음 글, 관련 글이 붙습니다
`news`	첫 화면. 머리기사, 보조 기사, 최신 목록, 카테고리별 섹션이 나옵니다
`news-article`	부제, 속보·라이브 배지, 정정, 출처가 붙는 기사
`author`	작성자 소개와 작성자의 글
`feed`	언어 하나의 Atom 피드

데모

아래 데모는 문서 밖에서 레이아웃 하나로 만든 실제 페이지입니다. 여기서 열거나 새 창에서 열어 보세요. 데모 안에서 예시 밖으로 나가는 링크는 #로 되어 있습니다.

데모	레이아웃	새 창
블로그 목록	`blog`	새 창에서 열기
블로그 글	`post`	새 창에서 열기
뉴스 첫 화면	`news`	새 창에서 열기
뉴스 기사	`news-article`	새 창에서 열기
연도별 아카이브	`archive`	새 창에서 열기

한국어 글의 Atom 피드는 feed.xml에 있습니다. 영어와 일본어 피드도 따로 있습니다.

블로그 목록

---
title: 블로그
layout: blog
variant: grid      # list | grid | magazine
category: guides   # 필요할 때만 넣습니다. tag: 도 쓸 수 있습니다
---

예시 블로그에서 이 사이트의 글로 렌더링한 모습을 볼 수 있습니다.

글

---
title: 1.0 출시
author: kim            # 또는 authors: [kim, lee]. _data/authors.yml의 id를 씁니다
image: /assets/cover.png
series: launch         # 같은 series 글에는 "3편 중 2편"과 이동 링크가 붙습니다
last_modified_at: 2026-10-30
---

작성자 정보는 _data/authors.yml에 넣습니다. 글마다 BlogPosting JSON-LD와 article:* Open Graph 태그가 나갑니다.

뉴스

layout: news에 news_sections: [releases, guides]를 넣으면 첫 화면이 됩니다. 기사는 layout: news-article을 쓰고 deck:, breaking: true, live: true, correction:, sources:, credits:를 넣을 수 있습니다. 예시 첫 화면을 보세요.

작성자와 피드

작성자 페이지는 layout: author와 author: kim으로 만듭니다. 언어 폴더마다 layout: feed인 feed.xml을 두면 언어별 Atom 피드가 생기고, head에 자동으로 연결됩니다.

설정

modootoday:
  blog:
    variant: list
    per_page: 10
    excerpt: true
    reading_time: true
    related: 3          # 0이면 관련 글을 숨깁니다
    share: true

front matter 항목 전체는 영어 안내의 표를 보세요.