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
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
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?
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?
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
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
PS: I am running hugo 0.41 darwin/amd64
PPS: Is there a chat somewhere? IRC? Gitter?