BookMenuBoundle简单配置的实验

为了尽量还原我GitBook的界面风格，我决定使用Hugo Book主题，按照如下代码启动了Hugo，发现整体上还是蛮让人满意的，左侧为目录树，右侧为具体的每个文档内容，而且目录树部分是可以折叠的，所以我决定研究一下hugo和这个主题。

1
2
3
4
5
6
7
8



hugo new site mydocs; cd mydocs
git init
git submodule add https://github.com/alex-shpak/hugo-book themes/book
cp -R themes/book/exampleSite/content .

hugo server --minify --theme book --bind="0.0.0.0" --baseUrl="http://192.168.27.121:1313"

我遇到的第一个问题是，我无法控制目录树的显示状态。实验中我让content目录仅包含docs目录，目录树仍然可以呈现出来，这个和我理解的有很大的出入。最后经过观察，我明白了，每个docs目录下都有一个_index.md文件，这个文件决定了目录树的显示（目前的理解）。

在随后的资料中，我发现我们可以通过content/menu/index.md文件，控制右侧的目录树显示。当然如果相要这份文件生效，还需要在config.toml中进行如下配置：


[params]
  BookMenuBundle = '/menu'

这就是我对BookMenuBundle的第一次接触。我原本以为这是一个非常简单的配置，但是我随后发现Bundles似乎是一个很重要的概念，我决定研究一下这个东西。

git submodule add https://github.com/zzossig/hugo-theme-zdoc.git themes/zdoc
hugo server –minify –theme zdoc