How to Use a Specific Layout for an Article in Hugo
Sometimes you just want to use an unique template for a post or list. In hugo there is a template lookup order in which the template files are getting loaded but you can also specify the exact template that you want. The hugo docs explain how content organization works.
Using Frontmatter Layout
Single posts for example use the layouts/_default/single.html template by default to show a single content page. But if you want a specific template you can use frontmatter for that.
Consider the following structure: content/about/index.md.
This would render the about page under /about using the default layouts/_default/single.html template.
Now in the frontmatter of that post you can use layout: "about" for example. What this line tells hugo is that it should look into the layouts/_default folder and search for a about.html template.
This is an example from my about page. It uses the layouts/_default/about.html as template.
| |
Using Frontmatter Type
Each content file/post gets a default content type assigned. Usually this is the name of the subfolder in content where the post lives in. So for example a content/blog/php.md would get the type blog.
There is a special case though. All files directly under content are of type page and also all index files (but not the ones with underscore) in subfolders are of type page as well. Keep that in mind when specifying a layout.
You can also specify the content type in frontmatter. This simply tells hugo which layouts subfolder it should use to load the templates from. For example type: "notes" would make hugo search in the layouts/notes folder.
Combining both type and layout you can precisely define what template to use. The template path for this example is: layouts/special/super.html.
| |