なぜか動かなくて2時間くらい溶かしたので備忘録。
まず、以下のようにfront matterにbookCollapseSection: true
を書いておくとそのセクションはメニュー上でFoldされる。
--- bookCollapseSection: true --- # TitleOfSectionThatShouldBeFolded
これで動けばそれでよいのだが、動かなかった。
ところで、hugo-bookはdocs/
の横にmenu/
を置いてmenu/index.md
に箇条書きでファイルへのリンクを書いていくとメニューを作れる。
$ tree . . └── content ├── docs └── menu └── index.md
このindex.md
を作った状態で、config.toml
でBookMenuBundle = '/menu'
と設定していると、bookCollapseSection: true
をしているセクションでもfoldされなくなる。
[params] BookMenuBundle = '/menu' # これが原因
bookCollapseSection
は自動生成のときしか考慮されないオプションということなのか。
メニューでの表示タイトルは front metterのtitle
で指定でき、メニューでの表示順は同じくfront matterのweight
で指定できる。メニュー上では表示しないようにするのも、bookHidden: true
でできる。なのでメニューでの表示をいじりたいときはfront matterで指定する方が無難そうだ。
ここまで書いてからドキュメントを見に行ったところ、自動生成の方をFile tree menu
、自分で書く方をLeaf bundle menu
と呼んでいるようだ。このコメントの意味が今ようやくわかった。Issue commentでだが、Leaf bundle menu
ではbookCollapseSection
は使えないと明言されている。
ちゃんと全部ドキュメント読んでおけばよかったな。お前はいつもそうだ。