TiddlyThemes are back online

[Yakov]

Hello everyone,

recently I've did some extensive updates to my fork of the old TiddlyThemes project, and despite that there's a whole lot more to improve, I think it's time to share the current result: https://yakovl.github.io/TiddlyThemes/

I hope you find this useful; let me know what you think. Help with updating is also welcome, as there's quite an amount of work required to make all the themes up-to-date (in that case, I'll guide you with how to do the most useful bits).

Best regards,

Yakov.

[Pengju Yan]

Hi Yakov,

Thanks for making them back. I just have some advice about the installation guide. It says:

"In the simplest scenario (like for Blackicity or Bleach), it's enough to copy the theme tiddler, set it via the txtTheme option (better in SystemSettings), and reload."

I'm afraid it is not clear. I guess the doc should be like this (sorry I haven't been using any theme before):

1. Backup your own PageTemplate/StyleSheet tiddlers (there could be more than one set, provided if you have multiple themes there);

2. Import PageTemplate/StyleSheet tiddlers from the theme twc files to your own twc.

3. Enable the theme via the txtTheme option (better in SystemSettings). (Should it be BlackicityTheme or just Blackicity?)

4. Your ColorPalette could possibly be bypassed if StyleSheet overwrites everything.

BTW: I see another request for a plugin of switching themes. :-)

Pengju

[Yakov]

Hi Pengju,

yes, we should probably clarify things if they are not clear, but

1. for real themes, you don't need to backup anything: the theme (normally) uses StyleSheet section and doesn't overwrite the StyleSheet tiddler. Same for templates.
   • The tricky bit is to use the StyleSheet along with the theme. One can include StyleSheet into the theme by adding "[[StyleSheet]]" on a new line inside the StyleSheet section of the theme; but as for now, editing the StyleSheet tiddler after won't cause applying the styles without additional refreshing, which may be confusing – that's why I haven't added the "[[StyleSheet]]" into the themes yet.
     
2. Again, for properly packed themes, you don't need to import PageTemplate/StyleSheet tiddlers, you only need the theme tiddler, which the description you've cited explains. An example of a theme tiddler: https://yakovl.github.io/TiddlyThemes/themes/bleach.html#BleachTheme
   • Note: I haven't packed all the themes into theme tiddlers, only those listed in https://yakovl.github.io/TiddlyThemes/ (4 for now). If anyone wants to help with this, please write a comment in the corresponding issue.
     
3. Should it be BlackicityTheme or just Blackicity? – right, should amend the text to something like "txtTheme option (better in SystemSettings; the option value should be the name of the theme tiddler)".
4. Not applicable because of 2.; but ColorPalette is another tricky bit as the current core engine doesn't imply that a theme can have its own ColorPalette: for now, themes and palettes are just separate entities, and this is a matter of discussion (currently, I don't have a clear idea of how should this work).
   

As for switching themes, there's SwitchThemePlugin by Eric, which should probably be mentioned in the "Installing a theme" section, but I also think there should be a better core functionality to do this without a plugin. To be honest, there's a lot of work to make things work smoothly (working out conventions, creating docs, updating core), so this should be addressed iteratively. If anyone is willing to help, I can draft some first steps.

For now, let's discuss and agree on the wording for "Installing a theme" which is clear enough.

Best regards,

Yakov.

понедельник, 5 февраля 2024 г. в 16:06:13 UTC+3, yanp...@gmail.com:

[Yakov]

A quick note: I've created a general issue about themes in the TW repo and made a couple of updates on the TiddlyThemes page ("Installing a theme" section), so if you have some further suggestions, please share (but try to make them specific)

вторник, 6 февраля 2024 г. в 13:37:34 UTC+3, Yakov: