文件变量

File Variables - 文件变量

https://gohugo.io/variables/files/

Use File variables to access file-related values for each page that is backed by a file.

使用文件变量来访问由文件支持的每个页面的与文件相关的值。

​ 使用文件变量来访问每个由文件支持的页面的与文件相关的值。

变量

​ .File.Path、.File.Dir 和 .File.Filename 中的路径分隔符（斜杠或反斜杠）取决于操作系统。

.File.Path

​ (string) 文件路径，相对于 content 目录。

.File.Dir

​ (string) 不包括文件名的文件路径，相对于 content 目录。

.File.LogicalName

​ (string) 文件名。

.File.BaseFileName

​ (string) 不包括扩展名的文件名。

.File.TranslationBaseName

​ (string) 不包括扩展名和语言标识符的文件名。

.File.Ext

​ (string) 文件扩展名。

.File.Lang

​ (string) 与给定文件相关联的语言。

.File.ContentBaseName

​ (string) 如果页面是一个分支或叶子 bundle，则为包含该页面的目录名称，否则为 .TranslationBaseName。

.File.Filename

​ (string) 绝对文件路径。

.File.UniqueID

​ (string) .File.Path 的 MD5 哈希值。

示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

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

​ 使用上述内容结构，英文页面的 .File 对象包含以下属性：

防御性编程

​ 站点上的某些页面可能没有文件支持。例如：

• 顶级章节页面
• 分类法页面
• 条目页面

​ 如果您尝试访问 .File 属性而没有支持文件，Hugo 将抛出一个警告。例如：

1

WARN .File.ContentBaseName on zero object. Wrap it in if or with...

​ 为了防御性编程：

1
2
3

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

另请参阅

• Babel
• Hugo 模板简介
• 本地文件模板
• 菜单变量
• 高亮