Introduction to Hugo Templating
Hugo uses Go’s
html/template
and text/template
libraries as the basis for the templating.
Read More »Hugo's Lookup Order
Hugo searches for the layout to use for a given page in a well defined order, starting from the most specific.
Read More »
Custom Output Formats
Hugo can output content in multiple formats, including calendar events, e-book formats, Google AMP, and JSON search indexes, or any custom text format.
Read More »
Base Templates and Blocks
The base and block constructs allow you to define the outer shell of your master templates (i.e., the chrome of the page).
Read More »
Lists of Content in Hugo
Lists have a specific meaning and usage in Hugo when it comes to rendering your site homepage, section page, taxonomy list, or taxonomy terms list.
Read More »
Homepage Template
The homepage of a website is often formatted differently than the other pages. For this reason, Hugo makes it easy for you to define your new site’s homepage as a unique template.
Read More »
Section Page Templates
Templates used for section pages are lists and therefore have all the variables and methods available to list pages.
Read More »
Taxonomy Templates
Taxonomy templating includes taxonomy list pages, taxonomy terms pages, and using taxonomies in your single page templates.
Read More »
Single Page Templates
The primary view of content in Hugo is the single view. Hugo will render every Markdown file provided with a corresponding single template.
Read More »
Content View Templates
Hugo can render alternative views of your content, which is especially useful in list and summary views.
Read More »
Data Templates
In addition to Hugo’s built-in variables, you can specify your own custom data in templates or shortcodes that pull from both local and dynamic sources.
Read More »
Partial Templates
Partials are smaller, context-aware components in your list and page templates that can be used economically to keep your templating DRY.
Read More »
Create Your Own Shortcodes
You can extend Hugo’s built-in shortcodes by creating your own using the same templating syntax as that for single and list pages.
Read More »
Local File Templates
Hugo’s
readerDir
and readFile
functions make it easy to traverse your project’s directory structure and write file contents to your templates.
Read More »Custom 404 Page
If you know how to create a single page template, you have unlimited options for creating a custom 404.
Read More »
Menu Templates
Menus are a powerful but simple feature for content management but can be easily manipulated in your templates to meet your design needs.
Read More »
Pagination
Hugo supports pagination for your homepage, section pages, and taxonomies.
Read More »
RSS Templates
Hugo ships with its own RSS 2.0 template that requires almost no configuration, or you can create your own RSS templates.
Read More »
Sitemap Template
Hugo ships with a built-in template file observing the v0.9 of the Sitemap Protocol, but you can override this template if needed.
Read More »
Robots.txt File
Hugo can generate a customized robots.txt in the same way as any other template.
Read More »
Internal Templates
Hugo ships with a group of boilerplate templates that cover the most common use cases for static websites.
Read More »
Alternative Templating Languages
In addition to Go templates, Hugo supports the powerful Ace templating from @yosssi and Amber templating from @eknkc.
Read More »
Template Debugging
You can use Go templates’
printf
function to debug your Hugo templates. These snippets provide a quick and easy visualization of the variables available to you in different contexts.
Read More »