contrast テーマ

contrast テーマについて

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


remotetheme.github.io


_config.yml

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

remote_theme: niklasbuschmann/contrast@v2.10

title: "contrast テーマ"
author: "ふうせん🎈 FU-SEN"
lang: "ja"
date_format: "%Y-%m-%d"

permalink: /:title/

show_social: false
description: "GitHub Pages contrast テーマ"

show_excerpts: false
excerpt_separator: "\n\n\n"

show_frame: false
sidebar: false

navigation:
  - {file: "index.html", icon: home}

external:
  - {title: Github, icon: github, url: "https://github.com/remotetheme/"}

comments:
  disqus_shortname: "name"
remote_theme: niklasbuschmann/contrast@v2.10

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

lang: "ja"

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

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

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

title: "contrast テーマ"

ヘッダまたはサイドバーに表示します。

author: "ふうせん🎈 FU-SEN"

記載している人を入れます。meta タグに含まれます。

description: "GitHub Pages contrast テーマ"

show_social: true の時、フッターに表示します。

show_excerpts: true

タイトル下に本文も表示します。 これがない場合や false の場合はタイトルのみの表示です。

excerpt_separator: "\n\n\n"

show_excerpts: true の時、ページ間の区切りを指定します。

show_frame: false

true にすると左右が灰色、ヘッダが黒表示になります。

sidebar: false

true にすると左サイドバーを表示します。
サイト名やメニューもサイドバー表示になります。 なお、 show_sidebar は機能していないように見えます。

navigation:
  - {file: "index.html", icon: home}

メニューの表示です。iconFont Awesome のアイコン名です。
sidebar: false の場合は右上、sidebar: true の場合はサイドバーに表示されます。

external:
  - {title: Github, icon: github, url: "https://github.com/remotetheme/"}

sidebar: true でサイドバーに追加表示されます。
iconFont Awesome のアイコン名です。

comments:
#  disqus_shortname: "name"

Disqus によるコメントを有効にします。


index.html

---
layout: default
title: "タイトル"
---

{% if site.show_excerpts %}
  {% include home.html %}
{% else %}
  {% include archive.html title="Posts" %}
{% endif %}

title 以外はそのままにするのが良いようです。


_posts/*.md

_post 内は YYYY-MM-DD-タイトル.md で生成します。

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

🍩(・~・)mogmog

他のページ

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

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

🍩(・~・)mogmog

navigation に加えてメニュー表示させます。


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

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

https://github.com/niklasbuschmann/contrast


remotetheme.github.io