Литерал "<" и ">" в тексте ссылки Hugo-markdown

Я использую hugo в том виде, в котором он упакован в Debian, используя средство визуализации по умолчанию (goldmark) и тему kube.

$ hugo version
Hugo Static Site Generator v0.78.2/extended linux/amd64 BuildDate: 2020-11-16T11:43:13Z

Я хотел бы включить гиперссылку на текст, содержащий угловые скобки.

что-то вроде:

[`https://example.com/<slug>`](https://example.com/)

который должен выглядеть как https://example.com/<slug> (и который работает правильно здесь, в StackOverflow).

Однако с Hugo тот же ввод отображается (как показано в браузере) как:

 <code>https://example.com/&lt;slug&gt;</code>

Кстати, приведенная выше строка имеет гиперссылку на https://example.com/, так что эта часть работает.

без `

Я был бы не против пропустить форматирование кода, но оно тоже не работает (и выдает другой, но все же неправильный вывод).

Вход:

[https://example.com/<slug>](https://example.com/)

Принимая во внимание, что вывод Hugo-рендеринга (как показано в браузере):

 https://example.com/<!-- raw HTML omitted --> 

(кстати, StackOverflow отображает это как https://example.com/, так что это все равно не работает...)

с &lt; и &gt;

Я также пробовал:

[http://example.com/&lt;slug&gt;](http://example.com/)

Но это выглядит как:

 http://example.com/&lt;slug&gt; 

?

Итак, как мне продолжить создание ящика «https://example.com/<slug>» в Hugo.


1
491
1

Ответ:

Решено

Пожалуйста, обратитесь к этому ответу https://stackoverflow.com/a/63206852. Если вы используете config.yaml, он должен включать:

markup:
  goldmark:
    renderer:
      unsafe: true

config.tomlверсия должна быть:

[markup]
  [markup.goldmark]
    [markup.goldmark.renderer]
      unsafe = true

В таком случае

[http://example.com/&lt;slug&gt;](http://example.com/)

будет работать.

Объяснение: В документации Hugo (см. https://gohugo.io/getting-started/configuration-markup#goldmark) объяснение небезопасного режима гласит, что:

По умолчанию Goldmark не отображает необработанные HTML-коды и потенциально опасные ссылки. Если у вас много встроенного HTML и/или JavaScript, вам может понадобиться включить эту функцию.

Дополнительную информацию о небезопасных символах в URL-адресах можно найти в RFC 1738, спецификация унифицированных указателей ресурсов, стр. 2.