> I am not sure the reason the folder is called recipes, I believe it has 
> something to do with how some system was set up while this was being 
> developed. I think you would have to ask Jeremy why.

Backing up, TiddlyWiki 5’s client-server HTTP API was designed to be compatible 
with the existing protocol used by TiddlyWiki Classic to talk to TiddlyWeb and 
later TiddlySpace.

TiddlyWeb implements a simple model for composing wikis from groups of tiddlers 
stored separately called “bags and recipes”. The idea is that tiddlers are 
stored in named bags, and that a recipe is a sequence of bags. Then we make a 
wiki by pulling together the tiddlers in the corresponding recipe.

The built-in TiddlyWiki 5 server is a degenerate implementation of the 
protocol, only supporting a single bag and a single recipe, but the TiddlyWiki 
5 client has always had full support for bags and recipes.

It would be natural to use this same API for the plugin library but of course 
due to our unusual architecture where the plugin library is static without a 
server we are not able to use HTTP. Instead we use window.postMessage() to 
communicate with the plugin library via an embedded iframe. The implementation 
is an attempt to tunnel HTTP over postMessage, and so uses the same URLs that 
would be used with the HTTP API.

You can see the gory details of the code that talks to the iframe here:

https://github.com/Jermolene/TiddlyWiki5/blob/master/core/modules/startup/browser-messaging.js
 
<https://github.com/Jermolene/TiddlyWiki5/blob/master/core/modules/startup/browser-messaging.js>

And here’s the much simpler code that runs within the iframe:

https://github.com/Jermolene/TiddlyWiki5/blob/master/plugins/tiddlywiki/pluginlibrary/libraryserver.js
 
<https://github.com/Jermolene/TiddlyWiki5/blob/master/plugins/tiddlywiki/pluginlibrary/libraryserver.js>

Best wishes

Jeremy

-- 
You received this message because you are subscribed to the Google Groups 
"TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/5DAE5FCC-1E0F-4258-94D6-830A04B983E0%40gmail.com.

Reply via email to