jwogrady Working notes on tools, and why they earn their place

Every tutorial I can find predates the directory I need

resolves JRN 26-009

The old structure still works, which is why nobody tells you.

Almost every Hugo tutorial says to put templates in layouts/_default/. Almost every Hugo tutorial is describing a structure that changed in 0.146.

Tutorials say Actually
layouts/_default/baseof.html layouts/baseof.html
layouts/_default/single.html layouts/page.html
layouts/_default/list.html layouts/list.html
layouts/partials/ layouts/_partials/

Here’s what makes this genuinely nasty rather than merely annoying: _default/ still works. Follow a three-year-old tutorial and you get a site that builds, renders and looks fine. Nothing anywhere tells you that you’ve just learned a structure on its way out.

I’m on 0.166. hugo version before trusting any layout advice — including this entry, whose only real claim to credibility is the date on it.