Simple document template

support
1

Trying to build a really simple hugo site with basically a document section with sub-sections and a blog section. But so far all the doc based templates that I have tried fail miserabley, such as docsy.

Is there a simple and robust documentation theme that does not need additional modules, fonts and such? Basically all I need is to download or git clone the theme and add it to the hugo.toml file.

If not this would be very useful for many of us that are not interested to invest many day configuring such systems (or use docusaurus that set things up by default). Thx.

2

That’s quite vague. You can get a basic overview of available themes here: Docs | Hugo Themes

I am the maintainer of the Relearn theme and it will run without any further configuration.

I would expect the same for almost any theme, so there may be other issues involved specific to your environment.

1 Like
3

For docsy, missing fonts, fixed that, the more mod modules missing. Gave up. Same kinds of missing assets or not starting properly with some other doc related themes. I’m using v0.1333 (vanilla brew install on latest MacOSX)… Most themes have lots of features thast most likely few need. But that’s typical for themes.

Themes should also be dead-simple to install, I wish hugo had something like hugo install-theme ‘git-location’, and it also updates the hugo.toml file after update. Basic get-go is a theme that works with the basic install. Any dependencies are taken care of via the installer (possibly git depot instructions).

4

Also a lot of these kinds of dependencies could be solved as them being optional, opt-ins, rather than required from get-go.

5

BTW I looked at Relearn, looks good but I could not find an obvious way to add a blog hierarchy with latest posts shown on top, i.e. a documentation side with documents and also a way to add posts about changes in the documentation. Maybe there’s a way to hack this in…

6

way to add a blog hierarchy with latest posts shown on top, i.e. a documentation side with documents and also a way to add posts about changes in the documentation

This isn’t supported by the theme, yet. In my opinion, this is a very specific requirement. I hope you’ll find a theme that supports this.

If you have further questions about the Relearn theme, feel free to ask them in the discussions. Such specifics are of not much value to the audience of this forum.

1 Like