Lost in taxonomies and indexes. Are both still valid concepts?

Every time I try to look at the examples and the documentation I get totally confused.

At https://github.com/spf13/hugo/tree/master/docs/content I can see a taxonomies folder inside content/ (but not in layout/). In http://gohugo.io/overview/source-directory/ I see a taxonomies folder inside layouts (but not in content/).

In http://gohugo.io/overview/configuration/ (config.yaml) I find

  category = "categories"
  tag = "tags"

but then in http://gohugo.io/taxonomies/usage/ (also config.yaml) I read

  tag: "tags"
  category: "categories"

Is maybe indexes the old name for taxonomies? Or are they two different things?

I’m opening http://localhost:1313/tags/boat/ but I get an empty page with a link to index.xml. Which file inside layout/ should I create or modify to alter the result produced by /tags/boat/ ?

Is there a debug mode that would inject in each html file as a comment the name of the template used to create it? It would be helpful.

Ok, I discovered that if I replace [indexes] by [Taxonomies], I create list.html and terms.html inside layouts/_default/, and I click SHIFT+reload, it works.

  1. Is it possible to send no-cache headers when in --watch mode?
  2. Should mentions of “indexes” be replaced with “Taxonomies” in the documentation?
  3. In the second link I shared, I guess taxonomies should be replaced by taxonomy.

Indexes is the original name of taxonomies. “indexes” shouldn’t be in the documentation anywhere. If it is, that’s a mistake that needs to be fixed.

However, index.html is still a very valid term (across the Internet) and used in a few places.

  1. Yes, but it’s not that simple. People use that in production.
  2. Yes
  3. I believe ‘taxonomies’ is correct there, but I’m not quite sure which link you meant.
  1. I see. I just have to remember clicking Shift+reload, otherwise I get the cached page sometimes and I wonder why things don’t work. In Chromium I can disable the cache for localhost, maybe I should use that.
  2. 1 x [indexes], 2 x indexes.html (maybe it’s terms.html?), 6 x /indexes/ (in paths). But I don’t know which ones are right and which ones not.
  3. I mean taxonomies should be taxonomy in the documentation

1 Like

taxonomies should be taxonomy

The documentation still shows this. It should be taxonomy instead of taxonomies.

It is helps anyone else, this is what I have right now after doing the indexes -> taxonomies update in my config.toml and file organization. And it works.