Добавьте оглавление к теме hyde-hyde в Hugo

Question

Я использую тему hyde-hyde для своего веб-сайта с Хьюго ( https://github.com/htr3n/hyde-hyde), и я не могу найти способ добавить таблицу для содержимого в свои сообщения, особенно длинные. Есть ли простой способ сделать это с этой темой?

Благодарю.

Answer 1

ОБНОВЛЕНО 2018-09-30:

Я неправильно прочитал оригинальный вопрос о содержании и вместо этого дал ответ на таблицы в Markdown.

Что касается оглавления, то, по сути, существует два подхода:

а) Использование поддержки Hugo для оглавления и добавление некоторых правил CSS для стилизации оглавления по вашему желанию.

б) Использование внешних библиотек, таких как Tocbot, которые могут сканировать содержимое HTML и извлекать заголовки для создания оглавления. Tocbot очень мощный и настраиваемый.

В частности в hyde-hydeВы можете сделать следующее для достижения оглавления:

а) Добавить {{ .TableOfContents }} например, в https://github.com/htr3n/hyde-hyde/blob/master/layouts/partials/page-single/content.html

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

б) Стиль оригинального сгенерированного Хьюго оглавления с корневым элементомnav#TableOfContents, например

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

Далее вы можете исследовать пример кода здесь, где я разработал складное оглавление.

---

Я авторhyde-hydeтак что, надеюсь, я могу взвесить некоторые предложения.

hyde-hydeэто простая тема, используемая gohugo для создания статических веб-страниц (HTML/CSS/JS) из содержимого Markdown (MD). Так что вам нужно добавить таблицы в ваши файлы Markdown.

Обратите внимание, что таблицы не указаны в исходной уценке, но поддерживаются во многих вариантах, таких как MultiMarkdown (MMD) или Github Flavored Markdown (GFM).

Другой потенциальный подход заключается в использовании встроенного HTML, поддерживаемого Markdown, для добавления <table>...</table> как хотите. Это работает лучше, если вам нужны сложные таблицы (например, с rowspan или colspan), как вы можете видеть здесь.

Вышеупомянутые методы могут быть использованы и с другими темами Гюго. В любом случае, Хьюго хорошо справляется со столами.

Answer 2

Я новичок в gohugo, поэтому я не могу предоставить точную поддержку. Но похоже, что gohugo поставляется со встроенной системой для добавления оглавлений к сообщениям. Вот документация gohugo для этой функции: https://gohugo.io/content-management/toc/

Я не уверен, где и как будет отображаться оглавление в публикации, опубликованной с темой Hyde-Hyde. Автор темы может иметь некоторое представление там.