В этом разделе показано, как писать рукописи в формате Markdown в Hugo.
Базовый Markdown
Для получения дополнительной информации о том, как писать в формате Markdown, смотрите Hugo — Руководство по Markdown.
Назначение классов CSS элементам, написанным в Markdown
Для получения дополнительной информации смотрите attribute
в Goldmark — Hugo. Ниже приведен обзор.
-
Поместите следующее в
/config.toml
.[markup.goldmark.parser.attribute] block = true
-
Пишите имена классов, такие как
{.classA .classB}
на следующей строке блочного элемента, написанного в Markdown в исходном документе.* Fruit * Apple * Orange * Banana {.fruits} * Dairy * Milk * Cheese {.dairies} {.list}
Писать HTML напрямую вместо Markdown
Для получения дополнительной информации смотрите unsafe
в Goldmark — Hugo. Обзор приведен ниже.
-
Поместите следующее в
/config.toml
.[markup.goldmark.renderer] unsafe = true
-
Напишите HTML для рукописи.
* Fruit ← I can write Markdowns and ... * Dairy {.list} <ul class="list"> ← I can write HTML too. <li>Fruit</li> <li>Dairy</li> </ul>
Написание с помощью шорткодов
Шорткоды — это предварительно созданные HTML-сниппеты Hugo и различных тем.
Они включают в себя вставку видео и статей Instagram/Twitter, которые трудно выразить только с помощью Markdown, и генерацию ссылок из путей рукописи, требующих серверной обработки. Подробности смотрите ниже.
Поставщик шорткодов | URL |
---|---|
Hugo | https://gohugo.io/content-management/shortcodes/#what-a-shortcode-is |
Тема:Красивый Хьюго | https://github.com/halogenica/beautifulhugo#extra-shortcodes |
Тема:Docsy | https://www.docsy.dev/docs/adding-content/shortcodes/ |