| title |
linktitle |
description |
date |
publishdate |
lastmod |
categories |
keywords |
draft |
menu |
weight |
sections_weight |
aliases |
toc |
| File Variables |
|
You can access filesystem-related data for a content file in the `.File` variable. |
2017-02-01 |
2017-02-01 |
2017-02-01 |
|
|
false |
| docs |
| parent |
weight |
| variables |
40 |
|
|
40 |
40 |
| /variables/file-variables/ |
|
false |
{{% note "Rendering Local Files" %}}
For information on creating shortcodes and templates that tap into Hugo's file-related feature set, see Local File Templates.
{{% /note %}}
The .File object contains the following fields:
- .File.Path
- the original relative path of the page, relative to the content dir (e.g.,
posts/foo.en.md)
- .File.LogicalName
- the name of the content file that represents a page (e.g.,
foo.en.md)
- .File.TranslationBaseName
- the filename without extension or optional language identifier (e.g.,
foo)
- .File.ContentBaseName
- is a either TranslationBaseName or name of containing folder if file is a leaf bundle.
- .File.BaseFileName
- the filename without extension (e.g.,
foo.en)
- .File.Ext
- the file extension of the content file (e.g.,
md); this can also be called using .File.Extension as well. Note that it is only the extension without ..
- .File.Lang
- the language associated with the given file if Hugo's Multilingual features are enabled (e.g.,
en)
- .File.Dir
- given the path
content/posts/dir1/dir2/, the relative directory path of the content file will be returned (e.g., posts/dir1/dir2/). Note that the path separator (\ or /) could be dependent on the operating system.
- .File.UniqueID
- the MD5-checksum of the content file's path.
efa74c5c6e