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

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

0 голосов
/ 11 июня 2018

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

Спасибо.

Ответы [ 2 ]

0 голосов
/ 20 сентября 2018

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

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

0 голосов
/ 08 июля 2018

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

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

Относительно Оглавление , по сути, существует два подхода:

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

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

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

a) Добавить {{ .TableOfContents }} к layouts / partials / page-single / content.html , например 

{{ 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;
}

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

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

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

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

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

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

...