@michael_henderson I’ve been quite busy and didn’t have the chance to check the whole tutorial, but this is my feedback. I hope it’s useful.
Updates
Warning on missing layouts has improved
Hugo 0.14 can tell which page the layout is for:
WARN: 2015/07/21 Unable to locate layout for homepage: [index.html _default/list.html]
WARN: 2015/07/21 Unable to locate layout for 404 page: [404.html]
Index template
The second sentence here is out-of-date:
The file, layouts/index.html, is used to generate the HTML for the home page. The Hugo documentation says that this is the only required template, but that depends.
Changes
Error: Unable to Cast to map
In this paragraph:
The “new” command uses an archetype to create the post file. Hugo created an empty default archetype file, but that causes an error when there’s a theme. For me, the workaround was to create an archetypes file specifically for the post type.
I’d explain that this error occurs because the archetype available is empty.
And optionally suggest editing the default archetype instead of creating a
new one. Changing the default one is also the approach used with the single
template later on in the tutorial. Even better: show that adding content to the default fixes the error and then suggest using a specific archetype for posts (while the default may be used for normal pages like about).
Partials
Hugo searches for them along a TODO defined search path.
Did you forget removing the TODO?
Or did you mean to add a commented TODO to add some more content in the future?
Lists
In these listings:
find themes -type f | xargs ls -l
I would omit the -l to avoid line breaks and make it more readable, at least
where this option is not needed.
MetaDataFormat
Is this really necessary? It seems redundant as toml is the default:
MetaDataFormat = "toml"
Add an example of section view
You showed how to create a list of page objects in the homepage. I think that also an example of how to list content types in a section would be useful and within the scope of the tutorial (it’s a very common need). This discussion proves that it’s not that easy for a new user.