Include - 包含(展示其他文件内容)

include包括简码包括当前页面内项目中的其他文件。

用法

当示例使用带有命名参数的简码时,您也可以自由使用位置或从您自己的部分调用此简码。

{{% include file="/hugo/themes/relearn/shortcodes/include/index.zh-cn.files/demo.md" %}}
{{% include "/hugo/themes/relearn/shortcodes/include/index.zh-cn.files/demo.md" %}}
{{ partial "shortcodes/include .html" (dict
  "page" .
  "file" "/hugo/themes/relearn/shortcodes/include/index.zh-cn.files/demo.md"
)}}

包含的文件甚至可以包含 Markdown,并在生成目录时考虑在内。

参数

名字 位置 默认值 注释
file 1 <empty> 要包含的文件的路径。路径解析遵循Hugo’s build-in readFile function
hidefirstheading 2 false 设置为 true时,被包含的文件第一个标题将被隐藏。这派上用场,例如。如果您包含其他独立的 Markdown 文件.

示例

任意内容

原文件:

附件

{{% include "/hugo/themes/relearn/shortcodes/include/index.zh-cn.files/demo.md" %}}

输出: H1 H1标题

H2 H2标题

H3 H3标题

这是一个Demo.md文件.

{{% include "/hugo/themes/relearn/shortcodes/include/index.zh-cn.files/demo.txt" %}}

输出: 这是一个标题

这是一个Demo.txt文件