I dug through documentation, themes and various blog posts.
But I have really hard time getting started with hugo.
Maybe you guys help me out a bit.
To understand the whole type/kind/section/layout story I started a small test project:
content/
├── _index.md
├── contact.md
└── post
├── slug1
│ └── index.md
└── slug2
└── index.md
Nothing fancy. A home page, a contact page and two blog posts. The posts have tags bug no categories. I have not overridden any types or layouts.
The theme has nothing but files that name their name like default list or page single.
themes/tcurdt/layouts/
├── _default
│ ├── baseof.html
│ ├── list.html
│ └── single.html
├── index.html
├── page
│ ├── list.html
│ └── single.html
├── partials
├── post
│ ├── list.html
│ └── single.html
└── taxonomy
├── list.html
└── single.html
The config is essentially nothing more than
theme = "tcurdt"
[taxonomies]
tag = "tags"
And this is what gets produced - with some annotations:
public/
├── contact
│ └── index.html (page single, clear)
├── index.html (post list, why not page list?)
├── index.xml (want: feed.xml of just posts)
├── post
│ ├── index.html (post list, want: /archive.html)
│ ├── index.xml (want: /feed.xml)
│ ├── slug1
│ │ └── index.html (post single, clear)
│ └── slug2
│ └── index.html (post single, clear)
├── sitemap.xml (ok)
└── tags
├── index.html (taxonomy list, clear)
├── index.xml (want: removed)
├── tag1
│ ├── index.html (taxonomy list, why not taxonomy single)
│ └── index.xml (want: removed)
├── tag2
│ ├── index.html (taxonomy list, why not taxonomy single)
│ └── index.xml (want: removed)
└── tag3
├── index.html (taxonomy list, why not taxonomy single)
└── index.xml (want: removed)
Why is the home index.html a post list? I could understand page list. But given there is a layout/index.html - why isn’t that being used? According to the docs I thought it should.
I came across multiple threads and questions about the index.xml files. People are asking the same thing. How to turn those off but just keep a single feed?
The disableKinds route is a bit unclear to me. Because when I do:
disableKinds = ['RSS']
then of course there are no feeds at all.
How I got this kind of working was to use:
[outputs]
home = ["HTML"]
section = ["HTML", "RSS"]
taxonomy = ["HTML"]
taxonomyTerm = ["HTML"]
But I don’t see a way to specify per invidual section/type whether I want the RSS or not. Is there a way to define this per type?
Seems like this is the only way to switch to Atom?
How to make Hugo (0.20+) generate an Atom feed instead of RSS · GitHub
GitHub - lingxz/er: 🐌 a hugo theme
Which seems to disable RSS and bring its own atom template instead. Which also seems to help to define the target URL of the feed. Taling of which…
Can the target URL of “automatic” pages like RSS be changed/aliased somehow?
Or is there another way to change the feed URL for the normal RSS (besides creating another custom output format)?
It’s clear that tags/index.html uses a taxonomy list layout - but why is tags/tag1/index.html a list too? Because it lists pages/posts? Shouldn’t it then be pages list not taxonomy list?
To me tags/index.html and tags/tag1/index.html do not necessarily should have the same layout.
I hope my questions did not turn into a long rant - but I’d appreciate some insights 
cheers,
Torsten
PS: I am running hugo 0.41 darwin/amd64
PPS: Is there a chat somewhere? IRC? Gitter?
