From 9e01a30dc78ff834b6c418bb5656cc686842ba73 Mon Sep 17 00:00:00 2001 From: nome Date: Mon, 4 Apr 2016 13:45:31 +0200 Subject: [PATCH] Small documentation fixes * Copy example from ActionSendMessageWidget to tm-new-tiddler It is counter-intuitive that the ActionSendMessageWidget documentation has more information on tm-new-tiddler than the more specific one. * Fix link in reference docs * Fix some typos --- .../Data Management during Runtime.tid | 2 +- .../Microkernel and Datamodel.tid | 4 ++-- .../The Heart of TiddlyWiki Boot-Kernel.tid | 2 +- .../messages/WidgetMessage_ tm-new-tiddler.tid | 11 ++++++++++- .../tiddlers/widgets/ActionSendMessageWidget.tid | 2 +- 5 files changed, 15 insertions(+), 6 deletions(-) diff --git a/editions/dev/tiddlers/from Heigele and Jurke/Data Management during Runtime.tid b/editions/dev/tiddlers/from Heigele and Jurke/Data Management during Runtime.tid index 80863bc56..dd746d45c 100644 --- a/editions/dev/tiddlers/from Heigele and Jurke/Data Management during Runtime.tid +++ b/editions/dev/tiddlers/from Heigele and Jurke/Data Management during Runtime.tid @@ -3,7 +3,7 @@ modified: 20140708085602231 tags: doc title: Data Management during Runtime -During the runtime the data of Tiddlywiki is stored in javascript objects. These objects are synchronized with the DOM-Representation of Tiddlywiki. This means every change of the original data of a Tiddler, fires an event which changes all DOM-Representations of the Tiddler and the javascript object. The barbone Wiki store is created during the boot process and is kept in a object called \$tw.Wiki. This object contains amongst others a hashmap of the different Tiddlers of Tiddlywiki. The Hashmap is used to store the javascript object representation of the different Tiddlers. Furthermore this object is used to manage the tiddlers during runtime, it provides methods for adding tiddlers, search tiddlers by name and delete tiddlers. +During the runtime the data of Tiddlywiki is stored in javascript objects. These objects are synchronized with the DOM-Representation of Tiddlywiki. This means every change of the original data of a Tiddler, fires an event which changes all DOM-Representations of the Tiddler and the javascript object. The bare-bones Wiki store is created during the boot process and is kept in a object called \$tw.Wiki. This object contains amongst others a hashmap of the different Tiddlers of Tiddlywiki. The Hashmap is used to store the javascript object representation of the different Tiddlers. Furthermore this object is used to manage the tiddlers during runtime, it provides methods for adding tiddlers, search tiddlers by name and delete tiddlers. As shown in the picture below, every change at the DOM triggers an event which changes the corresponding widget which again changes the store of the tiddlers. The whole image shows how WikiText is parsed by a set of rules into the parse tree and this parse tree is rendered as a tree of widgets. This Rendertree is synchronised to the DOM. Every modification on the Rendertree provokes a start of the rendering-pipeline. As well as every change on the wikiText triggers an event at the RenderTree. This Process uses a selective updating so that only the changed parts are updated. This means only widgets which have to change the DOM in consequence of a changed tiddler are refreshed. {{TiddlyWikiArchitecture.svg}} \ No newline at end of file diff --git a/editions/dev/tiddlers/from Heigele and Jurke/Microkernel and Datamodel.tid b/editions/dev/tiddlers/from Heigele and Jurke/Microkernel and Datamodel.tid index 3e13539ba..3a5461b90 100644 --- a/editions/dev/tiddlers/from Heigele and Jurke/Microkernel and Datamodel.tid +++ b/editions/dev/tiddlers/from Heigele and Jurke/Microkernel and Datamodel.tid @@ -3,7 +3,7 @@ modified: 20140709093651688 tags: redo title: Microkernel and Datamodel -The microkernel is responsible for creating a barbone TW environment. -It is running under Node.js or in a HTML5 Browser. The Bootkernel just loads enough functionality to load the modules containing the main logic of the application. This boot-kernel contains a few helper methods, the module mechanism as well as the function to create a tiddler and manage them. The boot-kernel also creates the barbone wiki store, which holds all the information of the wiki during the runtime. After creating the store, the boot-kernel is in charge of decrypting the encrypted tiddlers and extracting all the tiddlers e.g. the core module tiddlers embedded in the DOM structure of the HTML file. Furthermore the boot kernel offers the functionality to load tiddlers from a file, when you run TW with Node.js. +The microkernel is responsible for creating a bare-bones TW environment. +It is running under Node.js or in a HTML5 Browser. The Bootkernel just loads enough functionality to load the modules containing the main logic of the application. This boot-kernel contains a few helper methods, the module mechanism as well as the function to create a tiddler and manage them. The boot-kernel also creates the bare-bones wiki store, which holds all the information of the wiki during the runtime. After creating the store, the boot-kernel is in charge of decrypting the encrypted tiddlers and extracting all the tiddlers e.g. the core module tiddlers embedded in the DOM structure of the HTML file. Furthermore the boot kernel offers the functionality to load tiddlers from a file, when you run TW with Node.js. {{StartupTimeline.png}} \ No newline at end of file diff --git a/editions/dev/tiddlers/from Heigele and Jurke/The Heart of TiddlyWiki Boot-Kernel.tid b/editions/dev/tiddlers/from Heigele and Jurke/The Heart of TiddlyWiki Boot-Kernel.tid index 484e6bec6..ef0ad4deb 100644 --- a/editions/dev/tiddlers/from Heigele and Jurke/The Heart of TiddlyWiki Boot-Kernel.tid +++ b/editions/dev/tiddlers/from Heigele and Jurke/The Heart of TiddlyWiki Boot-Kernel.tid @@ -3,6 +3,6 @@ modified: 20140708090217085 tags: doc title: The Heart of TiddlyWiki (Boot-Kernel) -The boot-kernel is responsible for creating a barbone TW environment. It is running under Node.js or in a HTML5 Browser. The Bootkernel just loads enough functionality to load the modules containing the main logic of the application. This boot-kernel contains a few helper methods, the module mechanism as well as the function to create a tiddler and manage them. The boot-kernel also creates the barbone wiki store, which holds all the information of the wiki during the runtime. After creating the store, the boot-kernel is in charge of decrypting the encrypted tiddlers and extracting all the tiddlers e.g. the core module tiddlers embedded in the DOM structure of the HTML file. Furthermore the boot kernel offers the functionality to load tiddlers from a file, when you run TW with Node.js. All other functionality which is not a part of the boot kernel is added dynamically by modules and plugins. The boot kernel is able to load the core plugins and perform the startup plugins. The core contains the startup modules shown in the picture below. +The boot-kernel is responsible for creating a bare-bones TW environment. It is running under Node.js or in a HTML5 Browser. The Bootkernel just loads enough functionality to load the modules containing the main logic of the application. This boot-kernel contains a few helper methods, the module mechanism as well as the function to create a tiddler and manage them. The boot-kernel also creates the bare-bones wiki store, which holds all the information of the wiki during the runtime. After creating the store, the boot-kernel is in charge of decrypting the encrypted tiddlers and extracting all the tiddlers e.g. the core module tiddlers embedded in the DOM structure of the HTML file. Furthermore the boot kernel offers the functionality to load tiddlers from a file, when you run TW with Node.js. All other functionality which is not a part of the boot kernel is added dynamically by modules and plugins. The boot kernel is able to load the core plugins and perform the startup plugins. The core contains the startup modules shown in the picture below. {{index.svg}} \ No newline at end of file diff --git a/editions/tw5.com/tiddlers/messages/WidgetMessage_ tm-new-tiddler.tid b/editions/tw5.com/tiddlers/messages/WidgetMessage_ tm-new-tiddler.tid index 167acec49..d060552d8 100644 --- a/editions/tw5.com/tiddlers/messages/WidgetMessage_ tm-new-tiddler.tid +++ b/editions/tw5.com/tiddlers/messages/WidgetMessage_ tm-new-tiddler.tid @@ -20,10 +20,19 @@ The title for the draft tiddler is chosen according to these rules: The new tiddler message is usually generated with the ButtonWidget or ActionSendMessageWidget and is handled by the NavigatorWidget. -! Example +! Examples To make a button that creates new tiddlers tagged "task", create a tiddler called "TaskTemplate" with that tag, and then make your button like this: ``` <$button message="tm-new-tiddler" param="TaskTemplate">New Task ``` + +To create a new tiddler with given attributes rather than from a template: + +``` +<$button> +<$action-sendmessage $message="tm-new-tiddler" title="This is newly created tiddler" tags="OneTag [[Another Tag]]" text=<>/> +New Tiddler + +``` diff --git a/editions/tw5.com/tiddlers/widgets/ActionSendMessageWidget.tid b/editions/tw5.com/tiddlers/widgets/ActionSendMessageWidget.tid index cd08292e1..93403c1ba 100644 --- a/editions/tw5.com/tiddlers/widgets/ActionSendMessageWidget.tid +++ b/editions/tw5.com/tiddlers/widgets/ActionSendMessageWidget.tid @@ -7,7 +7,7 @@ type: text/vnd.tiddlywiki ! Introduction -The ''action-sendmessage'' widget is an [[action widget|ActionWidgets]] that sends a [[message|WidgetMessages]] back up the widget tree. ActionWidgets are used within triggering widgets such as the ButtonWidget. +The ''action-sendmessage'' widget is an [[action widget|ActionWidgets]] that sends a [[message|Messages]] back up the widget tree. ActionWidgets are used within triggering widgets such as the ButtonWidget. ! Content and Attributes