- Stable
3.1.7- Canary
4.0.0-alpha.10
Guide to Eleventy Projects
- Get Started
- Command Line Usage
- Debug Mode
- Incremental
- Analyzing Build Performance: How to analyze your Eleventy build to find bottlenecks.
- Add a Configuration File
- Copy Files to Output
- Add CSS, JS, Fonts: Add assets to your Eleventy project.
- Importing Content
- Configure Templates with Data
- Permalinks: Remap a template to a new output location (or prevent writing a file)
- Layouts: Wrap content in other content.
- Layout Chaining: Wrap layouts in other layouts.
- Collections: Group, reuse, and sort content in interesting ways.
- Collections API: Advanced control over collections.
- Content Dates: Assigning dates to content, using dates in front matter.
- Create Pages From Data: Iterate over a data set and create multiple output files.
- Pagination: Iterate over a data set and create multiple files from a single template.
- Pagination Navigation: Create a list of links to every paginated page on a pagination template.
- Using Data in Templates
- Template Languages
- HTML: Pre-processed by default as Liquid templates
- Markdown: Most common language for authoring content
- JavaScript: Run JavaScript to generate content
- Custom: Use your own template language
- WebC: Web components with server rendering
- Nunjucks: Popular language for generating HTML and more
- Liquid: Simple language also used by Jekyll and Shopify
- Handlebars: A logicless templating engine similar to Mustache
- Mustache: Fast, minimal template language
- EJS: Embedded JavaScript
- HAML: Shorthand syntax for HTML
- Pug: Shorthand syntax for HTML
- Sass: CSS extension language
- Virtual Templates: Create a template or layout that only lives in your configuration file.
- Overriding Languages
- Template Features
- Ignore Files
- Preprocess Content: Use preprocessors to intercept and modify content (in-memory) before Eleventy builds.
- Postprocess Content: Use Transforms to post-process content after Eleventy builds.
- Filters
url: Normalize absolute paths in your content, allows easily changing deploy subdirectories for your project.slugify:"My string"to"my-string"for permalinks.slug: Similar to but deprecated in favor ofslugifylog:console.loginside templates.get*CollectionItem: Get next or previous collection items for easy linking.inputPathToUrl: Map a template’s input path to its output URL.renderTransforms: Render project transforms on an arbitrary block of content.
- Shortcodes
- Environment Variables
- Internationalization (i18n): How to best deliver localized multi-language content.
- Watch Files and Dev Servers
- Common Pitfalls: Some common problems that people run into.
- Advanced
- Release History
- Programmatic API
- Configuration Events
- Order of Operations: How Eleventy works internally.