Custom page selection

[eine]

In the README it's read that:

If you want a different page selection, please provide your own layouts/index.html template.

However, there is no layouts/index.html file in the theme. The logic seems to be defined in layouts/_default/baseof.html. Is the comment correct or is it outdated?

[bep]

No, that statement is still correct.

[eine]

Thanks. It seems that I need to revisit hugo's templating/layout engine...

[bep]

A little longer explanation:

• A template in the project with the same name in the project will always win over the theme version
• layouts/index.html will win over layouts/_default/list.html for the home page.

So, creating either layouts/index.html or layouts/_default/list.html in your project with your custom logic will work.

[eine]

Thanks! The point is that I used hugo quite some time ago, when baseof didn't exist (I believe), sections where limited to a single level IIRC, etc. Later, I saw that it was all reworked to support more complex and nested site layouts (which was cool to have). Now, this specific theme seems to use some of the latest features: most of the logic is defined in functions (https://github.com/bep/docuapi/tree/master/layouts/partials/funcs), which I had not used; the theme itself is a go module/package that imports other go modules, which feels awkward; and, overall, it is a single page site. So, it is just much content to digest. I need to take it slowly...

FTR, I am not documenting an API, but a project composed of a CLI tool (golang) and a GitHub Action (Typescript): https://eine.github.io/issue-runner/#introduction. I took this theme because I think it is probably the best available hugo theme for docs with lots of quotes and code examples. However, I am aware that it is currently very optimized to be a single page. It will need some work to generate sections.