Minima テーマについて、設定関連の説明です。


remotetheme.github.io


Minima テーマとは?

現在 Jekyll のデフォルトテーマとして採用されています。
jekyll new サイト/ とした時の設定です。

ブログまたはメニューを自動生成する Web サイトなどで使用できます。


_config.yml

_config.yml は次の情報を入れます。

theme: minima
lang: ja
title: Minima テーマ
description: GitHub Page Minima テーマ
url: "https://remotetheme.github.io"
baseurl: "/minima"
show_excerpts: true
google_analytics: 
minima:
  date_format: "%Y-%m-%d"
  skin: dark
header_pages:
  - about.md
theme: minima

このテーマ Minima を使用する場合に指定します。

lang: ja

日本語 の場合はこれを含めて下さい。 <html lang="ja"> へ変換されます。

title: Minima テーマ

ヘッダ・フッタに表示します。

description: GitHub Pages Minima テーマ

フッタに表示されます。

url: "https://remotetheme.github.io"
baseurl: "/minima"

https://remotetheme.github.io/minima/ が公開 URL となる場合、
上のように設定します。 この場合 jekyll serve のプレビューは
baseutl に合わせて https://localhost:4040/minima/ での参照になります。

show_excerpts: true

一覧表示のタイトル下に 1 段落表示されるようになります。
これがない場合や false の場合はタイトルのみの表示です。

google_analytics: UA-OOOOOOOO-O

Google アナリティクス の トラッキング ID を入れると、
ソースにトラッキングコードが付与されます。
Google アナリティクス 4 のコードは非対応です。

minima:
  date_format: "%Y-%m-%d"

日付を日本向けの 年-月-日 表記にします。

minima:
  skin: dark

スキン(テーマ)を選択できます。次が選択できます。

  • classic
  • dark
  • solarized
  • solarized-dark
header_pages:
  - about.md

右上のメニューに表示するページを入れます。表示はタイトルになります。

header_pages:
  - _posts/2020-12-06-minima.md
  - _posts/2020-12-06-markdown.md
include:
  - _posts

ここでは _posts 内を指定していますので、inclide: _posts を含めています。


_posts/*.md

_post 内は YYYY-MM-DD-タイトル.md で生成します。
デプロイすると YYYY/MM/DD/タイトル.html となります。

---
layout: post
title: "Minima テーマについて"
date: 2020-12-06 00:01:00 +0900
---

🍩(・~・)mogmog

(・~・)mog?

_config.ymlshow_excerpts: true を入れている時は
一覧でも 🍩(・~・)mogmog まで表示されます。


_index.md

jekyll new サイト/ 生成時は次の中身になっています。

---
layout: home
---

本文を加える事でトップページ上部に表示できます。

---
layout: home
date: 2020-12-06 00:15:00 +0900
---

🍩(・~・)mogmog

他のページ

about.md など、index.md に並べて生成できます。

---
layout: page
title: "About"
permalink: /about/
---

🍩(・~・)mogmog

通常これらのページは右上に表示されるようになります。


テーマのプロジェクト・ソース

より詳細な設定などはこちらを参照して下さい。

https://github.com/jekyll/minima


remotetheme.github.io