File

默认情况下，并非所有页面都有对应的文件，包括顶层 section 页、分类法页与术语页。顾名思义，文件不存在时你无法取得文件信息。

要让上述某类页面拥有对应文件，请在相应目录中创建 _index.md 文件。例如：

content/
└── books/
    ├── _index.md  <-- the top-slevel section page
    ├── book-1.md
    └── book-2.md

方法

在 File 对象上使用这些方法。

BaseFileName

（string）文件名，不含扩展名。

{{ with .File }}
  {{ .BaseFileName }}
{{ end }}

ContentBaseName

（string）如果该页面是分支包或叶子包，则返回所在目录的名称，否则返回 TranslationBaseName。

{{ with .File }}
  {{ .ContentBaseName }}
{{ end }}

Dir

（string）文件路径中去掉文件名后的部分，相对于 content 目录。

{{ with .File }}
  {{ .Dir }}
{{ end }}

Ext

（string）文件扩展名。

{{ with .File }}
  {{ .Ext }}
{{ end }}

Filename

（string）文件的绝对路径。

{{ with .File }}
  {{ .Filename }}
{{ end }}

IsContentAdapter

（bool）报告该文件是否为内容适配器。

{{ with .File }}
  {{ .IsContentAdapter }}
{{ end }}

LogicalName

（string）文件名。

{{ with .File }}
  {{ .LogicalName }}
{{ end }}

Path

（string）文件路径，相对于 content 目录。

{{ with .File }}
  {{ .Path }}
{{ end }}

Section

（string）该文件所在顶层 section 的名称。

{{ with .File }}
  {{ .Section }}
{{ end }}

TranslationBaseName

（string）文件名，不含扩展名与语言标识符。

{{ with .File }}
  {{ .TranslationBaseName }}
{{ end }}

UniqueID

（string）.File.Path 的 MD5 哈希值。

{{ with .File }}
  {{ .UniqueID }}
{{ end }}

示例

假设多语言项目的内容结构如下：

content/
├── news/
│   ├── b/
│   │   ├── index.de.md   <-- leaf bundle
│   │   └── index.en.md   <-- leaf bundle
│   ├── a.de.md           <-- regular content
│   ├── a.en.md           <-- regular content
│   ├── _index.de.md      <-- branch bundle
│   └── _index.en.md      <-- branch bundle
├── _index.de.md
└── _index.en.md

在英文站点中：

防御式编码

站点上有些页面可能没有对应文件，例如：

• 顶层 section 页
• 分类法页
• 术语页

没有对应文件时，一旦访问 .File 属性，Hugo 就会抛出错误。为此要编写防御式代码，先检查文件是否存在：

{{ with .File }}
  {{ .ContentBaseName }}
{{ end }}