文件內容

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}

瀏覽文檔