diff --git a/editions/tw5.com/tiddlers/mechanisms/SavingMechanism.tid b/editions/tw5.com/tiddlers/mechanisms/SavingMechanism.tid new file mode 100644 index 000000000..6370f4f38 --- /dev/null +++ b/editions/tw5.com/tiddlers/mechanisms/SavingMechanism.tid @@ -0,0 +1,18 @@ +created: 20150709150749755 +modified: 20150710154938284 +tags: Mechanisms +title: SavingMechanism +type: text/vnd.tiddlywiki + +The SavingMechanism is the mechanism by which TiddlyWiki generates a new HTML file and stores it. It is different from the SyncMechanism, which is concerned with synchronising changes to individual tiddlers back to a server. + +The following steps are involved: + +* The saver mechanism uses the filter defined in $:/config/SaverFilter to specify which modified tiddlers trigger the dirty state for the wiki +# The ButtonWidget is used to generate a [[tm-save-wiki|WidgetMessage: tm-save-wiki]] message to trigger the save operation +# The optional parameter for the message specifies the template that will be used for generating the HTML file, defaulting to $:/core/save/all +# The template includes a variable assignment that specifies a filter to select the tiddlers that should be included in the saved file. It then transcludes the main page template `$:/core/templates/tiddlywiki5.html` +# The [[tm-save-wiki|WidgetMessage: tm-save-wiki]] handler renders the template to generate the HTML file +# The message handler chooses the highest priority "saver" module that can handle saving the file +#* See http://tiddlywiki.com/dev/#Saver for more details + diff --git a/editions/tw5.com/tiddlers/mechanisms/SingleFileSaveFilters.tid b/editions/tw5.com/tiddlers/mechanisms/SingleFileSaveFilters.tid deleted file mode 100644 index b72089f86..000000000 --- a/editions/tw5.com/tiddlers/mechanisms/SingleFileSaveFilters.tid +++ /dev/null @@ -1,10 +0,0 @@ -created: 20150709150749755 -modified: 20150709150806031 -tags: Mechanisms -title: Filters involved in saving of single file eddition -type: text/vnd.tiddlywiki - -There are two filters controlling saving TiddlyWiki as a standalone file. - -* $:/config/SaverFilter determines which modified tiddlers trigger the dirty state -* $:/core/save/all determines which tiddlers are saved in the file