tiddlywiki 5.1.21 → 5.2.1

package/editions/dev/tiddlers/new/Hook__th-rendering-element.tid

@@ -0,0 +1,35 @@
+created: 20200630121235997
+modified: 20200630121235997
+tags: HookMechanism
+title: Hook: th-rendering-element
+
+This hook provides a notification that a DOM element is about to be rendered by the "element" widget. The hook can optionally provide an alternate parse tree that will be rendered in place of the intended element.
+
+Note the element widget only renders those HTML elements that were parsed as plain HTML elements within wikitext (i.e. using the `<tagname>` syntax). This means that this hook is not invoked for elements created by other widgets.
+
+Hook function parameters:
+
+* ''newParseTreeNodes'': optional parse tree nodes provided by a previously called hook
+* ''widget'': instance of the element widget invoking the hook
+
+Return value:
+
+* ''newParseTreeNodes'': optionally new parse tree nodes to replace the intended element, or a falsey value to leave the element untouched
+
+Here is an example of a handler for this hook:
+
+```js
+$tw.hooks.addHook("th-rendering-element",function(parseTreeNodes,widget) {
+	// Return the previous mapping if there is one
+	if(parseTreeNodes) {
+		return parseTreeNodes;
+	}
+	// Detect the elements we're interested in
+	if(someCondition()) {
+		// Replace them with a parse tree
+		return generateParseTreeNodes();
+	}
+	// Otherwise do nothing
+	return null;
+});
+```

package/editions/dev/tiddlers/new/Hook_th-make-tiddler-path.tid

@@ -0,0 +1,14 @@
+tags: HookMechanism
+title: Hook: th-make-tiddler-path
+type: text/vnd.tiddlywiki
+
+This hook lets a plugin inspect or modify the tiddler file path during the saving process.
+
+Hook function parameters:
+
+* ``currentPath``: The path the tiddler file will be saved to.
+* ``originalPath``: The original tiddler file path unmodified by any hooks.
+
+Return value:
+
+The path to use for saving the tiddler file.

package/editions/dev/tiddlers/new/ParserSubclassingMechanism.tid

@@ -0,0 +1,42 @@
+created: 20210203150855206
+modified: 20210203150855206
+title: ParserSubclassingMechanism
+
+!! Introduction
+
+The wikitext parser subclassing mechanism makes it possible for custom parsers to use the wiki text parsing engine, but to customise the rules that are used.
+
+!! Example
+
+Here is an example of a subclass of the checkbox widget that adds logging to the event handler:
+
+```js
+(function(){
+
+/*jslint node: true, browser: true */
+/*global $tw: false */
+"use strict";
+
+var WikiParser = require("$:/core/modules/parsers/wikiparser/wikiparser.js")["text/vnd.tiddlywiki"],
+	HtmlParser = $tw.modules.createClassFromModule(require("$:/core/modules/parsers/wikiparser/rules/html.js"),$tw.WikiRuleBase),
+	EntityParser = $tw.modules.createClassFromModule(require("$:/core/modules/parsers/wikiparser/rules/entity.js"),$tw.WikiRuleBase);
+
+var MyCustomWikiParser = function(type,text,options) {
+	var parser = new WikiParser(type,text,$tw.utils.extend({},options,{
+		// Force the parser to parse in inline mode
+		parseAsInline: true,
+		// Specify which rules will be used
+		rules: {
+			pragma: [],
+			block: [],
+			inline: [HtmlParser,EntityParser]
+		}
+	}));
+	this.tree = parser.tree;
+	this.prototype = parser.prototype;
+};
+
+exports["text/vnd.my-custom-type"] = MyCustomWikiParser;
+
+})();
+```

package/editions/dev/tiddlers/new/TiddlyWiki Drag and Drop Interop.tid

@@ -0,0 +1,15 @@
+title: TiddlyWiki Drag and Drop Interoperability
+
+It is straightforward to allow any HTML file to interoperate with TiddlyWiki's drag and drop implementation.
+
+This example shows how to attach draggable data to a DOM element. The data is provided in two different forms:
+
+* the string data is used if the element is dragged onto a text editing area
+* the tiddler data is used if the element is dragged into TiddlyWiki's import area
+
+<$button>
+<$action-sendmessage $message="tm-download-file" $param="$:/dev/save/dragndropinterop" filename="index.html"/>
+Download this sample code
+</$button>
+
+<$codeblock code={{DragAndDropInterop}} language="text/html"/>

package/editions/dev/tiddlers/new/dragndropinterop.html

@@ -0,0 +1,35 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Drag and Drop Interoperability with TiddlyWiki Demo</title>
+    <style>
+        #draggable {
+            padding: 1em;
+            margin: 1em;
+            background: #ecc;
+        }
+    </style>
+</head>
+<body>
+    <div id="draggable" draggable="true">
+        Drag me to a TiddlyWiki window
+    </div>
+</body>
+<script>
+
+    var titleString = "This is the string that appears when the block is dragged to a text input";
+    var tiddlerData = [
+        {title: "Tiddler One", text: "This is one of the payload tiddlers"},
+        {title: "Tiddler Two", text: "This is another of the payload tiddlers", "custom-field": "A custom field value"}
+    ];
+
+    document.getElementById("draggable").addEventListener("dragstart",function(event) {
+        event.dataTransfer.setData("URL","data:text/vnd.tiddler," + encodeURIComponent(JSON.stringify(tiddlerData)));
+        event.dataTransfer.setData("Text",titleString);
+        event.stopPropagation();
+        return false;
+    });
+    
+</script>
+</html>

package/editions/dev/tiddlers/new/dragndropinterop.html.meta

@@ -0,0 +1,3 @@
+title: DragAndDropInterop
+type: text/html
+

package/editions/dev/tiddlers/new/save-dragndropinterop.tid

@@ -0,0 +1,3 @@
+title: $:/dev/save/dragndropinterop
+
+<$view tiddler="DragAndDropInterop" field="text"/>

package/editions/dev/tiddlers/new/th-saving-tiddler.tid

@@ -1,5 +1,5 @@
 created: 20150908150314994
-modified: 20170209145506427
+modified: 20200618114855781
 tags: HookMechanism
 title: Hook: th-saving-tiddler
 type: text/vnd.tiddlywiki
@@ -8,7 +8,8 @@ This hook allows plugins to inspect or modify tiddlers before they are saved via
 
 Hook function parameters:
 
-* ''tiddler'': tiddler object about to be saved
+* ''newTiddler'': tiddler object about to be saved
+* ''oldTiddler'': tiddler object of draft tiddler that is being saved (from v5.1.23)
 
 Return value:
 

package/editions/dev/tiddlers/system/static.content.tid

@@ -1,11 +1,11 @@
 title: $:/core/templates/static.content
 type: text/vnd.tiddlywiki
-hack-to-give-us-something-to-compare-against: yes
 
 \define tv-wikilink-template() https://tiddlywiki.com/dev/static/$uri_doubleencoded$.html
 
 <!-- For Google, and people without JavaScript-->
-<$reveal state="!!hack-to-give-us-something-to-compare-against" type="nomatch" text=<<savingEmpty>>>
+
+<$reveal default="yes" text=<<savingEmpty>> type="nomatch">
 
 It looks like this browser doesn't run JavaScript. You can use one of these static HTML versions to browse the same content:
 

package/editions/dev/tiddlywiki.info

@@ -3,7 +3,8 @@
 	"plugins": [
 		"tiddlywiki/highlight",
 		"tiddlywiki/nodewebkitsaver",
-		"tiddlywiki/github-fork-ribbon"
+		"tiddlywiki/github-fork-ribbon",
+		"tiddlywiki/internals"
 	],
 	"themes": [
 		"tiddlywiki/vanilla",

package/editions/dynaviewdemo/tiddlers/ViewTemplate.tid

@@ -1,15 +1,13 @@
 title: $:/core/ui/ViewTemplate
 
 \whitespace trim
-\define frame-classes()
-tc-tiddler-frame tc-tiddler-view-frame $(missingTiddlerClass)$ $(shadowTiddlerClass)$ $(systemTiddlerClass)$ $(tiddlerTagClasses)$ $(userClass)$
-\end
 \define folded-state()
 $:/state/folded/$(currentTiddler)$
 \end
-<$vars storyTiddler=<<currentTiddler>> tiddlerInfoState=<<qualify "$:/state/popup/tiddler-info">> userClass={{!!class}}>
-<$tiddler tiddler=<<currentTiddler>>>
-<div data-tiddler-title=<<currentTiddler>> data-tags={{!!tags}} class=<<frame-classes>>>
+\define cancel-delete-tiddler-actions(message) <$action-sendmessage $message="tm-$message$-tiddler"/>
+\import [all[shadows+tiddlers]tag[$:/tags/Macro/View]!has[draft.of]]
+<$vars storyTiddler=<<currentTiddler>> tiddlerInfoState=<<qualify "$:/state/popup/tiddler-info">>>
+<div data-tiddler-title=<<currentTiddler>> data-tags={{!!tags}} class={{{ tc-tiddler-frame tc-tiddler-view-frame [<currentTiddler>is[tiddler]then[tc-tiddler-exists]] [<currentTiddler>is[missing]!is[shadow]then[tc-tiddler-missing]] [<currentTiddler>is[shadow]then[tc-tiddler-exists tc-tiddler-shadow]] [<currentTiddler>is[shadow]is[tiddler]then[tc-tiddler-overridden-shadow]] [<currentTiddler>is[system]then[tc-tiddler-system]] [{!!class}] [<currentTiddler>tags[]encodeuricomponent[]addprefix[tc-tagged-]] +[join[ ]] }}}>
 <$set name="state" value={{{ [[$:/state/viewtemplate/visibility/]addsuffix<currentTiddler>] }}}>
 <$reveal stateTitle=<<state>> type="nomatch" text="" default="" tag="div">
 <div class="tc-dynaview-track-tiddler-when-visible" data-dynaview-track-tiddler=<<state>>>
@@ -24,5 +22,4 @@ $:/state/folded/$(currentTiddler)$
 </$reveal>
 </$set>
 </div>
-</$tiddler>
 </$vars>

package/editions/es-ES/tiddlers/Page_and_tiddler_layout_customisation.tid

@@ -40,10 +40,10 @@ Digamos que tienes un tiddler llamado <<.tid "Plantilla Recetas">> y quieres un
 $param="TÍTULO DE LA PLANTILLA QUE QUIERES QUE ABRA"
 title="New tiddler"
   tags=<<newHereButtonTags>> />
-<$list filter="[<tv-config-toolbar-icons>prefix[yes]]">
+<$list filter="[<tv-config-toolbar-icons>match[yes]]">
 {{NOMBRE DE LA IMAGEN DEL BOTÓN}}
 </$list>
-<$list filter="[<tv-config-toolbar-text>prefix[yes]]">
+<$list filter="[<tv-config-toolbar-text>match[yes]]">
 <span class="tc-btn-text"><$text text="NOMBRE DEL BOTÓN PARA MOSTRAR EN PANTALLA"/></span>
 </$list>
 </$button>
@@ -54,7 +54,7 @@ title="New tiddler"
 
 #* Asígnale la etiqueta <<.tag ~$:/tags/ViewToolbar]]>>
 
-# Hay que crear un tiddler que le diga a ~TiddlyWIki si el botón será o no visible en la barra. Llamémosle por ejemplo <<.tid "~$:/config/ViewToolbarButtons/Visibility/Receta"">>. Escribe `reveal` en el cuerpo y guárdalo.
+# Hay que crear un tiddler que le diga a ~TiddlyWIki si el botón será o no visible en la barra. Llamémosle por ejemplo <<.tid "~$:/config/ViewToolbarButtons/Visibility/Receta"">>. Escribe `show` en el cuerpo y guárdalo.
 
 # Habrá que posicionar el botón adecuadamente. Abre el tiddler <<.tid ~$:/tags/ViewToolbar>> e inserta el nombre de tu botón en el lugar adecuado del campo <<.field list>>.
 

package/editions/es-ES/tiddlywiki.info

@@ -9,7 +9,8 @@
 		"tiddlywiki/seamless",
 		"tiddlywiki/centralised",
 		"tiddlywiki/tight",
-		"tiddlywiki/readonly"
+		"tiddlywiki/readonly",
+		"tiddlywiki/internals"
 	],
 	"languages": [
 		"es-ES"
@@ -40,4 +41,4 @@
 	"config": {
 		"retain-original-tiddler-path": true
 	}
-}
+}

package/editions/es-ES-server/tiddlywiki.info

@@ -3,7 +3,8 @@
 	"plugins": [
 		"tiddlywiki/tiddlyweb",
 		"tiddlywiki/filesystem",
-		"tiddlywiki/highlight"
+		"tiddlywiki/highlight",
+		"tiddlywiki/internals"
 	],
 	"themes": [
 		"tiddlywiki/vanilla",

package/editions/fr-FR/tiddlers/HelloThumbnail - Latest Version.tid

@@ -2,7 +2,7 @@ caption: Quoi de neuf dans <<version>>
 color: #fff
 created: 20160603124050989
 fr-title: BonjourLaVignette - Dernière Version
-image: New Release Banner.png
+image: New Release Banner
 link: Releases
 modified: 20160603124131122
 tags: HelloThumbnail

package/editions/fr-FR/tiddlers/Page and tiddler layout customisation.tid

@@ -25,7 +25,7 @@ Imaginons que vous ayez un tiddler squelette appelé 'Modèle Recette', et que v
 
 # Pour illustrer votre bouton, si aucune des images du noyau (tiddlers shadow préfixés par $:/core/images/ ) n'est à votre convenance, vous devrez la créer ou en obtenir une au format SVG (par exemple, une de celles de http://flaticon.com), glissez-la dans votre fichier pour la transformer en tiddler, modifiez le tiddler et ajustez sa hauteur et sa largeur à 22px
 #Passons au tiddler contenant votre tiddler. Créez-le, titrez-le et ajoutez le code du bouton (voir le code ci-dessous par exemple, en l'adaptant à vos besoins si nécessaire) Étiquetez-le par [[$:/tags/ViewToolbar]]
-#Contrôlons la visibilité de votre tiddler dans la barre d'outil par la création d'un tiddler à titrer [[$:/config/ViewToolbarButtons/Visibility/Recette]]. Saisissez `reveal`dans la zone texte et sauvegardez.
+#Contrôlons la visibilité de votre tiddler dans la barre d'outil par la création d'un tiddler à titrer [[$:/config/ViewToolbarButtons/Visibility/Recette]]. Saisissez `show`dans la zone texte et sauvegardez.
 #Enfin, positionnons le bouton proprement. Ouvrez le tiddler $:/tags/ViewToolbar et insérez le titre de votre tiddler bouton (cf. titre étape précédente) dans le champ field au bon endroit.
 
 ```
@@ -39,10 +39,10 @@ Imaginons que vous ayez un tiddler squelette appelé 'Modèle Recette', et que v
 $param="TITLE DE VOTRE BOUTON SQUELETTE"
 title="New tiddler"
   tags=<<newHereButtonTags>> />
-<$list filter="[<tv-config-toolbar-icons>prefix[yes]]">
+<$list filter="[<tv-config-toolbar-icons>match[yes]]">
 {{TITRE DE VOTRE TIDDLER IMAGE SVG}}
 </$list>
-<$list filter="[<tv-config-toolbar-text>prefix[yes]]">
+<$list filter="[<tv-config-toolbar-text>match[yes]]">
 <span class="tc-btn-text"><$text text="CAPTION DE VOTRE BOUTON"/></span>
 </$list>
 </$button>

package/editions/fr-FR/tiddlywiki.info

@@ -9,7 +9,8 @@
 		"tiddlywiki/seamless",
 		"tiddlywiki/centralised",
 		"tiddlywiki/tight",
-		"tiddlywiki/readonly"
+		"tiddlywiki/readonly",
+		"tiddlywiki/internals"
 	],
 	"languages": [
 		"fr-FR"
@@ -40,4 +41,4 @@
 	"config": {
 		"retain-original-tiddler-path": true
 	}
-}
+}

package/editions/fr-FR-server/tiddlywiki.info

@@ -3,7 +3,8 @@
 	"plugins": [
 		"tiddlywiki/tiddlyweb",
 		"tiddlywiki/filesystem",
-		"tiddlywiki/highlight"
+		"tiddlywiki/highlight",
+		"tiddlywiki/internals"
 	],
 	"themes": [
 		"tiddlywiki/vanilla",

package/editions/full/tiddlywiki.info

@@ -30,6 +30,7 @@
 		"tiddlywiki/xmldom"
 	],
 	"languages": [
+		"ar-PS",
 		"ca-ES",
 		"cs-CZ",
 		"da-DK",

package/editions/innerwikidemo/tiddlywiki.info

@@ -1,7 +1,8 @@
 {
 	"description": "Innerwiki Plugin Demo",
 	"plugins": [
-		"tiddlywiki/innerwiki"
+		"tiddlywiki/innerwiki",
+		"tiddlywiki/railroad"
 	],
 	"themes": [
 		"tiddlywiki/vanilla",

package/editions/introduction/tiddlers/slides/TiddlyWiki.tid

@@ -7,7 +7,7 @@ title: TiddlyWiki
 <$scrollable class="tc-cecily-demo">
 <div class="tc-cecily-demo-inner">
 <$linkcatcher>
-<$list filter="[list[$:/StoryList]] -[[TiddlyWiki]]" template="$:/core/ui/ViewTemplate" storyview="cecily" cecily-width="550px" cecily-map="CecilyMap"/>
+<$list filter="[{$:/DefaultTiddlers}enlist-input[]] -[[ ]] -[[TiddlyWiki]]" template="$:/core/ui/ViewTemplate" storyview="cecily" cecily-width="550px" cecily-map="CecilyMap"/>
 </$linkcatcher>
 </div>
 </$scrollable>

package/editions/introduction/tiddlers/slides/Translations.tid

@@ -6,14 +6,9 @@ $(languagePluginTitle)$/icon
 
 TiddlyWiki is currently available in <$count filter="[[$:/languages/en-GB]] [plugin-type[language]sort[title]] -[[$:/languages/de-AT]]"/> languages:
 
-<div class="tc-drop-down-language-chooser" style="font-size: 10px; line-height: 12px; -moz-columns:2; -webkit-columns:2; columns:2;">
+<div class="tc-drop-down-language-chooser" style="font-size: 7px; line-height: 8px; -moz-columns:6; -webkit-columns:6; columns:6;">
 <$list filter="[[$:/languages/en-GB]] [plugin-type[language]sort[title]] -[[$:/languages/de-AT]]">
 <div class="tc-language-list">
-<span class="tc-language-list-greeting">
-<$view subtiddler="$:/language/ControlPanel/Basics/Language/Prompt">
-<$view tiddler="$:/language/ControlPanel/Basics/Language/Prompt"/>
-</$view>
-</span>
 <span class="tc-language-list-name tc-image-button">
 <$set name="languagePluginTitle" value=<<currentTiddler>>>
 <$transclude subtiddler=<<flag-title>>>
@@ -27,6 +22,9 @@ TiddlyWiki is currently available in <$count filter="[[$:/languages/en-GB]] [plu
 <$view field="title"/>
 </$view>
 </$view>
+<$view subtiddler="$:/language/ControlPanel/Basics/Language/Prompt">
+<$view tiddler="$:/language/ControlPanel/Basics/Language/Prompt"/>
+</$view>
 </span>
 </div>
 </$list>

package/editions/introduction/tiddlers/system/styles.tid

@@ -19,7 +19,8 @@ html body .tc-subtitle {
 }
 
 .tc-view-toolbar-tools {
-	font-size: 0.7em;	
+	font-size: 0.5em;
+	line-height: 1.1;
 }
 
 .tc-view-toolbar-tools p {

package/editions/introduction/tiddlywiki.info

@@ -16,10 +16,12 @@
 		"tiddlywiki/readonly"
 	],
 	"languages": [
+		"ar-PS",
 		"ca-ES",
 		"cs-CZ",
 		"da-DK",
 		"de-AT",
+		"de-CH",
 		"de-DE",
 		"el-GR",
 		"en-GB",
@@ -27,6 +29,7 @@
 		"es-ES",
 		"fa-IR",
 		"fr-FR",
+		"he-IL",
 		"hi-IN",
 		"ia-IA",
 		"it-IT",
@@ -34,12 +37,16 @@
 		"ko-KR",
 		"nl-NL",
 		"pa-IN",
+		"pt-BR",
 		"pt-PT",
 		"ru-RU",
 		"sk-SK",
 		"sv-SE",
+		"zh-CN",
 		"zh-Hans",
-		"zh-Hant"
+		"zh-Hant",
+		"zh-HK",
+		"zh-TW"
 	],
 	"build": {
 		"index": [

package/editions/ja-JP/tiddlywiki.info

@@ -9,7 +9,8 @@
 		"tiddlywiki/seamless",
 		"tiddlywiki/centralised",
 		"tiddlywiki/tight",
-		"tiddlywiki/readonly"
+		"tiddlywiki/readonly",
+		"tiddlywiki/internals"
 	],
 	"languages": [
 		"ja-JP"
@@ -40,4 +41,4 @@
 	"config": {
 		"retain-original-tiddler-path": true
 	}
-}
+}

package/editions/ko-KR/tiddlers/system/static.content.tid

@@ -1,11 +1,11 @@
 title: $:/core/templates/static.content
 type: text/vnd.tiddlywiki
-hack-to-give-us-something-to-compare-against: yes
 
 \define tv-wikilink-template() https://tiddlywiki.com/languages/ko-KR/static/$uri_doubleencoded$.html
 
 <!-- For Google, and people without JavaScript-->
-<$reveal state="!!hack-to-give-us-something-to-compare-against" type="nomatch" text=<<savingEmpty>>>
+
+<$reveal default="yes" text=<<savingEmpty>> type="nomatch">
 
 이 브라우저는 자바스크립트를 실행하지 않은 것으로 보입니다. 같은 내용을 찾아보려면 정적 HTML 버전 중 하나를 사용할 수 있습니다:
 

package/editions/ko-KR/tiddlywiki.info

@@ -9,7 +9,8 @@
 		"tiddlywiki/seamless",
 		"tiddlywiki/centralised",
 		"tiddlywiki/tight",
-		"tiddlywiki/readonly"
+		"tiddlywiki/readonly",
+		"tiddlywiki/internals"
 	],
 	"languages": [
 		"ko-KR"
@@ -40,4 +41,4 @@
 	"config": {
 		"retain-original-tiddler-path": true
 	}
-}
+}

package/editions/ko-KR-server/tiddlywiki.info

@@ -3,7 +3,8 @@
 	"plugins": [
 		"tiddlywiki/tiddlyweb",
 		"tiddlywiki/filesystem",
-		"tiddlywiki/highlight"
+		"tiddlywiki/highlight",
+		"tiddlywiki/internals"
 	],
 	"themes": [
 		"tiddlywiki/vanilla",

package/editions/markdowndemo/tiddlers/HelloThere.tid

@@ -1,6 +1,6 @@
 title: HelloThere
 
-This is a demo of TiddlyWiki5 incorporating a plugin for the [[markdown-js|https://github.com/evilstreak/markdown-js]] Markdown parser from Dominic Baggott. The MarkdownExample tiddler below is written in Markdown.
+This is a demo of TiddlyWiki5 incorporating a plugin for parsing tiddlers written in the Markdown language. The plugin uses the [[Remarkable|https://github.com/jonschlinkert/remarkable]] Markdown parser internally. The MarkdownExample tiddler below is written in Markdown.
 
 ! Installation
 
@@ -8,31 +8,4 @@ To add the plugin to your own TiddlyWiki5, just drag this link to the browser wi
 
 [[$:/plugins/tiddlywiki/markdown]]
 
-! Markdown Dialects
-
-By default the markdown parser recognises the original dialect of Markdown [[as described by John Gruber|http://daringfireball.net/projects/markdown/]]. An extended dialect called "Maruku" is also included that provides table support and other advanced features. The syntax extensions are modelled on those of [[PHP Markdown Extra|https://michelf.ca/projects/php-markdown/extra/]].
-
-The configuration tiddler [[$:/config/markdown/dialect]] determines which dialect is used:
-
-|!Dialect |!Description |
-|Gruber |Standard Markdown |
-|Maruku |Extended Maruku Markdown |
-
-
-! Creating ~WikiLinks
-
-Create wiki links with the usual Markdown link syntax targeting `#` and the target tiddler title:
-
-```
-[link text](#TiddlerTitle)
-```
-
-! Images
-
-Markdown image syntax can be used to reference images by tiddler title or an external URI. For example:
-
-```
-![alt text](/path/to/img.jpg "Title")
-
-![alt text](Motovun Jack.jpg "Title")
-```
+{{$:/plugins/tiddlywiki/markdown/usage}}