Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Better instructions for getting a theme to work #240

Open
nixjdm opened this issue Aug 13, 2018 · 2 comments
Open

Better instructions for getting a theme to work #240

nixjdm opened this issue Aug 13, 2018 · 2 comments

Comments

@nixjdm
Copy link
Member

nixjdm commented Aug 13, 2018

See lektor/lektor#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.

a2csuga pushed a commit to a2csuga/lektor-website that referenced this issue Sep 24, 2018
@Andrew-Shay
Copy link

Andrew-Shay commented Sep 27, 2018

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

For Simple Strap I have the following layouts/templates:

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

@nixjdm
Copy link
Member Author

nixjdm commented Oct 9, 2018

  • 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants