Better instructions for getting a theme to work

[nixjdm]

See https://github.com/lektor/lektor/issues/576

It is not clear enough how to begin using a theme. Namely it should be pointed out in https://www.getlektor.com/docs/themes/installing/ that themes my not be (and currently aren't) "drag and dropable." In other words, you can't simply install a theme and be done. You need to then adjust your project to make use of it, for example by removing conflicting templates or models, and which templates or models are affected are theme-dependent.

[Andrew-Shay]

@nixjdm Are there suggested templates/layouts, models and filenames?

For Simple Strap I have the following layouts/templates:

• one column
• two column with shared right side (homepage)
• two column
• blog
• blog post https://github.com/Andrew-Shay/lektor-theme-simple-strap/blob/master/README.md

Would it make it easier to use themes if they all shared the same "configurations"?

[nixjdm]

• page.html / .ini
• layout.html

are also common as a base, especially for Lektor projects specifically.

I feel like we could learn from and adopt some things from other site-builders in this regard. For example from Hugo, Wordpess, etc.

It's probably good to keep in mind too that the common themes will probably have templates, but a theme doesn't strictly need to. A theme could only provide assets, or models, and eventually plugins. And themes could potentially stack.