Using doks theme with hugo serve blank page

[wphromma]

Hi, I am new to Hugo, and I just follow the get started guide from https://gohugo.io/getting-started/quick-start/

I can get the theme working with the theme ananke from the guide. However, I want to try doks theme, and when I replace ananke theme with doks theme, it's serving the blank page with some warning messages.

I wonder if there is something I'm missing? how do you get it to work with Hugo?

and FYI, I tried to use doks alone from this guide https://getdoks.org/docs/prologue/quick-start/ and it's working properly but not with Hugo.

Kidnly advise how can I solve this issue.

Thanks

[h-enk]

Doks is not — on purpose — a standard Hugo theme.

Unfortunately, Hugo does not provide a (solid) way to centralize dependency management. Doks uses npm to centralize dependency management — making it easy to update resources, build tooling, plugins, and build scripts. When you put Doks in the theme folder, it won't work, because Hugo does not support this — in the JavaScript world standard — npm setup.

There are a number of reasons why I don't like setting up a theme as a Git submodule or a Hugo module. If you're interested /would like to know why, I wrote a little piece on that, see Adding a theme, part of the Using npm with Hugo series.

So, the Quick Start is the way to get started with Doks!

[wphromma]

Are you saying that I should customize the theme not from the Hugo on top of it but straight to the theme itself?

[h-enk]

Yes. You could see Doks as a standalone theme, where Hugo is not a requirement, but a dependency!