Documentation Pages
Using Data #
Data can be used on a template from multiple different sources.
Sources of Data #
The order of priority for sources of data is (from highest priority to lowest):
- Front Matter Data
- Template Data Files
- Directory Data Files (and ascending Parent Directories)
- Global Data Files
Eleventy Provided Data Variables #
Here are a few data values we supply to your page that you can use in your templates:
pkg
: The local project’spackage.json
values.pagination
, when enabled using pagination in front matter. Read more about Pagination.collections
: Lists of all of your content, grouped by tags. Read more about Collectionspage
: Has information about the current page. See code block below forpage
contents. For example,page.url
is useful for finding the current page in a collection. Read more about Collections (look at Example: Navigation Links with anactive
class added for on the current page).
page
Variable Contents: #
let page = {
// URL can be used in <a href> to link to other templates
url: "/current/page/myFile/",
// New in Eleventy v0.3.4
// Mapped from inputPath, useful for permalinks
fileSlug: "myFile",
// JS Date Object for current page (used to sort collections)
date: new Date(),
// The path to the original source file for the template
// Note: this will include your input directory path!
inputPath: "./current/page/myFile.md",
// Eleventy internals
// You probably won’t use `outputPath`: `url` is more useful.
// Depends on your output directory (the default is _site)
outputPath: "./_site/current/page/myFile/index.html"
};
fileSlug
#
New in v0.3.4 The fileSlug
variable is mapped from inputPath and is useful for creating your own clean permalinks.
inputPath | Resulting fileSlug |
---|---|
"2018-01-01-myFile.md" | "myFile" |
"myDir/myFile.md" | "myFile" |
fileSlug
returns information on the parent directory if the file is an index
template:
inputPath | Resulting fileSlug |
---|---|
"index.md" | "" (empty) |
"myDir/index.md" | "myDir" |
"myDir/2018-01-01-index.md" | "myDir" |
date
#
The date associated with the page. Defaults to the content’s file created date but can be overridden. Read more at Content Dates.