Why Gatha is a Game Changer?

[Mohammad]

@TW_Tones

One thing I want is to make sure you don’t burn out especially in the support phase but also adding features, perhaps you could see how to allow others to build compatible solutions by providing the documentation for such additions and/or expose some of its features eg variables, config or fields. Call on me if I can help (eg Plugin inspector)

Gatha itself can be used as plugin inspector! but I welcome any suggestion here!
Regarding documentation, I will add both user docs and developer docs. I need to find some free time after stable release.

@TW_Tones

One way I navigate and understand a plugin is to list the tags (as pills) on plugin shadow tiddlers. It allows the macros, view template sidebar etc… to stand out. This could be added to the Gatha tree and/or we could develop a “Plugin Inspector” that helps people navigate plugin content.

You can do this! I myself use Commander and add a Working Tag. It only used for the purpose you proposed.

@TW_Tones

I would like to see “data plugins” having some prominence. I would like to see the community publishing data plugins containing tiddlers of test date or useful resources from a list of fruits, to collected bookmarks, geological epochs etc… The ability to generate these, but also add and edit items in such a plugin and “republish” is something Gatha can do.

The current version of Gatha can do this easily!

@TW_Tones

Perhaps we could add a drafts tab to the plugins tab to allow us to see “Draft Plugins”?

I think we cannot have both the plugin and its draft! There is no difference between a tiddler in plugin and the same plugin in draft! So, we cannot have both at the same time. That will be very confusing!

I prefer to keep production wiki separate from user wiki!

@TW_Tones

At least when plugins are delivered via a library it is possible to check if a given plugin requires an update. Just before one goes to generate a “custom wiki” it would be nice if any plugins needing update in the source wiki was flagged.

This is out of scope of Gatha! But I think @saqimtiaz had some nice idea here! I know there is some efforts on installing, updating plugins. @linonetwo has also some thoughts here.

[abesamma]

This is a fantastic project. We sorely need tools that help create more productive plugin developers for TiddlyWiki. Looking forward to seeing how this progresses!

[TW_Tones]

@Mohammad

@TW_Tones

One way I navigate and understand a plugin is to list the tags (as pills) on plugin shadow tiddlers. It allows the macros, view template sidebar etc… to stand out. This could be added to the Gatha tree and/or we could develop a “Plugin Inspector” that helps people navigate plugin content.

You can do this! I myself use Commander and add a Working Tag. It only used for the purpose you proposed.

What I mean here is the ability when looking at the plugin “tree” in Gatha to see the tags on the various plugin tiddlers. It helps quickly identify tags (with a tag pill) that are otherwise hidden until you open the tiddler.

In my solution development wikis I use my own tool reimagin-tags.json (9.5 KB) which turbo charges the tag pill. From just the tag pill you can copy it, open or close the tagged tiddlers and more including the regular drag and drop order. So hopefully you can see the value of displaying the “plugin tiddlers” tags in in side the gatha tree?

Thanks for your considered relies.

Regards
Tony

[linonetwo]

@TW_Tones

when plugins are delivered via a library it is possible to check if a given plugin requires an update

I think this is how https://github.com/tiddly-gittly/TiddlyWiki-CPL working, it will fetch github releases and wikis to local, and check the update.

Gatha can generate JSON wiki, and put it somewhere to be a download link. And fill that link into CPL will allow CPL check its update every hour via gh-actions.

[linonetwo]

Your effort will make TW community thrive for a longer time~

I have recommended Gatha in our Chinese tutorial site, and I will recommend people use Gatha to pack up their mini-changes to their wiki, and share them with the community.

[Mohammad]

Can Gatha act like Bundler?

Well bundler is handy plugin and has easy interface for exporting, sharing, and backing up tiddlers and tools! So, it is a very useful, and is recommended to be used!

However, if for any reason you have Gatha, then it has a backup feature!

• click on create new plugin (acts as a container)
• add publisher name and plugin name
• save
• now you can add tiddlers to your newly created container
• export the container (backup json file)

That’s all!

You can drag and drop this container to any wiki you like!
If target wiki has the Gatha installed, then you have the container for edit and re-export there!

[CodaCoder]

Thanks for that, @Mohammad

Can you confirm…

• click on create new plugin (acts as a container)
  …
• export the container (backup json file)

does NOT create a plugin or change/modify any tiddler types?

[Mohammad]

@CodaCoder

does NOT create a plugin or change/modify any tiddler types?

Yes!

• The create new plugin creates only a simple tiddler e.g. $:/plugins/kookma/bundle01
• Then you can add existing tiddlers to Extra tiddlers part (you may create new tiddlers to be exported…)
• Click on the export backup json file
  • this creates the bundle on the fly! no json is created in the host wiki!

[CodaCoder]

@Mohammad

no json is created in the host wiki!

Me likey. Lots.

[pmario]

@Mohammad

Can Gatha act like Bundler?

Just to let you know.

The next version of bundler-plugin will get a button to create a plugin-configuration tiddler from a bundle-config tiddler. The interface will be part of the tiddler info area and much more minimalistic than Gatha.

The reason for the delay is, that I need more functionality from the core tabs-macro, to “pimp” the tiddler info-area. There is a proposal about possible extensions of the tabs-macro at GitHub.

[tw-FRed]

Hi @Mohammad

Is Gatha able to create a demo wiki based on another TW edition than empty.html ? For example the fr-FR edition ?

For translation purposes it would be incredibly useful to me if I could export a complete working wiki based on the fr-FR edition of TW, with the addition of 2 of @pmario 's plugins, some utility tiddlers and some data tiddlers.

Amazing work you’re doing on Gatha by the way, everyone being so enthusiastic about it shows how important it will be for the community! A big thank you for Gatha and all your other contributions!

Fred

[Mohammad]

Hi Fred,
Yes, Gatha does this job easily!

Steps:

IMPORTANT: backup your data first

1. install Gatha in a wiki you like to reproduce it like fr-FR edition

2. create a empty plugin from Gatha interface in the right sidebar

3. add a readme or any tiddler to the new plugin draft

4. from the Sidebar > More Tab> Gatha
   4.1. edit the publish filter
   

   

5. now in Gatha interface, under your new created plugin tab, each time you click on the export demo, a tailored Tiddlywiki with all your customization will be exported!

NOTE: The created plugin actually is not required, but as Gatha is designed to export plugins, so the export button works that way! In future version I will add an edition project type. By the way it is good to have a readme or note tiddler to describe your edition.

[Mohammad]

Note ii: You can even have more customization e.g. per export, per plugin!

There are two publish filters:

• a global one as described above
  

  

• a dedicated one per plugin
  

The dedicated publishFilter is private to that plugin, so you can have several projects in the same production Tiddlywiki and generate several editions!

You can reproduce engineered wiki;-)

[telmiger]

Hello @Mohammad, I just tried to import Gatha 1.0.1 into a fresh TW 5.3.2 and discovered a difference compared to Gatha 0.9.5. When I click “new plugin” the many plugin specific fields in the newly opened tiddler are missing.

After some searching around (I felt like a newbie) I found the settings in the More tab of the sidebar again. Switching the “hide / toggle” fields visibility seemed to work with existing plugins but not with the “new plugin” button.

Version 0.9.5 is still usable, so I am sticking with that. Just wanted to let you know.

Cheers, Thomas

[Mohammad]

Hi Thomas,

Thank for reporting this. I am waiting for TW 5.3.3 bug release and then push a new update.

Best wishes
Mohammad

[telmiger]

Hi Mohammad,

Today, I tested Gatha v1.0.2 from Gatha Studio Workspace — create and export plugins, editions, and packages in browser and found some missing tiddlers:

• $:/config/gatha/EditTemplateBodyFilters/PluginMetaData
• $:/config/gatha/ViewTemplateBodyFilters/PluginMetaData

They are not included in the plugin anymore. The plugin-drafts look as expected when I import them manually from v0.9.5. Also $:/config/gatha/PublishFilter is not included anymore – should I import it manually too?

All the best,
Thomas

[Mohammad]

Hi Thomas,
Probably I did something wrong with update to TW 5.3.3.
I will have a look and push a new update this weekend.

Best

[TW_Tones]

I have only turned to Gatha now to create a plugin from what was previously a json package. I used relink to change all the source tiddlers to the required namespace, renamed the root tiddler to a subtiddler and created the plugin.

• Since I am newly using to Gatha I don’t know what should be there, but certainly something is missing.
• I am not sure how to edit the plugin info such as “Information tabs” as the field is visible in view mode but not edit, adding “Information tabs” field to the root plugin tiddler is ignored.
  • I add readme to Information tabs and have a tiddler pluginroot/readme
  • I found this should be in the list field of the plugin tiddler, but the IDE plugin is not up[dated.

Otherwise the packaging seems to work well.

[telmiger]

Hi Tones
I post the three files from Gatha 0.9.5 that seem to be missing in the new version. They should add the plugin specific fields in edit and view mode.
Hope that helps,
Thomas
missing-gatha-files.json (913 Bytes)

[Mohammad]

The plugin has been updated. Please read the doc first.