簡介
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本節中的其余頁面描述了每種類型的渲染鉤子,包括示例和每個模板接收的上下文。