Documenting Themes

[varemenos]

I'm interesting in creating at least a couple of themes for FT so I was wondering if you'd prepare some docs for it once the project matures.

For example what are the allowed/possible choices in the .fttheme file's options and what each css selector is targeting in the style.css file.

[p-e-w]

The .fttheme file is actually fully commented: https://github.com/p-e-w/finalterm/blob/master/data/Themes/default/default.fttheme and should require no further explanation (correct me if I'm wrong).

The styles.css is parsed using Mx, and the selectors relevant to Mx apply. Unfortunately, Mx itself is barely documented at all. I found out the names of the selectors and what they can do through trial and error only, so I'm afraid you are going to have to do the same :(

[p-e-w]

This is the default style for Mx: https://github.com/clutter-project/mx/tree/master/data/style

I learned most of what I needed from there, good luck looking for any documentation anywhere on the web, or even examples(!) – which is a shame, because Mx is awesome.

If you make a theme, be sure to let me know. Please observe that the gutter and scrollbar colors and transparency of the default theme are carefully chosen to match both light and dark color schemes.

I am looking forward to seeing what you come up with :)

[varemenos]

Once I have something ready, I will do a pull request (which will include a preview of some sort, probably 1-2 images of each theme I guess).

[p-e-w]

@varemenos: BTW if you are also interested in making color schemes, you can use https://github.com/p-e-w/finalterm/blob/master/data/ColorSchemes/ftcolors.erb with https://github.com/chriskempson/base16-builder to make a Final Term-compatible LIGHT/DARK color scheme with the colors of your choice :)

[p-e-w]

Please also observe that https://github.com/p-e-w/finalterm/blob/master/data/Themes/default/style.css#L49 is tied to hardcoded stuff in TerminalView.vala to work around an ugly Mx limitation. This should thus be included unchanged in any theme.