将目录添加到Hugo中的hyde-hyde主题

Question

我在雨果(https://github.com/htr3n/hyde-hyde)的网站上使用了海德-海德主题，但我想不出一种方法来为我的帖子添加一个目录，特别是那些很长的帖子。有没有一种简单的方法来处理这个主题？

谢谢。

Answer 1

已更新2018-09-30

我误读了关于TOC的原始问题，而是在Markdown中给出了一个表的答案。

关于目录，基本上有两种方法：

a)使用Hugo support for TOC并添加一些CSS规则来设置目录样式

b)使用可以扫描超文本标记语言内容并提取标题以创建目录的外部库，例如Tocbot。Tocbot是非常powerful and configurable的。

特别是在hyde-hyde中，您可以执行以下操作来实现目录：

a)在中添加{{ .TableOfContents }}，例如

{{ if .Site.Params.toc }}
    {{ .TableOfContents }}
{{ end }}

b)使用根元素nav#TableOfContents对原始雨果生成的目录进行样式设置，例如

#TableOfContents > ul {
  list-style-type: none;
  padding-left: 0;
}
#TableOfContents > ul > li ul {
  list-style-type: none;
  padding-left: 1em;
}

您可以进一步研究示例代码here，我在其中开发了一个可折叠的目录。

我是hyde-hyde的作者，所以希望我能提出一些建议。

Markdown是gohugo用来从Markdown (MD)内容生成静态网页( hyde-hyde /CSS/JS)的一个主题。因此，您需要在Markdown文件中添加表。

请注意，表不是在original Markdown中指定的，但在MultiMarkdown (MMD)或Github Flavored Markdown (GFM)等许多变体中都受支持。

另一种可能的方法是使用Markdown支持的内联超文本标记语言来添加你想要的<table>...</table>。如果您需要复杂的表(例如，使用rowspan或colspan)，这会更好地工作，正如您可以看到here。

上述方法也可以用于其他Hugo主题。无论哪种方式，Hugo都可以很好地处理表格。

Answer 2

我刚接触gohugo，所以我不能提供精确的支持。但是gohugo似乎有一个内置的系统，可以将目录添加到帖子中。以下是该特性的gohugo文档：https://gohugo.io/content-management/toc/

我不知道TOC会出现在以海德-海德为主题的帖子中。这个主题的作者可能会有一些洞察力。