目次

目次

ものテーマは目次(ToC)の表示に対応しています。

引数

以下の2つの引数で目次を管理できます:

• グローバル toc 引数；
• 投稿の toc 引数。

投稿のtocはグローバルのtocより優先されます。

目次をすべての投稿で有効にする

目次をすべての投稿(グローバル)で有効にするには、hugo.toml内のtoc引数をtrueに設定してください。

[params]
  toc = true

すべての投稿で目次を使用したくない場合、toc引数を記述しないかfalseに設定してください。

特定投稿で目次を有効にする

目次を特定の投稿でのみ有効にする場合、投稿設定でtoc引数にtrueを設定してください。

---
title: 目次を有効にする方法
date: 2023-05-02
toc: true
---

特定の投稿で目次を無効にする

特定の投稿でのみ目次を無効にする場合、2段階を経る必要があります。

注意: 投稿内にある.Params.tocは.Site.Params.tocを上書きします。以下の手順を経ると、その投稿内のtoc引数はfalseになります。

1. hugo.toml内のtoc引数をtrueに設定してください。

   [params]
     toc = true
   

2. toc = falseを目次を無効にしたい投稿内のfront matterに追加してください。

   ---
   title: 目次を有効にする方法
   date: 2023-05-02
   toc: false
   ---
   

目次を開いておく方法

既定の設定では、目次は閉じられた状態で表示されます。開いた状態で表示したい場合、hugo.toml内のtocOpen引数をtrueに設定してください。

[params]
  tocOpen = true

あるいは、投稿内のfront matterにtocOpen引数を追加することもできます。

---
title: 目次を有効にする方法
date: 2023-05-02
tocOpen: true
---