Leftwm: Rename `.liquid` documentation

Created on 18 May 2021  路  6Comments  路  Source: leftwm/leftwm

Howdy,

We ought to add another wiki page dedicated to .liquid files.

Quoting 337, but this has been asked about a few times recently.

Best,
Mautamu


This is so good. Only reason I switched away from leftwm because I couldn't handle the liquid files and eww. Thanks for this! One more question though, is there any plan for more .liquid documentation (not exactly in this PR)

_Originally posted by @iSparsh in https://github.com/leftwm/leftwm/issues/337#issuecomment-842931303_

Most helpful comment

Actually we could just rename it.
Initially I thought I would put in more theming documentation in this later and then decided to postpone this till our 'config breaking' changes are done, But as of now it just makes sense to have a dedicated .liquid page.

@mautamu would you change the link title, please. I'll change the title of the page with a PR for more liquid doc.
I'll probably push this in two steps btw. as I think I can quickly add the info for understanding the basic handling in the example themes. And after deeper research of the parser write up a more general guide in step two.

All 6 comments

Agree, and along with that, I think the hardest part in use with .liquid is figuring out, what the parser actually likes to process.
So it mostly would come down to document the parser/template_handler more obvious.

Ye I would move the info in customizing themes to a dedicated .liquid page, and make the customizing themes page cover the details of theme.toml and the other smaller files. I have also just added a custom sidebar to the wiki to make navigation a bit easier and cleaner.

Actually we could just rename it.
Initially I thought I would put in more theming documentation in this later and then decided to postpone this till our 'config breaking' changes are done, But as of now it just makes sense to have a dedicated .liquid page.

@mautamu would you change the link title, please. I'll change the title of the page with a PR for more liquid doc.
I'll probably push this in two steps btw. as I think I can quickly add the info for understanding the basic handling in the example themes. And after deeper research of the parser write up a more general guide in step two.

I just opened a PR in mautamu's wiki fork, you are all wellcome to extensivley review this.

Also I'd like to invite @cadenhenrich and @iSparsh to test if the eww related part works for them as well.

I recently updated the Wiki-Page, if the update is satisfactory, I believe we could close this issue.

Good work @VuiMuich!

Was this page helpful?
0 / 5 - 0 ratings

Related issues

rigoletto-freebsd picture rigoletto-freebsd  路  7Comments

Stanislav-Lapata picture Stanislav-Lapata  路  6Comments

sillen102 picture sillen102  路  7Comments

cjwyett picture cjwyett  路  4Comments

VuiMuich picture VuiMuich  路  3Comments