Shiraz 3.0: Plan for the Next Major Release

[etardiff]

It’s lovely to see this, @Mohammad! I had been slowly updating a few of of my favorite Shiraz macros to use the more recent syntax and was just pondering attempting the same for dynamic tables, so this is excellent timing.

I haven’t had time to do much experimenting with Shiraz 3 yet, but I did notice that while your Migration tiddler notes that “Details macro uses the new $genesis widget” (great idea!), this change doesn’t seem to be reflected in $:/plugins/kookma/shiraz/procedures/details yet.

[etardiff]

Might I also suggest using the $:/temp/volatile/ prefix instead of $:/temp/ for temporary search tiddlers used for real-time filtering (like the ones you’re using in your <<faqs-details>> and <<faqs-slider>> macros)? This is the number one thing I find myself changing in your macros—and in core TW, for that matter. I have some pretty large wikis, and I find that it makes searches noticeably more performant.

[Mohammad]

Hi @etardiff
Thank you for your kind words.
I will prepare a changelog to reflect the final changes.
The first version of details was based on $genesis, but the page refresh causes to auto close the opened details. So details is the only macro I could not update it

[Mohammad]

Thank you for the suggestion. I note it!
I would welcome you review/comments.
The documentation needs more work, but as documentation is not the good part of coding I will gradually revise the docs. By the way I welcome suggestion or any help.

[ludwa6]

I’m just trying this out on a clean TW 5.3.5 instance, and all seems to be working as should so far… Except i can’t see any affordance in the UI for activating Node Explorer. Would be nice to have a tickbox as for Breadcrumbs in the Shiraz settings panel, but… What is the alternative?

[Mohammad]

Hi @ludwa6
The demo has full details under Shiraz Advanced Tutorial, → Node Explore tab

I repeat the steps for your convenience here:

Open the $:/AdvancedSearch
Select System tab
Enter: node-explorer into the searchbox
See the view templates for node-explorer

• $:/plugins/kookma/viewtemplates/node-explorer
• $:/plugins/kookma/viewtemplates/node-explorer-colorful
• $:/plugins/kookma/viewtemplates/node-explorer-details

In the demo the $:/plugins/kookma/viewtemplates/node-explorer-details is activeRemove the tag $:/tags/ViewTemplate to disable the node-explore OR
Tag any other template you like with $:/tags/ViewTemplate

[ludwa6]

Ah! my bad for failing to read all the docs -which are quite exemplary, i must say: will be working through them as time permits. Thanks @Mohammad !

[arunnbabu81]

@ludwa6 welcome back…back to using Tiddlywiki?

[ludwa6]

Yes @arunnbabu81 : after a long forced-flirtation with Notion (which i still need to use in my day-job), i realized that i will. never be as comfortable with that tool (or any other that i know) as i am with TiddlyWiki for personal information management. I do wish it could serve better the purposes of a workgroup- there are some fundamental issues of software architecture that make this a really tough nut to crack -but at least on the UI side, with plugins like Shiraz 3.0 making it so easy to create a really beautiful user experience, i like to think we’ll get there before too long!

[arunnbabu81]

Will this be of interest for you

Announcing the MultiWikiServer Plugin

Introduction I have started a major new area of core development. It is about enhancing the capabilities of TiddlyWiki under Node.js to their full potential: Hosting multiple wikis at once, with the “bags and recipes” mechanism for sharing data between them Improved handling of file uploads and attachments, allowing gigabyte video files to be uploaded and streamed Instantaneous synchronisation of changes between the server and all connected clients Workflow processing on the server, for examp…

[ludwa6]

ps: With your good guidance @Mohammad , I did get NodeExplorer working in the TW 5.3.5 instance i set up for this purpose- which i manage using TiddlyDesktop on Mac, in case that matters -but i did encounter a surprise that i’d like to understand better. Here’s what i did:

1. Went to your github site, the shiraz-3.0.0 branch, the index.html file in the docs folder, which i then downloaded to my desktop.

2. That instance being full of content, to try the plugin out on a clean TW 5.3.5 instance, i dragged from the downloaded 3.0.0 instance the Shiraz 3.0.0 plugin, along with the other plugins that accompanied it (Code Mirror, Highlight, Katex, Utility), into my clean instance.

3. Ran the advanced search you prescribed here to find that set of node-explorer viewtemplates you listed… But they did not appear in the result list.

4. So i dragged those 3 view templates over from the downloaded instance, and got Node Explorer working.

Of course this is not your recommended procedure, so feel free to ignore my “just out of curiosity” question; i just wonder: Is the Shiraz 3.0.0 plugin, when released, going to come bundled with all the view templates (plus anything else) that is needed to enjoy the full new&improved Shiraz experience?

[Mohammad]

@ludwa6

So i dragged those 3 view templates over from the downloaded instance, and got Node Explorer working.

You did correctly import the node-explorers.

Shiraz itself does not include the node-explorers in the plugin pack. Node-explorer is an advanced example of using Shiraz. Node-Explorer actually demonstrates how to use Dynamic-Tables, Display on Demand and Badges can be used to create a bidirectional edition of tiddlywiki!

NOTE: There is a less active edition called Mehregan ( Mehregan is a Tiddlywiki based app for personal knowledge management with Zettelkasten concept) which include all of these. I am sure you have it. I hope I can find some free time and update it once Shiraz 3.0.0 stable version released.

In summary to setup a clean TiddlyWiki with Node-Explorer you need

1. download the empty.html (latest version 5.3.5) from https://tiddlywiki.ocm
2. install Shiraz 3.0.0 using drag and drop
3. import all, or selected node-explorer viewtemplate from Shiraz 3.0.0