简介
Hugo 渲染钩子的介绍。
在将 Markdown 渲染为 HTML 时,渲染钩子会覆盖转换过程。每个渲染钩子都是一个模板,每种支持的元素类型对应一个模板:
Hugo 支持多种 内容格式,包括 Markdown、HTML、AsciiDoc、Emacs Org Mode、Pandoc 和 reStructuredText。
渲染钩子功能仅限于 Markdown。您无法为其他内容格式创建渲染钩子。
例如,考虑以下 Markdown:
[Hugo](https://www.hugodoc.com)
如果没有链接或图片渲染钩子,上述示例将渲染为:
<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本节中的其余页面描述了每种类型的渲染钩子,包括示例和每个模板接收的上下文。