HUGO
Menu
GitHub 87548 stars Mastodon

简介

Hugo 渲染钩子的介绍。

在将 Markdown 渲染为 HTML 时,渲染钩子会覆盖转换过程。每个渲染钩子都是一个模板,每种支持的元素类型对应一个模板:

Hugo 支持多种 内容格式,包括 Markdown、HTML、AsciiDoc、Emacs Org Mode、Pandoc 和 reStructuredText。

渲染钩子功能仅限于 Markdown。您无法为其他内容格式创建渲染钩子。

例如,考虑以下 Markdown:

[Hugo](https://www.hugodoc.com)

![kitten](kitten.jpg)

如果没有链接或图片渲染钩子,上述示例将渲染为:

<p><a href="https://www.hugodoc.com">Hugo</a></p>
<p><img alt="kitten" src="kitten.jpg"></p>

通过创建链接和图片渲染钩子,您可以更改从 Markdown 到 HTML 的转换。例如:

<p><a href="https://www.hugodoc.com" rel="external">Hugo</a></p>
<p><img alt="kitten" src="kitten.jpg" width="600" height="400"></p>

每个渲染钩子都是一个模板,每种支持的元素类型对应一个模板:

layouts/
  └── _markup/
      ├── render-blockquote.html
      ├── render-codeblock.html
      ├── render-heading.html
      ├── render-image.html
      ├── render-link.html
      ├── render-passthrough.html
      └── render-table.html

模板查找顺序允许您为每个页面 类型种类、语言和 输出格式 创建不同的渲染钩子。例如:

layouts/
├── _markup/
│   ├── render-link.html
│   └── render-link.rss.xml
├── books/
│   └── _markup/
│       ├── render-link.html
│       └── render-link.rss.xml
└── films/
    └── _markup/
        ├── render-link.html
        └── render-link.rss.xml

本节中的其余页面描述了每种类型的渲染钩子,包括示例和每个模板接收的上下文。


Last updated: January 1, 0001
Improve this page