ファイル変数

変数

.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) ページがブランチバンドルまたはリーフバンドルの場合は、それを含むディレクトリの名前、それ以外の場合は .TranslationBaseName。

.File.Filename

(string) 絶対ファイルパス。

.File.UniqueID

(string) .File.Path の MD5 ハッシュ。

例

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 は警告をスローします。 たとえば、以下のような警告です。

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

防御的にコーディングするには、以下のようにします。

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