Нотация Markdown в Hugo

В этом разделе показано, как писать рукописи в формате Markdown в Hugo.

Базовый Markdown

Для получения дополнительной информации о том, как писать в формате Markdown, смотрите Hugo — Руководство по Markdown.

Назначение классов CSS элементам, написанным в Markdown

Для получения дополнительной информации смотрите attribute в Goldmark — Hugo. Ниже приведен обзор.

  1. Поместите следующее в /config.toml.

    [markup.goldmark.parser.attribute]
    block = true
    
  2. Пишите имена классов, такие как {.classA .classB} на следующей строке блочного элемента, написанного в Markdown в исходном документе.

    * Fruit
      * Apple
      * Orange
      * Banana
      {.fruits}
    * Dairy
      * Milk
      * Cheese
      {.dairies}
    {.list}
    

Писать HTML напрямую вместо Markdown

Для получения дополнительной информации смотрите unsafe в Goldmark — Hugo. Обзор приведен ниже.

  1. Поместите следующее в /config.toml.

    [markup.goldmark.renderer]
    unsafe = true
    
  2. Напишите 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/

Оцените статью
devanswers.ru
Добавить комментарий