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