ページ構成とフロントマター

フォルダ構成

content
├── level-one
│   ├── level-two
│   │   ├── level-three
│   │   │   ├── level-four
│   │   │   │   ├── _index.md       <-- /level-one/level-two/level-three/level-four
│   │   │   │   ├── page-4-a.md     <-- /level-one/level-two/level-three/level-four/page-4-a
│   │   │   │   ├── page-4-b.md     <-- /level-one/level-two/level-three/level-four/page-4-b
│   │   │   │   └── page-4-c.md     <-- /level-one/level-two/level-three/level-four/page-4-c
│   │   │   ├── _index.md           <-- /level-one/level-two/level-three
│   │   │   ├── page-3-a.md         <-- /level-one/level-two/level-three/page-3-a
│   │   │   ├── page-3-b.md         <-- /level-one/level-two/level-three/page-3-b
│   │   │   └── page-3-c.md         <-- /level-one/level-two/level-three/page-3-c
│   │   ├── _index.md               <-- /level-one/level-two
│   │   ├── page-2-a.md             <-- /level-one/level-two/page-2-a
│   │   ├── page-2-b.md             <-- /level-one/level-two/page-2-b
│   │   └── page-2-c.md             <-- /level-one/level-two/page-2-c
│   ├── _index.md                   <-- /level-one
│   ├── page-1-a.md                 <-- /level-one/page-1-a
│   ├── page-1-b.md                 <-- /level-one/page-1-b
│   └── page-1-c.md                 <-- /level-one/page-1-c
├── _index.md                       <-- /
└── page-top.md                     <-- /page-top

それぞれのフォルダ内には_index.mdが必要です

チャプター

learnでは、親ページのチャプターを作成し、子ページを作成していきます

チャプターの作成

huto new --kind=chapter basics/_index.md

basicsが親ページとなり、内容が_index.mdとなります
_index.mdのfrontmatterでは、下記のようにchapter = trueが設定されます

+++
title = "Basics"
chapter = true
weight = 5
pre = "<b>1. </b>"
+++

### Chapter 1

# Basics

Discover what this Hugo theme is all about and the core-concepts behind it.

子ページの作成

通常通りの作成でOKです

hugo new basics/page1.md

or

hugo new basics/page1/_index.md

親・子ページそれぞれ、後々のために並び順のweightを設定しておくと良いでしょう

フロントマター

learnでのfrontmatterは下記のパラメータが利用されます

+++
# Table of content (toc) is enabled by default. Set this parameter to true to disable it.
# Note: Toc is always disabled for chapter pages
disableToc = "false"
# If set, this will be used for the page's menu entry (instead of the `title` attribute)
menuTitle = ""
# The title of the page in menu will be prefixed by this HTML content
pre = ""
# The title of the page in menu will be postfixed by this HTML content
post = ""
# Set the page as a chapter, changing the way it's displayed
chapter = false
# Hide a menu entry by setting this to true
hidden = false
# Display name of this page modifier. If set, it will be displayed in the footer.
LastModifierDisplayName = ""
# Email of this page modifier. If set with LastModifierDisplayName, it will be displayed in the footer
LastModifierEmail = ""
+++

メニューにアイコン追加

ftontmatterにpreパラメータを追加しFontAwesomeのアイコンを付加

+++
title = "Github repo"
pre = "<i class='fab fa-github'></i> "
+++

メニューのタイトルを任意に変更

記事のタイトルとメニュー項目のタイトルを変更したい場合

+++
title = "Install on Linux"
menuTitle = "Linux"
+++

タグ（タクソノミー）メニュー