文件内容

2023年9月3日 1 分钟阅读短代码文档文件文件内容

用于从页面资源文件、站点资源文件和项目文件读取内容的短代码，其对重用内容十分有用，比如代码片段。

赞助

成为我们的资助者或赞助商，以支持我们的工作。

本页内容

赞助商

文件选择顺序

页面资源文件。
站点资源文件。
项目文件。

语法

1{{< file-content "/path/to/file" >}}

参数

`name`

索引	名称	类型	必填	默认值	版本	示例
`#0`	`name`	`string`	✓	-	-	-

文件名。

示例

读取页面资源文件

content/docs/helpers/file-content/data/foo.txt

  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="ln">1</span><span class="cl">bar

源码

1{{< file-content "data/foo.txt" >}}

结果

bar

读取站点资源文件

assets/data/hello.js

  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-js" data-lang="js"><span class="line"><span class="ln">1</span><span class="cl"><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">&#39;Hello world!&#39;</span><span class="p">)</span>

源码

1{{< file-content "data/hello.js" >}}

结果

读取项目文件

static/ads.txt

  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="ln">1</span><span class="cl">google.com, pub-7827859788508375, DIRECT, f08c47fec0942fa0

源码

1{{< file-content "static/ads.txt" >}}

结果

google.com, pub-7827859788508375, DIRECT, f08c47fec0942fa0

读取不存在的文件

源码

1{{< file-content "static/invalid.txt" >}}

结果

与其他短代码组合

以 Bootstrap 配置切换为例。

content/docs/helpers/file-content/data/hugo.yaml

  <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="ln">1</span><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="l">Site Title</span><span class="w">

源码

1{{< bs/config-toggle hugo >}}
2{{< file-content "data/hugo.yaml" >}}
3{{< /bs/config-toggle >}}

结果

hugo.yaml

1title: Site Title

hugo.toml

1title = 'Site Title'

hugo.json

1{
2   "title": "Site Title"
3}

浏览文档