表格渲染钩子
New in v0.134.0
上下文
表格渲染钩子模板接收以下上下文：
属性
(map) 如果按如下方式配置站点，则可以使用Markdown 属性：
hugo.
markup:
goldmark:
parser:
attribute:
block: true
[markup]
[markup.goldmark]
[markup.goldmark.parser]
[markup.goldmark.parser.attribute]
block = true
{
"markup": {
"goldmark": {
"parser": {
"attribute": {
"block": true
}
}
}
}
}
序号
(int) 页面上表格的基于零的序号。
页面
(page) 对当前页面的引用。
页面内部
(page) 通过 RenderShortcodes 方法嵌套页面的引用。 查看详情 。
位置
(string) 表格在页面内容中的位置。
表头
(slice) 表格标题行的切片，其中每个元素都是表格单元格的切片。
表体
(slice) 表格正文行的切片，其中每个元素都是表格单元格的切片。
表格单元格
THead 和 TBody 方法返回的切片中每个表格单元格具有以下字段：
对齐方式
(string) 表格单元格内文本的对齐方式， left 、 center 或 right 之一。
文本
(template.HTML) 表格单元格内的文本。
示例
在其默认配置中，Hugo 根据 GitHub Flavored Markdown 规范 渲染 Markdown 表格。要创建一个执行相同操作的渲染钩子：
layouts/_default/_markup/render-table.html
<table
{{- range $k, $v := .Attributes }}
{{- if $v }}
{{- printf " %s=%q" $k $v | safeHTMLAttr }}
{{- end }}
{{- end }}>
<thead>
{{- range .THead }}
<tr>
{{- range . }}
<th
{{- with .Alignment }}
{{- printf " style=%q" (printf "text-align: %s" .) | safeHTMLAttr }}
{{- end -}}
>
{{- .Text -}}
</th>
{{- end }}
</tr>
{{- end }}
</thead>
<tbody>
{{- range .TBody }}
<tr>
{{- range . }}
<td
{{- with .Alignment }}
{{- printf " style=%q" (printf "text-align: %s" .) | safeHTMLAttr }}
{{- end -}}
>
{{- .Text -}}
</td>
{{- end }}
</tr>
{{- end }}
</tbody>
</table>PageInner 详情
New in v0.125.0PageInner 的主要用例是解析相对于已包含的 Page 的链接和 页面资源 。例如，创建一个“include”短代码，从多个内容文件组合一个页面，同时保留脚注和目录的全局上下文：
layouts/shortcodes/include.html
{{ with .Get 0 }}
{{ with $.Page.GetPage . }}
{{- .RenderShortcodes }}
{{ else }}
{{ errorf "The %q shortcode was unable to find %q. See %s" $.Name . $.Position }}
{{ end }}
{{ else }}
{{ errorf "The %q shortcode requires a positional parameter indicating the logical path of the file to include. See %s" .Name .Position }}
{{ end }}然后在你的Markdown中调用短代码：
content/posts/p1.md
{{% include "/posts/p2" %}}在渲染 /posts/p2 期间触发的任何渲染钩子将获得：
- 调用
Page时为/posts/p1 - 调用
PageInner时为/posts/p2
如果与 PageInner 不相关，则 PageInner 回退到 Page 的值，并始终返回值。
作为一个实际示例，Hugo的嵌入式链接和图像渲染钩子使用 PageInner 方法来解析Markdown链接和图像目标。查看每个源代码：