Getting started guide seems to not support themes

I just started using Zola, followed the Getting Started guide, added some content, and then tried to add a theme.

I was quite surprised to see that no matter what theme I cloned into themes and added to config.toml, nothing changed.

I kicked off a new repo to debug, and did the theme first, checking through each step of the Getting Started guide. It worked! Right up until creating index.html in

which gives you a page that doesn’t import site.css, and thus only has whatever CSS you manually add to your template (Bulma 0.8 in the case of the example).

How does one create a site that actually uses a theme?

I think the right thing to do here is:

  • Configure the theme.
  • Do not create a base.html.
  • Do not create index.html.
  • Instead, create content/ with metadata inside +++ blocks.

However, if I do that I don’t actually get main page content — the title shows up, but not the body.

This is a bit of a critical miss for a getting started guide: I’m flailing about in the dark. Can someone suggest what I’m doing wrong and update the Getting Started guide to save the next person?

1 Like

If you are using a theme and you don’t want to customise it, the templates folder should be empty basically.
The quickstart should have a section for templates though, you’re right.

1 Like

The fact that the templates folder should be empty to use a theme wasn’t obvious to me either after going through the getting started guide. Adding a sentence at the end of the guide saying as much would be helpful.

Sounds more like a bug tbh

in fact this is a bug, they didn’t fixed it yet, and i had the same problem.
i’m lucky that someone noticed and answered this, otherwise i would’nt be able to grasp what was happening.
it’s not obvious.

Looking at it again I wasn’t clear.

The templates folder can contain files if you are overriding some of the themes templates/adding your own shortcodes. If you are not, it can be empty but there’s no specific need to be empty.

yea im having issues as well with themes.
im completely lost and idk what im actually supposed to do. im told here the templates can be empty, but i get errors.
this has honestly been a mess to try to get working and im very close to giving up on it

That’s a regression from 0.17, you can just create an empty templates folder for now.