Fix boot.js change from master

Along with some suitably eye catching notification messages

bin/clean.sh

@@ -2,4 +2,4 @@
 
 # Remove any output files
 
-find . -regex "^./editions/.*/output/.*" -delete
+find . -regex "^./editions/[a-z0-9\.-]*/output/.*" -delete

boot/boot.js

@@ -96,34 +96,42 @@ Push entries onto an array, removing them first if they already exist in the arr
 $tw.utils.pushTop = function(array,value) {
 	var t,p;
 	if($tw.utils.isArray(value)) {
-		// Remove any array entries that are duplicated in the new values
-		if(value.length !== 0) {
-			if(array.length !== 0) {
-				if(value.length < array.length) {
-					for(t=0; t<value.length; t++) {
-						p = array.indexOf(value[t]);
-						if(p !== -1) {
-							array.splice(p,1);
+		if($tw.config._temp_allowDuplicates) {
+			Array.prototype.push.apply(array,value);
+		} else {
+			// Remove any array entries that are duplicated in the new values
+			if(value.length !== 0) {
+				if(array.length !== 0) {
+					if(value.length < array.length) {
+						for(t=0; t<value.length; t++) {
+							p = array.indexOf(value[t]);
+							if(p !== -1) {
+								array.splice(p,1);
+							}
 						}
-					}
-				} else {
-					for(t=array.length-1; t>=0; t--) {
-						p = value.indexOf(array[t]);
-						if(p !== -1) {
-							array.splice(t,1);
+					} else {
+						for(t=array.length-1; t>=0; t--) {
+							p = value.indexOf(array[t]);
+							if(p !== -1) {
+								array.splice(t,1);
+							}
 						}
 					}
 				}
-			}
-			// Push the values on top of the main array
-			array.push.apply(array,value);
+				// Push the values on top of the main array
+				Array.prototype.push.apply(array,value);
+			}			
 		}
 	} else {
-		p = array.indexOf(value);
-		if(p !== -1) {
-			array.splice(p,1);
+		if($tw.config._temp_allowDuplicates) {
+			array.push(value);
+		} else {
+			p = array.indexOf(value);
+			if(p !== -1) {
+				array.splice(p,1);
+			}
+			array.push(value);
 		}
-		array.push(value);
 	}
 	return array;
 };
@@ -397,7 +405,7 @@ $tw.utils.parseStringArray = function(value, allowDuplicate) {
 			match = memberRegExp.exec(value);
 			if(match) {
 				var item = match[1] || match[2];
-				if(item !== undefined && (!$tw.utils.hop(names,item) || allowDuplicate)) {
+				if(item !== undefined && (!$tw.utils.hop(names,item) || allowDuplicate || $tw.config._temp_allowDuplicates)) {
 					results.push(item);
 					names[item] = true;
 				}
@@ -2305,14 +2313,25 @@ $tw.loadTiddlersNode = function() {
 Startup TiddlyWiki
 */
 $tw.boot.initStartup = function(options) {
+	var _temp_allowDuplicates;
+	options = options || {};
 	// Get the URL hash and check for safe mode
 	$tw.locationHash = "#";
 	if($tw.browser && !$tw.node) {
 		if(location.hash === "#:safe") {
 			$tw.safeMode = true;
+		} else if(location.hash === "#dupes") {
+			_temp_allowDuplicates = true;
+			$tw.locationHash = $tw.utils.getLocationHash();
 		} else {
 			$tw.locationHash = $tw.utils.getLocationHash();
 		}
+	} else {
+		var p = $tw.boot.argv.indexOf("--dupes");
+		if(p !== -1) {
+			_temp_allowDuplicates = true;
+			$tw.boot.argv.splice(p,1);
+		}
 	}
 	// Initialise some more $tw properties
 	$tw.utils.deepDefaults($tw,{
@@ -2321,6 +2340,7 @@ $tw.boot.initStartup = function(options) {
 			types: {} // hashmap by module type of hashmap of exports
 		},
 		config: { // Configuration overridables
+			_temp_allowDuplicates: _temp_allowDuplicates,
 			pluginsPath: "../plugins/",
 			themesPath: "../themes/",
 			languagesPath: "../languages/",
@@ -2473,6 +2493,14 @@ $tw.boot.execStartup = function(options){
 	if($tw.crypto) {
 		$tw.crypto.updateCryptoStateTiddler();
 	}
+	// Warn if using duplicates mode
+	console.log("\x1b[0;31m--------=====>>>>>> " + $tw.wiki.getTiddler("$:/core/_temp_allowDuplicates/Heading").fields.text + "\x1b[0m");
+	console.log("\x1b[0;34m--------=====>>>>>> " + $tw.wiki.getTiddler("$:/core/_temp_allowDuplicates/Warning").fields.text + "\x1b[0m");
+	if($tw.config._temp_allowDuplicates) {
+		console.log("\x1b[0;31m--------=====>>>>>> " + $tw.wiki.getTiddler("$:/core/_temp_allowDuplicates/StatusOn").fields.text + "\x1b[0m");
+	} else {
+		console.log("\x1b[0;32m--------=====>>>>>> " + $tw.wiki.getTiddler("$:/core/_temp_allowDuplicates/StatusOff").fields.text + "\x1b[0m");
+	}
 	// Gather up any startup modules
 	$tw.boot.remainingStartupModules = []; // Array of startup modules
 	$tw.modules.forEachModuleOfType("startup",function(title,module) {

core/_temp_allowDuplicates.tid

@@ -0,0 +1,92 @@
+title: $:/core/_temp_allowDuplicates
+tags: $:/tags/AboveStory
+
+<div class="marching-ants-box" style="
+    position: fixed;
+    top: 100px;
+    left: -4px;
+    max-width: 50%;
+    z-index: 1000;
+    padding: 1em;
+    border-top-right-radius: 16px;
+    border-bottom-right-radius: 16px;
+    color: #fff;">
+
+<$reveal type="match" state="$:/state/_temp_allowDuplicatesWarning" text="hide" default="show">
+
+<$button set="$:/state/_temp_allowDuplicatesWarning" setTo="show" class="tc-btn-invisible" style="
+    width: 100%;
+    text-align: left;
+    fill: #ff0;">
+
+{{$:/core/images/warning}}
+
+</$button>
+
+</$reveal>
+
+<$reveal type="nomatch" state="$:/state/_temp_allowDuplicatesWarning" text="hide" default="show">
+
+<$button set="$:/state/_temp_allowDuplicatesWarning" setTo="hide" class="tc-btn-invisible" style="
+    width: 100%;
+    text-align: left;
+    fill: #ff0;">
+
+<span style="float:right;">{{$:/core/images/chevron-left}}</span> {{$:/core/images/warning}}
+
+</$button>
+
+<div style="
+	font-weight: bold;">
+
+{{$:/core/_temp_allowDuplicates/Heading}}
+
+</div>
+
+<div style="">
+
+{{$:/core/_temp_allowDuplicates/Warning}}
+
+</div>
+
+<$list filter="1 1 1 1 +[butfirst[]limit[1]]" emptyMessage="""
+
+<div style="
+	font-weight: bold;
+	color: #0f0;">
+
+{{$:/core/_temp_allowDuplicates/StatusOff}}
+
+//Append `#dupes` to the browser address bar to enable//
+
+</div>
+""">
+
+<div style="
+	font-weight: bold;
+	color: #fff;
+	font-size: 1.5em;
+	padding: 4px;" class="marching-ants-box">
+
+{{$:/core/_temp_allowDuplicates/StatusOn}}
+
+//Remove `#dupes` from the browser address bar to disable//
+
+</div>
+
+</$list>
+
+</$reveal>
+
+</div>
+
+<style>
+@keyframes marching-ants { to { background-position: 100% 100% } }
+
+.marching-ants-box {
+	border: 4px solid transparent;
+	background: linear-gradient(#d85858, #d85858) padding-box,
+	            repeating-linear-gradient(-45deg, #f00 0, #f00 25%, transparent 0, transparent 50%) 0 / 12px 12px;
+	animation: marching-ants 12s linear infinite;
+}
+</style>

core/messages.multids

@@ -0,0 +1,6 @@
+title: $:/core/_temp_allowDuplicates/
+
+Heading: Important Warning
+Warning: This is a special prerelease version of TW5 for experimenting with a potentially incompatible change to the core logic of filter processing. It is only intended to be used for evaluation and testing
+StatusOff: The allow duplicates setting is currently: OFF
+StatusOn: The allow duplicates setting is currently: ON

core/modules/editor/engines/framed.js

@@ -162,13 +162,13 @@ FramedEngine.prototype.fixHeight = function() {
 		if(this.widget.editAutoHeight) {
 			if(this.domNode && !this.domNode.isTiddlyWikiFakeDom) {
 				var newHeight = $tw.utils.resizeTextAreaToFit(this.domNode,this.widget.editMinHeight);
-				this.iframeNode.style.height = newHeight + "px";
+				this.iframeNode.style.height = (newHeight + 14) + "px"; // +14 for the border on the textarea
 			}
 		} else {
 			var fixedHeight = parseInt(this.widget.wiki.getTiddlerText(HEIGHT_VALUE_TITLE,"400px"),10);
 			fixedHeight = Math.max(fixedHeight,20);
 			this.domNode.style.height = fixedHeight + "px";
-			this.iframeNode.style.height = fixedHeight + "px";
+			this.iframeNode.style.height = (fixedHeight + 14) + "px";
 		}
 	}
 };

editions/tw5.com/tiddlers/Saving on Browser with TiddlyStow.tid

@@ -1,16 +0,0 @@
-caption: TiddlyStow (experimental)
-color: #FF8A65
-created: 20230403170650008
-delivery: Saver
-description: Save changes using new versions of Chromium based browsers
-method: save
-modified: 20230403183020357
-tags: Chrome Edge Opera Saving Linux Mac Windows
-title: Saving on Browser with TiddlyStow
-type: text/vnd.tiddlywiki
-url: https://github.com/btheado/tiddlystow
-
-''Link:'' {{!!url}}
-
-Tiddlystow saves TiddlyWiki files locally using the browser file system API (Chrome-based browsers currently). 
-This is a simple web page for loading a local TiddlyWiki file and storing it back to the same local file requiring no plugins or extensions.

editions/tw5.com/tiddlers/definitions/Tiddlyhost.tid

@@ -1,12 +0,0 @@
-title: Tiddlyhost
-tags: definition
-created: 20230410105035569
-modified: 20230410105035569
-
-<span style="float:right;">[img width=140 [Tiddlyhost Logo]]</span>
-
-[[Tiddlyhost.com|https://tiddlyhost.com/]] is a hosting service for TiddlyWiki created by Simon Baird. Once you sign up and confirm your email you can create "sites", (i.e. ~TiddlyWikis), with support for online saving. Sites can be private or public, and you can optionally list them on the taggable and searchable [[Tiddlyhost Hub|https://tiddlyhost.com/hub]] where they'll be discoverable by others.
-
-Unlike [[TiddlySpot|Saving on TiddlySpot]], [[Tiddlyhost|https://tiddlyhost.com]] is secure, open source, and has proper support for TiddlyWiki5. It also allows uploading existing ~TiddlyWiki files, supports TiddlyWikiClassic, and lets you claim ownership of your ~TiddlySpot sites. For more information see the [[FAQ|https://github.com/simonbaird/tiddlyhost/wiki/FAQ]] and the [[About|https://tiddlyhost.com/about]] page.
-
-<div style="clear: both;"/>

editions/tw5.com/tiddlers/definitions/Xememex.tid

@@ -1,14 +0,0 @@
-title: Xememex
-tags: Definitions
-created: 20230410105035569
-modified: 20230410105035569
-
-<span style="float:right;">[img width=340 [Xememex Logo]]</span>
-
-Xememex is a multiuser TiddlyWiki from [[Federatial]]. It allows large groups of people to work together on intertwingled wikis that can share content.
-
-The largest customer implementation has hundreds of online wikis with thousands of users. See https://manuals.annafreud.org/
-
-Xememex is currently only available under commercial terms from Federatial. Contact [[Jeremy Ruston at Federatial|mailto:jeremy@federatial.com]] for more details.
-
-<div style="clear: both;"/>

editions/tw5.com/tiddlers/hellothere/HelloThere.tid

@@ -5,19 +5,11 @@ tags: TableOfContents
 title: HelloThere
 type: text/vnd.tiddlywiki
 
-!!.tc-hero-heading ''Welcome to TiddlyWiki, a unique [[non-linear|Philosophy of Tiddlers]] notebook for [[capturing|Creating and editing tiddlers]], [[organising|Structuring TiddlyWiki]] and [[sharing|Sharing your tiddlers with others]] complex information''
+!! ''Welcome to TiddlyWiki, a unique [[non-linear|Philosophy of Tiddlers]] notebook for [[capturing|Creating and editing tiddlers]], [[organising|Structuring TiddlyWiki]] and [[sharing|Sharing your tiddlers with others]] complex information''
 
 Use it to keep your [[to-do list|TaskManagementExample]], to plan an [[essay or novel|"TiddlyWiki for Scholars" by Alberto Molina]], or to organise your wedding. Record every thought that crosses your brain, or build a flexible and responsive website.
 
-TiddlyWiki lets you choose where to keep your data, guaranteeing that in the decades to come you will [[still be able to use|Future Proof]] the notes you take today.
-
-!! ''Quick Start''
-
-<div class="tc-cards tc-action-card">
-<$list filter="[tag[Quick Start]]">
-<$macrocall $name="flex-card" bordercolor={{!!color}} textcolor={{!!text-color}} backgroundcolor={{!!background-color}} captionField="caption" descriptionField="text"/>
-</$list>
-</div>
+Unlike conventional online services, TiddlyWiki lets you choose where to keep your data, guaranteeing that in the decades to come you will [[still be able to use|Future Proof]] the notes you take today.
 
 !! ''Find Out More''
 
@@ -27,7 +19,7 @@ TiddlyWiki lets you choose where to keep your data, guaranteeing that in the dec
 </$list>
 </div>
 
-!! ''Community''
+!! ''~TiddlyWiki Hubs''
 
 <div class="tc-cards" style="font-size:0.7em;text-align:center;margin:3em auto;">
 <a href="https://talk.tiddlywiki.org/" class="tc-btn-big-green" style="border-radius:4px;background-color:#FF8C19;" target="_blank" rel="noopener noreferrer">
@@ -48,9 +40,6 @@ TiddlyWiki lets you choose where to keep your data, guaranteeing that in the dec
 <a href="https://gitter.im/TiddlyWiki/public" class="tc-btn-big-green" style="border-radius:4px;background-color:#753a88;background-image:linear-gradient(to left,#cc2b5e,#753a88);" target="_blank" rel="noopener noreferrer">
 {{$:/core/images/gitter}} Gitter
 </a>
-<a href="https://www.reddit.com/r/TiddlyWiki5/" class="tc-btn-big-green" style="border-radius:4px;background-color:#FF4500;" target="_blank" rel="noopener noreferrer">
-{{Reddit Logo}} Reddit
-</a>
 </div>
 
 !! ''Testimonials & Reviews''

editions/tw5.com/tiddlers/hellothere/quickstart/Quick Start.tid

@@ -1,2 +0,0 @@
-title: Quick Start
-list: [[Quick Start: Tiddlyhost]] [[Quick Start: Desktop]] [[Quick Start: DIY]] [[Quick Start: Xememex]]

editions/tw5.com/tiddlers/hellothere/quickstart/desktop.tid

@@ -1,10 +0,0 @@
-title: Quick Start: Desktop
-tags: [[Quick Start]]
-caption: Desktop
-icon: $:/core/images/storyview-zoomin
-button-color: #37753e
-button-text: Download
-background: linear-gradient(90deg,#f0fff1, #ffffff)
-link: TiddlyDesktop
-
-Download the official desktop application for macOS, Windows and Linux

editions/tw5.com/tiddlers/hellothere/quickstart/diy.tid

@@ -1,10 +0,0 @@
-title: Quick Start: DIY
-tags: [[Quick Start]]
-caption: DIY
-icon: $:/core/images/theme-button
-button-color: #ff4522
-button-text: Explore
-background: linear-gradient(90deg,#fff4f2, #ffffff)
-link: GettingStarted
-
-Find the configuration that is right for you to get the full benefits of ~TiddlyWiki

editions/tw5.com/tiddlers/hellothere/quickstart/tiddlyhost.tid

@@ -1,10 +0,0 @@
-title: Quick Start: Tiddlyhost
-tags: [[Quick Start]]
-caption: Tiddlyhost
-icon: $:/core/images/globe
-button-color: #00009a
-button-text: Create Account
-background: linear-gradient(90deg,#f5f5ff, #ffffff)
-link: Tiddlyhost
-
-The easiest way to get started with an online ~TiddlyWiki

editions/tw5.com/tiddlers/hellothere/quickstart/xememex.tid

@@ -1,10 +0,0 @@
-title: Quick Start: Xememex
-tags: [[Quick Start]]
-caption: Xememex
-icon: $:/core/images/star-filled
-button-color: #bf5fb6
-button-text: Find out more
-background: linear-gradient(90deg,#fff1fe, #ffffff)
-link: Xememex
-
-For companies and teams, a multiuser ~TiddlyWiki from Federatial

editions/tw5.com/tiddlers/images/Reddit Logo.tid

@@ -1,7 +0,0 @@
-title: Reddit Logo
-
-<svg width="22pt" height="22pt" viewBox="0 0 20 20">
-	<g>
-		<path d="M16.67,10C16.641,9.22 15.992,8.593 15.211,8.593C14.834,8.593 14.472,8.739 14.2,9C13.063,8.227 11.725,7.799 10.35,7.77L11,4.65L13.14,5.1C13.194,5.605 13.626,5.993 14.134,5.993C14.683,5.993 15.134,5.542 15.134,4.993C15.134,4.444 14.683,3.993 14.134,3.993C13.779,3.993 13.449,4.183 13.27,4.49L10.82,4C10.798,3.995 10.776,3.993 10.754,3.993C10.607,3.993 10.48,4.097 10.45,4.24L9.71,7.71C8.318,7.731 6.962,8.159 5.81,8.94C5.539,8.685 5.181,8.543 4.81,8.543C4.009,8.543 3.35,9.202 3.35,10.003C3.35,10.573 3.683,11.092 4.2,11.33C4.189,11.476 4.189,11.624 4.2,11.77C4.2,14.01 6.81,15.83 10.03,15.83C13.25,15.83 15.86,14.01 15.86,11.77C15.871,11.624 15.871,11.476 15.86,11.33C16.363,11.08 16.679,10.561 16.67,10ZM12.3,12.04C11.751,12.04 11.3,11.589 11.3,11.04C11.3,10.491 11.751,10.04 12.3,10.04C12.849,10.04 13.3,10.491 13.3,11.04C13.301,11.053 13.301,11.067 13.301,11.08C13.301,11.629 12.849,12.08 12.301,12.08C12.297,12.08 12.294,12.08 12.29,12.08L12.3,12.04ZM12.48,13.75C11.771,14.285 10.897,14.557 10.01,14.52C9.123,14.557 8.249,14.285 7.54,13.75C7.5,13.702 7.479,13.641 7.479,13.579C7.479,13.431 7.601,13.309 7.749,13.309C7.811,13.309 7.872,13.33 7.92,13.37C8.521,13.811 9.255,14.033 10,14C10.746,14.041 11.483,13.825 12.09,13.39C12.142,13.339 12.212,13.311 12.285,13.311C12.438,13.311 12.564,13.437 12.564,13.59C12.564,13.665 12.534,13.737 12.48,13.79L12.48,13.75ZM6.67,11C6.67,10.451 7.121,10 7.67,10C8.219,10 8.67,10.451 8.67,11C8.67,11.549 8.219,12 7.67,12C7.121,12 6.67,11.549 6.67,11Z"/>
-	</g>
-</svg>

editions/tw5.com/tiddlers/images/Tiddlyhost Logo.png.meta

@@ -1,3 +0,0 @@
-title: Tiddlyhost Logo
-type: image/png
-tags: picture

editions/tw5.com/tiddlers/images/Xememex Logo.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="1073" height="232"><g fill="#000" fill-rule="nonzero"><path d="M157.972 224h26.053l-6.756-11.94-70.621-124.802-.04 7.95L157.124 8h-25.588L89.064 82.431h13.897L60.489 8H34.574l50.855 87.227-.051-7.969L14.756 212.06 8 224h25.761l2.289-4.102 66.949-120-13.98-.013 66.667 120zM1038.972 224h26.053l-6.756-11.94-70.621-124.802-.04 7.95 43.559-75.198L1038.124 8h-25.588l-2.302 4.035-40.17 70.396h13.897l-40.169-70.396L941.489 8h-25.915l7.013 12.029 43.842 75.198-.051-7.969-70.622 124.802L889 224h25.761l2.289-4.102 66.949-120-13.98-.013 66.667 120zM191 224h106.904l10-21.65H204.932l8 8V65.153l-8 8h101.955l10-21.65H204.932l8 8V21.65l-8 8h88.452l10-21.65H191v208zM478 224h106.904l10-21.65H491.932l8 8V65.153l-8 8h101.955l10-21.65H491.932l8 8V21.65l-8 8h88.452l10-21.65H478v208zM762 224h106.904l10-21.65H775.932l8 8V65.153l-8 8h101.955l10-21.65H775.932l8 8V21.65l-8 8h88.452l10-21.65H762v208zM437.831 224h22.214V8l-71.304 61.952h10.564L328 8v216h22.215V39.062l-12.48 5.968 55.911 49.911 56.357-49.889-12.172-5.99zM722.831 224h22.214V8l-71.304 61.952h10.564L613 8v216h22.215V39.062l-12.48 5.968 55.911 49.911 56.357-49.889-12.172-5.99z"/></g></svg>

editions/tw5.com/tiddlers/images/Xememex Logo.svg.meta

@@ -1,2 +0,0 @@
-type: image/svg+xml
-title: Xememex Logo

editions/tw5.com/tiddlers/saving/Saving to a Git service.tid

@@ -15,7 +15,7 @@ Saving to a Git service is configured in the [[$:/ControlPanel]] in the ''Git Se
 
 * ''Type'' - (mandatory) the type of the service (e.g. GitHub, GitLab)
 * ''Username'' - (mandatory) the username for the Git service account used for saving changes
-* ''Password'' - (mandatory) the OAUTH token or personal access token for the specified account. Note that GitHub deprecated password authentication, permitted authentication methods are shown in the [[API documentation|https://developer.github.com/v3/#authentication]].
+* ''Password'' - (mandatory) the OAUTH token or personal access token for the specified account. Note that GitHub deprecated password authetication, permitted authentication methods are shown in the[[API documentation|https://developer.github.com/v3/#authentication]].
 * ''Repository'' - (mandatory) the name of the Git repository. Both the owner name and the repository name must be specified. For example `Jermolene/TiddlyWiki5`
 * ''Branch'' - (optional) the name of the branch to be used within the Git repository. Defaults to `main` (~GitHub) or `master` (~GitLab)"
 * ''Path'' - (optional) the path to the target file. Defaults to `/`

editions/tw5.com/tiddlers/styleguide/Documentation Macros.tid

@@ -1,5 +1,5 @@
 created: 20150110182600000
-modified: 20230325161424684
+modified: 20211206080809651
 tags: [[Improving TiddlyWiki Documentation]]
 title: Documentation Macros
 type: text/vnd.tiddlywiki
@@ -58,13 +58,6 @@ The following macros are used throughout ~TiddlyWiki's documentation. Their name
 |.wlink |a link to a widget |<<.wlink ButtonWidget>> |
 |.wlink2 |a link to a widget, with specified text |<<.wlink2 foo ButtonWidget>> |
 
-!Tabs
-|!Macro |!Used for |!Example |
-|.doc-tabs |showing a tab set in a documentation tiddler | -- |
-|.doc-tab-link |button to activate a tab | -- |
-|.widget-attr-link |button with a widget attribute name to activate a tab | -- |
-
-
 !User interface
 
 |!Macro |!Used for |!Example |

editions/tw5.com/tiddlers/styleguide/Reference Tiddlers.tid

@@ -1,7 +1,7 @@
 created: 20141226192500000
-modified: 20230318160831470
-tags: [[Improving TiddlyWiki Documentation]]
+modified: 20150117152552000
 title: Reference Tiddlers
+tags: [[Improving TiddlyWiki Documentation]]
 
 <<.def "Reference tiddlers">> offer raw information in a comprehensive interlinked way. The reader is likely to be an intermediate or expert user.
 
@@ -13,7 +13,6 @@ There are several subcategories:
 ;User manual
 * Presenting technical details of ~WikiText features
 * Subcategorised: messages, operators, widgets, etc
-** Widget documentation should follow the [[Widget Documentation Style Guide]]
 
 ;Developer manual
 * Presenting technical details of ~TiddlyWiki's internal architecture

editions/tw5.com/tiddlers/styleguide/Widget Documentation Style Guide.tid

@@ -1,37 +0,0 @@
-created: 20230318160840043
-modified: 20230325162525198
-tags: [[Reference Tiddlers]]
-title: Widget Documentation Style Guide
-
-Widget documentation generally consists of
-
-* an introductory summary of the widget's function
-* an overview of attributes and how the widget content is handled
-* more detailed attribute explanation when required
-* examples
-
-The //Content and Attributes// section should describe how the content of the widget is used, followed by a table of the possible attributes, each with a short description of a single sentence. The attribute names in the table and elsewhere in the tiddler should be rendered with the <<.var .attr>> macro. The <<.var .from-version>> macro should be used as first item in the description to designate the version at which a parameter became available.
-
-A subsection should be used for parameters that need an //extended description//, possibly with separate examples. When there are more than 2 such subsection necessary, the subsections should be split into their own tiddlers, and the <<.var .doc-tabs>> macro should be used to transclude them into the widget documentation tiddler as tabs.
-
-* The <<.var .doc-tabs>> macro is used without parameters
-* The <<.var .doc-tabs>> macro must not be used more than once within a single documentation tiddler
-* The tiddlers to be included in the tab group should be tagged with the respective widget documentation tiddler and have a <<.field description>> field set to <<.value tab>>
-* The <<.field caption>> contains the tab button text. It should be as short as possible. For the attribute name, the <<.var .attr>> macro should be used in the <<.field caption>>
-* The tab tiddlers should start with a level-2-heading that links to itself, so that they may be opened from within the tabs
-* They can contain examples if these are specific to the topic of the subsection
-
-In the attribute table, the <<.var .widget-attr-link>> macro can be used to turn attributes into a button that activates the respective tab. The <<.var .widget-attr-link>> macro is used like this
-
-```
-<<.widget-attr-link text:<display text> target:<title of corresponding tiddler> >>
-```
-
-Elsewhere, the <<.var .doc-tab-link>> macro can be used to activate the respective tab
-
-```
-<<.doc-tab-link text:<display text> target:<title of corresponding tiddler> tooltip:<tooltip to show when hovering over the button> class:<additional classes> >>
-```
-The parameters <<.param tooltip>> and <<.param class>> are optional.
-
-Both link macros scroll to the tab group additionally to setting the selected tab. They can also be used within the tab contents tiddlers themselves. If a tab tiddler is opened outside the tab group, <<.var doc-tab-link>> will open the tiddler containing the tab group if it is not yet open, and scroll to its tab group if it is.

editions/tw5.com/tiddlers/system/doc-macros.tid

@@ -1,5 +1,5 @@
 created: 20150117152607000
-modified: 20230325141733992
+modified: 20220714133424023
 tags: $:/tags/Macro
 title: $:/editions/tw5.com/doc-macros
 type: text/vnd.tiddlywiki
@@ -61,37 +61,6 @@ type: text/vnd.tiddlywiki
 \define .toc-tab() <<.tab "TableOfContents">>
 \define .example-tab(_) <span class="doc-tab">$_$</span>
 
-\define .doc-tabs()
-<$macrocall $name="tabs"
-      tabsList="[tag<currentTiddler>description[tab]]"
-      default={{{ [tag<currentTiddler>first[]] }}}
-      explicitState={{{ [<currentTiddler>addprefix[$:/state/tab/]] }}}
-      class={{{ [[doc-tabs]] [<currentTiddler>encodeuricomponent[]escapecss[]addprefix[doc-tabs-]] +[join[ ]] }}} />
-\end
-\define .doc-tab-link(text, target, tooltip:"", class:"")
-<!-- figure out where the addressed doc-tabs are -->
-<$tiddler tiddler={{{ [<currentTiddler>search:text[.doc-tabs]] :else[<currentTiddler>tags[]search:text[.doc-tabs]first[]] :else[<currentTiddler>] }}} >
-<$button class={{{ [[tc-btn-invisible tc-tiddlylink]] [<__class__>] +[join[ ]] }}}
-      set={{{ [<currentTiddler>addprefix[$:/state/tab/]] }}}
-      setTo=<<__target__>>
-      tooltip=<<__tooltip__>>>
-    <<__text__>>
-    <!-- if tiddler with tabs is open, scroll to tabs, otherwise open that tiddler (relevant from within tab subtiddlers) -->
-    <$list filter="[[$:/StoryList]contains<currentTiddler>]" variable="ignore" emptyMessage="<$action-navigate />">
-        <$action-sendmessage $message="tm-scroll" selector={{{ [<currentTiddler>encodeuricomponent[]addprefix[.doc-tabs-]] }}} />
-    </$list>
-    <$action-sendmessage $message="tm-scroll" selector={{{ [<currentTiddler>encodeuricomponent[]escapecss[]addprefix[.doc-tabs-]] }}} />
-</$button>
-</$tiddler>
-\end
-\define .widget-attr-link(text, target)
-<$macrocall $name=".doc-tab-link" 
-      text={{{ [[<code class="doc-attr">]] [<__text__>] [[</code>]] +[join[]] }}}
-      class="doc-tab-link"
-      target=<<__target__>>
-      tooltip={{{ [[Show more information about the ']] [<__text__>] [[' attribute]] +[join[]] }}} />
-\end
-
 \define .button(_) <span class="doc-button">{{$:/core/ui/Buttons/$_$!!caption}}</span>
 
 \define .icon(_) <span class="doc-icon">{{$_$}}</span>
@@ -212,4 +181,4 @@ $credit$
 </ol>
 \end
 
-<pre><$view field="text"/></pre>
+<pre><$view field="text"/></pre>

editions/tw5.com/tiddlers/system/doc-styles.tid

@@ -1,5 +1,5 @@
 created: 20150117152612000
-modified: 20230325101137075
+modified: 20220617125128201
 tags: $:/tags/Stylesheet
 title: $:/editions/tw5.com/doc-styles
 type: text/vnd.tiddlywiki
@@ -285,14 +285,4 @@ ol.doc-github-contributors li {
 	overflow: hidden;
 	text-overflow: ellipsis;
 }
-.doc-tabs.tc-tab-buttons button {
-  font-size: 1rem;
-  padding: 0.5em;
-}
-.doc-tabs button .doc-attr {
-  background-color: unset;
-  color: #666;
-}
-.doc-tab-link .doc-attr {
-  color: unset;
-}
+

editions/tw5.com/tiddlers/system/static.content.tid

@@ -2,10 +2,6 @@ title: $:/core/templates/static.content
 
 \define tv-wikilink-template() https://tiddlywiki.com/static/$uri_doubleencoded$.html
 
-<!-- Mastodon verification -->
-
-<a rel="me" href="https://fosstodon.org/@TiddlyWiki">Mastodon</a>
-
 <!-- For Google, and people without JavaScript-->
 
 <$reveal default="yes" text=<<savingEmpty>> type="nomatch">

editions/tw5.com/tiddlers/system/tw5.com-styles.tid

@@ -6,10 +6,6 @@ type: text/vnd.tiddlywiki
 
 \rules only filteredtranscludeinline transcludeinline macrodef macrocallinline macrocallblock
 
-.tc-hero-heading a.tc-tiddlylink {
-	font-weight: bold;
-}
-
 .tc-double-spaced-list li {
 	padding-bottom: .5em;
 	padding-top: .5em;
@@ -144,48 +140,26 @@ type: text/vnd.tiddlywiki
 	background: <<colour background>>;
 	border-color: rgba(34,36,38,.15);
 	box-shadow: 0 2px 25px 0 rgb(34 36 38 / 5%) inset;
-	gap: 1em;
-}
-
-.tc-cards.tc-action-card {
-	text-align: center;
-	background: none;
-}
-
-.tc-cards.tc-action-card .tc-card-button {
-	border: 1px solid <<colour foreground>>;
-	background: <<colour foreground>>;
-	margin: 0.5em;
-	border-radius: 6px;
-	padding: 0.5em;
-	color: <<colour background>>;
-	fill: <<colour background>>;
-}
-
-.tc-cards.tc-action-card .tc-card-button svg {
-	width: 0.65em;
-	height: 0.65em;
-	vertical-align: middle;
 }
 
 .tc-tiddlylink.tc-card {
 	font-weight: normal;
 	max-width: 100%;
 	position: relative;
+	display: flex;
+	flex-direction: column;
 	background: <<colour background>>;
 	color: <<colour foreground>>;
 	width: 200px;
 	min-height: 0;
+	padding: 0 0 0.5em 0;
+	margin: 0.5em;
 	border: none;
 	border-radius: 8px;
 	box-shadow: 0 1px 3px 0 #d4d4d5, 0 0 0 1px #d4d4d5;
 	transition: box-shadow 0.3s ease,transform .3s ease;
 }
 
-.tc-cards.tc-cards-vertical .tc-tiddlylink.tc-card {
-	width: 100%;
-}
-
 @media (max-width: 500px) {
 	
 	.tc-cards {
@@ -206,17 +180,8 @@ type: text/vnd.tiddlywiki
 }
 
 .tc-card-accent {
-	height: 100%;
-	display: flex;
-	align-items: stretch;
-	flex-direction: column;
-	justify-content: stretch;
-	border-radius: 8px;
-}
-
-.tc-cards.tc-cards-vertical .tc-card-accent {
-	flex-direction: row;
-	align-items: center;
+	border-top-left-radius: 8px;
+	border-top-right-radius: 8px;
 }
 
 .tc-tiddlylink.tc-card:hover {
@@ -268,8 +233,6 @@ type: text/vnd.tiddlywiki
 }
 
 .tc-card-image {
-	border-top-left-radius: 8px;
-	border-top-right-radius: 8px;
 	line-height: 0;
 	overflow: hidden;
 }
@@ -291,19 +254,7 @@ type: text/vnd.tiddlywiki
 	font-weight: 600;
 	transition: color 0.3s ease-in-out;
 	padding: 0 10px;
-	margin: 0.5em 0 0.25em 0;
-}
-
-.tc-cards.tc-cards-vertical .tc-card-title {
-	font-size: 1em;
-	min-width: 10em;
-	text-align: right;
-}
-
-.tc-cards.tc-cards-vertical .tc-card-title svg {
-	width: 1em;
-	height: 1em;
-	vertical-align: text-bottom;
+	margin: 0.5em 0;
 }
 
 .tc-card-subtitle,
@@ -319,17 +270,12 @@ type: text/vnd.tiddlywiki
 .tc-card-body {
 	font-size: 0.9em;
 	line-height: 1.2;
-	padding: 0.25em 10px;
+	padding: 0 10px;
 	margin: 0;
 }
 
-.tc-cards.tc-cards-vertical .tc-card-body {
-	font-size: 1em;
-}
-
 .tc-card-body-wrapper {
 	position: relative;
-	flex-grow: 1;
 }
 
 .tc-tiddlylink.tc-card.tc-card-quote .tc-card-body:before {
@@ -397,4 +343,4 @@ type: text/vnd.tiddlywiki
 	.multi-columns {
 		column-count: 2;
 	}
-}
+}

editions/tw5.com/tiddlers/system/wikitext-macros.tid

@@ -95,10 +95,10 @@ That renders as:
 <<tw-code $tiddler$>>
 \end
 
-\define flex-card(class,bordercolor:"",backgroundcolor:"",textcolor:"",imageField:"image",captionField:"caption",subtitle:"",descriptionField:"description",linkField:"link")
+\define flex-card(class,bordercolor:"",imageField:"image",captionField:"caption",subtitle:"",descriptionField:"description",linkField:"link")
 \whitespace trim
 <$link class={{{ [<__class__>addprefix[tc-card ]] }}} to={{{ [<currentTiddler>get<__linkField__>else<currentTiddler>] }}}>
-	<div class="tc-card-accent" style.borderTop={{{ [<__bordercolor__>!is[blank]addprefix[5px solid ]] }}} style.background={{!!background}} style.backgroundColor=<<__backgroundcolor__>> style.color=<<__textcolor__>> style.fill=<<__textcolor__>>>
+	<div class="tc-card-accent" style.borderTop={{{ [<__bordercolor__>!is[blank]addprefix[5px solid ]] }}}>
 		<$list filter="[<currentTiddler>has[ribbon-text]]" variable="ignore">
 			<div class="tc-card-ribbon-wrapper">
 				<div class="tc-card-ribbon" style.backgroundColor={{{ [<currentTiddler>get[ribbon-color]else[red]] }}}>
@@ -119,7 +119,6 @@ That renders as:
 				<$text text=<<__subtitle__>>/>
 			</div>
 		</$list>
-		<div class="tc-card-icon"><$transclude tiddler={{!!icon}}/></div>
 		<div class="tc-card-body-wrapper">
 			<div class="tc-card-body">
 				<$transclude field=<<__descriptionField__>> mode="block"/>
@@ -127,11 +126,6 @@ That renders as:
 			<div class="tc-card-body-clear">
 			</div>
 		</div>
-		<$list filter="[all[current]has[button-text]]" variable="ignore">
-			<div class="tc-card-button" style.background-color={{!!button-color}} style.border-color={{!!button-color}}>
-				<$text text={{!!button-text}}/>&#32;{{$:/core/images/chevron-right}}
-			</div>
-		</$list>
 	</div>
 </$link>
 \end

editions/tw5.com/tiddlers/widgets/CheckboxWidget (field Mode).tid

@@ -1,16 +0,0 @@
-caption: <<.attr field>>
-created: 20230314171223911
-description: tab
-modified: 20230317161110431
-tags: CheckboxWidget
-title: CheckboxWidget (field Mode)
-
-!!<<.link "<<.attr field>> Mode" "CheckboxWidget (field Mode)">>
-
-Using the checkbox widget in field mode requires the <<.attr field>> attribute to specify the name of the field. The <<.attr checked>> and <<.attr unchecked>> attributes specify the values to be assigned to the field to correspond to its checked and unchecked states respectively. The <<.attr default>> attribute is used as a fallback value if the field is missing or contains a value that does not correspond to the value of the <<.attr checked>> or <<.attr unchecked>> attributes.
-
-This example creates a checkbox that is checked if the field <<.field status>> is equal to <<.value open>> and unchecked if the field is equal to <<.value closed>>. If the field value is undefined then it defaults to <<.value closed>>.
-
-<<wikitext-example-without-html """<$checkbox field="status" checked="open" unchecked="closed" default="closed"> Is it open?</$checkbox>
-
-''status:'' {{!!status}}""">>

editions/tw5.com/tiddlers/widgets/CheckboxWidget (filter Mode).tid

@@ -1,23 +0,0 @@
-caption: <<.attr filter>>
-created: 20230314174505003
-description: tab
-modified: 20230325101447667
-tags: CheckboxWidget
-title: CheckboxWidget (filter Mode)
-
-!!<<.link "<<.attr filter>> Mode" "CheckboxWidget (filter Mode)">>
-
-Using the checkbox widget in filter mode requires the <<.attr filter>> attribute to contain a filter whose output will determine the checked state of the checkbox. In filter mode, checking the checkbox will not automatically make changes to any field of any tiddler. Instead, you can use the <<.attr actions>> attribute (or the <<.attr checkactions>> and <<.attr uncheckactions>> attributes) to specify what should happen when the checkbox is toggled. It is your responsibility to make sure the actions cause changes to the tiddlers or fields that the filter results depend on, so that the checkbox becomes properly checked or unchecked after the actions have triggered and the filter has updated.
-
-If the filter returns an empty result, the checkbox will be unchecked. Otherwise, if the filter result is non-empty, the checkbox will be checked.
-
-However, if either the <<.attr checked>> or <<.attr unchecked>> attributes (or both) are specified, then their values will be looked for in the filter result, instead of considering any non-empty value to mean <<.value checked>>.
-
-This example creates the same checkbox as in the <<.doc-tab-link "listField mode example" "CheckboxWidget (listField Mode)">>, selecting between <<.value red>> and <<.value green>> in the <<.field colors>> list field, but using filters and actions to make the change.
-
-<<wikitext-example-without-html """\define checkActions() <$action-listops $field="colors" $subfilter="-red green"/>
-\define uncheckActions() <$action-listops $field="colors" $subfilter="red -green"/>
-<$checkbox filter="[list[!!colors]]" checked="green" unchecked="red" default="red" checkactions=<<checkActions>> uncheckactions=<<uncheckActions>> > Is "green" in colors?</$checkbox>
-
-''colors:'' {{!!colors}}
-""">>

editions/tw5.com/tiddlers/widgets/CheckboxWidget (indeterminate).tid

@@ -1,31 +0,0 @@
-caption: <<.attr indeterminate>>
-created: 20230315173145042
-description: tab
-modified: 20230317160908743
-tags: CheckboxWidget
-title: CheckboxWidget (indeterminate)
-
-!!<<.link "<<.attr indeterminate>> Checkboxes" "CheckboxWidget (indeterminate)">>
-
-If both the <<.attr checked>> and <<.attr unchecked>> attributes are specified, but neither one is found in the specified field (or index), the result can be ambiguous. Should the checkbox be checked or unchecked? Normally in such cases the checkbox will be unchecked, but if the <<.attr indeterminate>> attribute is set to <<.value yes>> (default is <<.value no>>), the checkbox will instead be in an "indeterminate" state. An indeterminate checkbox counts as false for most purposes &mdash; if you click it, the checkbox will become checked and the <<.attr checkactions>>, if any, will be triggered &mdash; but indeterminate checkboxes are displayed differently in the browser.
-
-This example shows indeterminate checkboxes being used for categories in a shopping list (which could also be sub-tasks in a todo list, or many other things). If only some items in a category are selected, the category checkbox is indeterminate. You can click on the category checkboxes to see how indeterminate states are treated the same as the unchecked state, and clicking the box checks it and applies its check actions (in this case, checking all the boxes in that category). Try editing the <<.field fruits>> and <<.field vegetables>> fields on this tiddler and see what happens to the example when you do.
-
-<<wikitext-example-without-html """\define check-all(field-name:"items") <$action-listops $field="selected-$field-name$" $filter="[list[!!$field-name$]]" />
-\define uncheck-all(field-name:"items") <$action-listops $field="selected-$field-name$" $filter="[[]]" />
-
-<$checkbox filter="[list[!!selected-fruits]count[]]" checked={{{ [list[!!fruits]count[]] }}} unchecked="0" checkactions=<<check-all fruits>> uncheckactions=<<uncheck-all fruits>> indeterminate="yes"> fruits</$checkbox>
-<ul style="list-style: none">
-<$list variable="fruit" filter="[list[!!fruits]]">
-<li><$checkbox listField="selected-fruits" checked=<<fruit>>> <<fruit>></$checkbox></li>
-</$list>
-</ul>
-<$checkbox filter="[list[!!selected-vegetables]count[]]" checked={{{ [list[!!vegetables]count[]] }}} unchecked="0" checkactions=<<check-all vegetables>> uncheckactions=<<uncheck-all vegetables>> indeterminate="yes"> veggies</$checkbox>
-<ul style="list-style: none">
-<$list variable="veggie" filter="[list[!!vegetables]]">
-<li><$checkbox listField="selected-vegetables" checked=<<veggie>>> <<veggie>></$checkbox></li>
-</$list>
-</ul>
-
-<p>Selected veggies: {{!!selected-vegetables}}<br/>
-Selected fruits: {{!!selected-fruits}}</p>""">>

editions/tw5.com/tiddlers/widgets/CheckboxWidget (index Mode).tid

@@ -1,16 +0,0 @@
-caption: <<.attr index>>
-created: 20230314171351122
-description: tab
-modified: 20230317160939333
-tags: CheckboxWidget
-title: CheckboxWidget (index Mode)
-
-!!<<.link "<<.attr index>> Mode" "CheckboxWidget (index Mode)">>
-
-To use the checkbox widget in index mode set the <<.attr index>> attribute to a property of a [[DataTiddler|DataTiddlers]]. The <<.attr checked>> and <<.attr unchecked>> attributes specify the values to be assigned to the property and correspond to its checked and unchecked states respectively. The <<.attr default>> attribute is used as a fallback value if the property is undefined.
-
-<<.warning "Make sure to set <<.attr tiddler>> correctly, because non-[[DataTiddlers]] will be overwritten without warning">>
-
-The example below creates a checkbox that is checked if the property in the tiddler [[ExampleData]] by the name of the current tiddler is equal to <<.value selected>> and unchecked if the property is an empty string. If the property is undefined then it defaults to an empty string, meaning the checkbox will be unchecked if the property is missing.
-
-<$macrocall $name="wikitext-example-without-html" src="""<$checkbox tiddler="ExampleData" index=<<currentTiddler>> checked="selected" unchecked="" default=""> Selected?</$checkbox>"""/>

editions/tw5.com/tiddlers/widgets/CheckboxWidget (listField Mode).tid

@@ -1,26 +0,0 @@
-caption: <<.attr listField>>
-created: 20230314171331190
-description: tab
-modified: 20230317160948525
-tags: CheckboxWidget
-title: CheckboxWidget (listField Mode)
-
-!!<<.link "<<.attr listField>> Mode" "CheckboxWidget (listField Mode)">>
-
-Using the checkbox widget in list mode requires the <<.attr listField>> attribute to specify the name of a field containing a list. The <<.attr checked>> attribute specifies the value that should be present or absent in the list when the checkbox is checked or unchecked respectively. If <<.attr checked>> is absent (or empty) but <<.attr unchecked>> is present, then the logic will be inverted: the checkbox will be checked when the <<.attr unchecked>> value is missing from the list, and unchecked when the <<.attr unchecked>> value is found in the list. If both <<.attr checked>> and <<.attr unchecked>> are present, the checkbox will work like a toggle, replacing the <<.attr checked>> value with the <<.attr unchecked>> value and vice-versa. Finally, if neither <<.attr checked>> nor <<.attr unchecked>> is specified, the checkbox will be checked if the field has anything in it, but unchecked if the field is missing or empty. (This is rarely useful. Most of the time you want to specify <<.attr checked>> or <<.attr unchecked>> or both.)
-
-The <<.attr default>> attribute is used as a fallback for the checkbox state if the field is not defined.
-
-The following table summarizes the possible combinations:
-
-| !defined attributes| !<$checkbox tag="void" disabled="yes"/> | !<$checkbox field="tag" checked="void" default="void" disabled="yes" /> | !<$checkbox listField="tag" checked="void" unchecked="invalid" indeterminate="yes" disabled="yes" /> |
-| neither| field missing or list empty<br/>no <<.attr default>> defined | field has any value | -- |
-| <<.attr checked>>=<<.value item1>>| <<.value item1>> removed from list | <<.value item1>> added to list | -- |
-| <<.attr unchecked>>=<<.value item2>>| <<.value item2>> added to list | <<.value item2>> removed from list | -- |
-| both| <<.value item1>> removed from list<br/><<.value item2>> added to list | <<.value item1>> added to list<br/><<.value item2>> removed from list | <<.value item1>> not in list<br/><<.value item2>> not in list<br/>no <<.attr default>> defined |
-
-This example creates a checkbox that is checked if the list field named <<.field colors>> contains <<.value green>> and unchecked if the field contains <<.value red>>. If the field is undefined, or if neither <<.value green>> nor <<.value red>> appears in the field, then it defaults to <<.value green>>, meaning that the checkbox will be checked.
-
-<<wikitext-example-without-html """<$checkbox listField="colors" checked="green" unchecked="red" default="green"> Is "green" in colors?</$checkbox><br />''colors:'' {{!!colors}}""">>
-
-Try editing the <<.field colors>> field of this tiddler to see how the example changes.

editions/tw5.com/tiddlers/widgets/CheckboxWidget (listIndex Mode).tid

@@ -1,32 +0,0 @@
-caption: <<.attr listIndex>>
-created: 20230314174442174
-description: tab
-modified: 20230317160929003
-tags: CheckboxWidget
-title: CheckboxWidget (listIndex Mode)
-
-!!<<.link "<<.attr listIndex>> Mode" "CheckboxWidget (listIndex Mode)">>
-
-Using the checkbox widget in index list mode requires the <<.attr listIndex>> attribute to specify the the property of a [[DataTiddler|DataTiddlers]]. This property contains a list. The <<.attr checked>> attribute specifies the value that should be present or absent in the list when the checkbox is checked or unchecked respectively. If <<.attr checked>> is absent (or empty) but <<.attr unchecked>> is present, then the logic will be inverted: the checkbox will be checked when the <<.attr unchecked>> value is missing from the list, and unchecked when the <<.attr unchecked>> value is found in the list. If both <<.attr checked>> and <<.attr unchecked>> are present, the checkbox will work like a toggle, replacing the <<.attr checked>> value with the <<.attr unchecked>> value and vice-versa. Finally, if neither <<.attr checked>> nor <<.attr unchecked>> is specified, the checkbox will be checked if the field has anything in it, but unchecked if the field is missing or empty. (This is rarely useful. Most of the time you want to specify <<.attr checked>> or <<.attr unchecked>> or both.)
-
-The <<.attr default>> attribute is used as a fallback for the checkbox state if the property is undefined.
-
-The following table summarizes the possible combinations:
-
-| !defined attributes| !<$checkbox tag="void" disabled="yes"/> | !<$checkbox field="tag" checked="void" default="void" disabled="yes" /> | !<$checkbox listField="tag" checked="void" unchecked="invalid" indeterminate="yes" disabled="yes" /> |
-| neither| property missing or list empty<br/>no <<.attr default>> defined | property has any value | -- |
-| <<.attr checked>>=<<.value item1>>| <<.value item1>> removed from list | <<.value item1>> added to list | -- |
-| <<.attr unchecked>>=<<.value item2>>| <<.value item2>> added to list | <<.value item2>> removed from list | -- |
-| both| <<.value item1>> removed from list<br/><<.value item2>> added to list | <<.value item1>> added to list<br/><<.value item2>> removed from list | <<.value item1>> not in list<br/><<.value item2>> not in list<br/>no <<.attr default>> defined |
-
-<<.warning "Make sure to set <<.attr tiddler>> correctly, because non-[[DataTiddlers]] will be overwritten without warning">>
-
-The example below creates three checkboxes that each control a different value in a property of the ExampleData tiddler.
-
-<$macrocall $name="wikitext-example-without-html" src="""<$set name=indexName filter="[<currentTiddler>addsuffix[ Colors]]" >
-<$checkbox tiddler="ExampleData" listIndex=<<indexName>> checked="green" unchecked="red" default="red"> Green or red?</$checkbox><br/>
-<$checkbox tiddler="ExampleData" listIndex=<<indexName>> checked="yellow" unchecked="blue" default="blue"> Yellow or blue?</$checkbox><br/>
-<$checkbox tiddler="ExampleData" listIndex=<<indexName>> checked="orange" unchecked="purple" default="purple"> Orange or purple?</$checkbox><br/>
-Colors list: <$text text={{{ [[ExampleData]getindex<indexName>] }}} />
-</$set>
-"""/>

editions/tw5.com/tiddlers/widgets/CheckboxWidget (tag Mode).tid

@@ -1,18 +0,0 @@
-caption: <<.attr tag>>
-created: 20230314171205017
-description: tab
-modified: 20230317161122617
-tags: CheckboxWidget
-title: CheckboxWidget (tag Mode)
-
-!!<<.link "<<.attr tag>> Mode" "CheckboxWidget (tag Mode)">>
-
-Using the checkbox widget in tag mode requires the <<.attr tag>> attribute to specify the name of the tag. The checkbox will be checked if the tiddler specified in the <<.attr tiddler>> attribute has the specified tag and unchecked if it does not.
-
-This example creates a checkbox that flips the <<.tag done>> tag on the current tiddler:
-
-<<wikitext-example-without-html """<$checkbox tag="done"> Is it done?</$checkbox>""">>
-
-When the attribute <<.attr invertTag>> is set to <<.value yes>>, the checkbox will be checked if the tiddler does <<.em not>> have the specified tag and unchecked if it does.
-
-<<wikitext-example-without-html """<$checkbox tag="done" invertTag="yes"> Is it not done?</$checkbox>""">>

editions/tw5.com/tiddlers/widgets/CheckboxWidget.tid

@@ -1,13 +1,12 @@
 caption: checkbox
-colors: red orange yellow blue
 created: 20131024141900000
-fruits: bananas oranges grapes
-list: [[CheckboxWidget (tag Mode)]] [[CheckboxWidget (field Mode)]] [[CheckboxWidget (listField Mode)]] [[CheckboxWidget (index Mode)]] [[CheckboxWidget (listIndex Mode)]] [[CheckboxWidget (filter Mode)]] [[CheckboxWidget (indeterminate)]]
-modified: 20230316192632667
+modified: 20220402023600000
 tags: Widgets TriggeringWidgets
+colors: red orange yellow blue
+fruits: bananas oranges grapes
+vegetables: carrots potatoes
 title: CheckboxWidget
 type: text/vnd.tiddlywiki
-vegetables: carrots potatoes
 
 ! Introduction
 
@@ -21,22 +20,111 @@ The checkbox widget displays an HTML `<input type="checkbox">` element that is d
 The content of the `<$checkbox>` widget is displayed within an HTML `<label>` element immediately after the checkbox itself. This means that clicking on the content will toggle the checkbox.
 
 |!Attribute |!Description |
-|<<.attr tiddler>> |Title of the tiddler to manipulate (defaults to the [[Current Tiddler]]) |
-|<<.widget-attr-link tag "CheckboxWidget (tag Mode)">> |The name of the [[tag|Tagging]] to which the checkbox is bound |
-|<<.attr invertTag>> |When set to <<.value yes>>, flips the tag binding logic so that the absence of the tag causes the checkbox to be checked  |
-|<<.widget-attr-link field "CheckboxWidget (field Mode)">> |The name of the field to which the checkbox is bound |
-|<<.widget-attr-link listField "CheckboxWidget (listField Mode)">> |<<.from-version "5.2.3">> The name of the field that contains the list to which the checkbox is bound |
-|<<.widget-attr-link index "CheckboxWidget (index Mode)">> |<<.from-version "5.1.14">> The property of the [[DataTiddler|DataTiddlers]] to which the checkbox is bound|
-|<<.widget-attr-link listIndex "CheckboxWidget (listIndex Mode)">> |<<.from-version "5.2.3">> Like <<.attr index>>, but treats the value as a list the same way that <<.attr listField>> does |
-|<<.widget-attr-link filter "CheckboxWidget (filter Mode)">> |<<.from-version "5.2.3">> A filter whose output determines the checked state of the checkbox |
-|<<.attr checked>> |The value of the field corresponding to the checkbox being checked |
-|<<.attr unchecked>> |The value of the field corresponding to the checkbox being unchecked |
-|<<.attr default>> |The default value to use if the field is not defined |
-|<<.widget-attr-link indeterminate "CheckboxWidget (indeterminate)">> |Whether ambiguous values can produce indeterminate checkboxes (see below) |
-|<<.attr class>> |The class that will be assigned to the `<label>` element <$macrocall $name=".tip" _="""<<.from-version "5.2.3">> `tc-checkbox` is always applied by default, as well as `tc-checkbox-checked` when checked"""/> |
-|<<.attr actions>> |<<.from-version "5.1.14">> A string containing ActionWidgets to be triggered when the status of the checkbox changes (whether it is checked or unchecked) |
-|<<.attr uncheckactions>> |<<.from-version "5.1.16">> A string containing ActionWidgets to be triggered when the checkbox is unchecked |
-|<<.attr checkactions>> |<<.from-version "5.1.20">> A string containing ActionWidgets to be triggered when the checkbox is checked |
-|<<.attr disabled>> |<<.from-version "5.1.23">> Optionally disables the checkbox if set to <<.value yes>> (defaults to <<.value no>>)|
+|tiddler |Title of the tiddler to manipulate (defaults to the [[current tiddler|Current Tiddler]]) |
+|tag |The name of the tag to which the checkbox is bound |
+|invertTag |When set to ''yes'', flips the tag binding logic so that the absence of the tag causes the checkbox to be checked  |
+|field |The name of the field to which the checkbox is bound |
+|listField |<<.from-version "5.2.3">> The name of the field that contains the list to which the checkbox is bound |
+|index|<<.from-version "5.1.14">> The index of the //tiddler//, a [[DataTiddler|DataTiddlers]], to which the checkbox is bound<<.tip "be sure to set the //tiddler// correctly">>|
+|listIndex |<<.from-version "5.2.3">> Like <<.attr index>>, but treats the value as a list the same way that <<.attr listField>> does |
+|filter |<<.from-version "5.2.3">> A filter whose output determines the checked state of the checkbox |
+|checked |The value of the field corresponding to the checkbox being checked |
+|unchecked |The value of the field corresponding to the checkbox being unchecked |
+|default |The default value to use if the field is not defined |
+|indeterminate |Whether ambiguous values can produce indeterminate checkboxes (see below) |
+|class |The class that will be assigned to the label element <$macrocall $name=".tip" _="""<<.from-version "5.2.3">> `tc-checkbox` is always applied by default, as well as `tc-checkbox-checked` when checked"""/> |
+|actions |<<.from-version "5.1.14">> A string containing ActionWidgets to be triggered when the status of the checkbox changes (whether it is checked or unchecked) |
+|uncheckactions |<<.from-version "5.1.16">> A string containing ActionWidgets to be triggered when the checkbox is unchecked |
+|checkactions |<<.from-version "5.1.20">> A string containing ActionWidgets to be triggered when the checkbox is checked |
+|disabled|<<.from-version "5.1.23">> Optional, disables the checkbox if set to "yes". Defaults to "no"|
 
-<<.doc-tabs>>
+!! Tag Mode
+
+Using the checkbox widget in tag mode requires the ''tag'' attribute to specify the name of the tag. The ''tiddler'' attribute specifies the tiddler to target, defaulting to the current tiddler if not present.
+
+This example creates a checkbox that flips the ''done'' tag on the current tiddler:
+
+<<wikitext-example-without-html """<$checkbox tag="done"> Is it done?</$checkbox>""">>
+
+!! Field Mode
+
+Using the checkbox widget in field mode requires the ''field'' attribute to specify the name of the field. The ''checked'' and ''unchecked'' attributes specify the values to be assigned to the field to correspond to its checked and unchecked states respectively. The ''default'' attribute is used as a fallback value if the field is not defined.
+
+This example creates a checkbox that is checked if the field ''status'' is equal to ''open'' and unchecked if the field is equal to ''closed''. If the field is undefined then it defaults to ''closed'', meaning that the checkbox will be unchecked if the ''status'' field is missing.
+
+<<wikitext-example-without-html """<$checkbox field="status" checked="open" unchecked="closed" default="closed"> Is it open?</$checkbox><br />''status:'' {{!!status}}""">>
+
+!! List Mode
+
+Using the checkbox widget in list mode requires the ''listField'' attribute to specify the name of a field containing a list. The ''checked'' attribute specifies the value that should be present or absent in the list when the checkbox is checked or unchecked respectively. If ''checked'' is absent (or empty) but ''unchecked'' is present, then the logic will be inverted: the checkbox will be checked when the "unchecked" value is missing from the list, and unchecked when the "unchecked" value is found in the list. If both ''checked'' and ''unchecked'' are present, the checkbox will work like a toggle, replacing the ''checked'' value with the ''unchecked'' value and vice-versa. Finally, if neither ''checked'' nor ''unchecked'' is specified, the checkbox will be checked if the field has anything in it, but unchecked if the field is missing or empty. (This is rarely useful; most of the time you'll want to specify ''checked'' or ''unchecked'' or both.)
+
+The ''default'' attribute is used as a fallback for the checkbox state if the field is not defined.
+
+This example creates a checkbox that is checked if the list field named ''colors'' contains ''green'' and unchecked if the field contains ''red''. If the field is undefined, or if neither ''green'' nor ''red'' appears in the field, then it defaults to ''green'', meaning that the checkbox will be checked.
+
+<<wikitext-example-without-html """<$checkbox listField="colors" checked="green" unchecked="red" default="green"> Is it green?</$checkbox><br />''colors:'' {{!!colors}}""">>
+
+Try editing the ''colors'' field of this tiddler to see how the example changes.
+
+!! Index Mode
+
+To use the checkbox widget in index mode set the ''index'' attribute to the index of a [[DataTiddler|DataTiddlers]]. The ''checked'' and ''unchecked'' attributes specify the values to be assigned to the index and correspond to its checked and unchecked states respectively. The ''default'' attribute is used as a fallback value if the index is undefined.
+
+The example below creates a checkbox that is checked if the index by the name of this tiddler in the tiddler ExampleData is equal to ''selected'' and unchecked if the index is an empty string. If the index is undefined then it defaults to an empty string, meaning the checkbox will be unchecked if the index is missing.
+
+<$macrocall $name="wikitext-example-without-html" src="""<$checkbox tiddler="ExampleData" index=<<currentTiddler>> checked="selected" unchecked="" default=""> Selected?</$checkbox>"""/>
+
+!! Index List Mode
+
+Using the checkbox widget in index list mode requires the ''listIndex'' attribute to specify the the index of a [[DataTiddler|DataTiddlers]] containing a list. The ''checked'' attribute specifies the value that should be present or absent in the list when the checkbox is checked or unchecked respectively. If ''checked'' is absent (or empty) but ''unchecked'' is present, then the logic will be inverted: the checkbox will be checked when the "unchecked" value is missing from the list, and unchecked when the "unchecked" value is found in the list. If both ''checked'' and ''unchecked'' are present, the checkbox will work like a toggle, replacing the ''checked'' value with the ''unchecked'' value and vice-versa. Finally, if neither ''checked'' nor ''unchecked'' is specified, the checkbox will be checked if the field has anything in it, but unchecked if the field is missing or empty. (This is rarely useful; most of the time you'll want to specify ''checked'' or ''unchecked'' or both.)
+
+The ''default'' attribute is used as a fallback for the checkbox state if the index is undefined.
+
+The example below creates three checkboxes that each control a different value in an index field of the ExampleData tiddler.
+
+<$macrocall $name="wikitext-example-without-html" src="""
+<$set name=indexName filter="[<currentTiddler>addsuffix[ Colors]]" >
+<$checkbox tiddler="ExampleData" listIndex=<<indexName>> checked="green" unchecked="red" default="red"> Green or red?</$checkbox> <br/>
+<$checkbox tiddler="ExampleData" listIndex=<<indexName>> checked="yellow" unchecked="blue" default="blue"> Yellow or blue?</$checkbox> <br/>
+<$checkbox tiddler="ExampleData" listIndex=<<indexName>> checked="orange" unchecked="purple" default="purple"> Orange or purple?</$checkbox> <br />
+Colors list: {{{ [[ExampleData]getindex<indexName>] }}}
+</$set>
+"""/>
+
+!! Filter Mode
+
+Using the checkbox widget in filter mode requires the ''filter'' attribute to contain a filter whose output will determine the checked state of the checkbox. In filter mode, checking the checkbox will not automatically make changes to any field of any tiddler. Instead, you can use the ''actions'' attribute (or ''checkactions'' and ''uncheckactions'') to specify what should happen when the checkbox is toggled. It is your responsibility to make sure the actions cause changes to the tiddlers or fields that the filter results depend on, so that the checkbox becomes properly checked or unchecked after the actions have triggered.
+
+If the filter returns an empty result, the checkbox will be unchecked. Otherwise, if the filter result is non-empty, the checkbox will be checked. However, if either the ''checked'' or ''unchecked'' attributes (or both) are specified, then their values will be looked for in the filter result, instead of considering any non-empty value to mean "checked".
+
+This example creates the same checkbox as in the list mode example, selecting between ''red'' and ''green'' in the ''colors'' list field, but using filters and actions to make the change.
+
+<<wikitext-example-without-html """\define checkActions() <$action-listops $field="colors" $subfilter="-red green"/>
+\define uncheckActions() <$action-listops $field="colors" $subfilter="red -green"/>
+<$checkbox filter="[list[!!colors]]" checked="green" unchecked="red" default="red" checkactions=<<checkActions>> uncheckactions=<<uncheckActions>> > Is "green" in colors?</$checkbox><br />''colors:'' {{!!colors}}
+""">>
+
+!! Indeterminate checkboxes
+
+If both the ''checked'' and ''unchecked'' attributes are specified, but neither one is found in the specified field (or index), the result can be ambiguous. Should the checkbox be checked or unchecked? Normally in such cases the checkbox will be unchecked, but if the ''indeterminate'' attribute is set to "yes" (default is "no"), the checkbox will instead be in an "indeterminate" state. An indeterminate checkbox counts as false for most purposes &mdash; if you click it, the checkbox will become checked and the ''checkactions'', if any, will be triggered &mdash; but indeterminate checkboxes are displayed differently in the browser.
+
+This example shows indeterminate checkboxes being used for categories in a shopping list (which could also be sub-tasks in a todo list, or many other things). If only some items in a category are selected, the category checkbox is indeterminate. You can click on the category checkboxes to see how indeterminate states are treated the same as the unchecked state, and clicking the box checks it and applies its check actions (in this case, checking all the boxes in that category). Try editing the <<.field fruits>> and <<.field vegetables>> fields on this tiddler and see what happens to the example when you do.
+
+<<wikitext-example-without-html """\define check-all(field-name:"items") <$action-listops $field="selected-$field-name$" $filter="[list[!!$field-name$]]" />
+\define uncheck-all(field-name:"items") <$action-listops $field="selected-$field-name$" $filter="[[]]" />
+
+<$checkbox filter="[list[!!selected-fruits]count[]]" checked={{{ [list[!!fruits]count[]] }}} unchecked="0" checkactions=<<check-all fruits>> uncheckactions=<<uncheck-all fruits>> indeterminate="yes"> fruits</$checkbox>
+<ul style="list-style: none">
+<$list variable="fruit" filter="[list[!!fruits]]">
+<li><$checkbox listField="selected-fruits" checked=<<fruit>>> <<fruit>></$checkbox></li>
+</$list>
+</ul>
+<$checkbox filter="[list[!!selected-vegetables]count[]]" checked={{{ [list[!!vegetables]count[]] }}} unchecked="0" checkactions=<<check-all vegetables>> uncheckactions=<<uncheck-all vegetables>> indeterminate="yes"> veggies</$checkbox>
+<ul style="list-style: none">
+<$list variable="veggie" filter="[list[!!vegetables]]">
+<li><$checkbox listField="selected-vegetables" checked=<<veggie>>> <<veggie>></$checkbox></li>
+</$list>
+</ul>
+
+<p>Selected veggies: {{!!selected-vegetables}}<br/>
+Selected fruits: {{!!selected-fruits}}</p>""">>

licenses/cla-individual.md

@@ -527,5 +527,3 @@ Andrea Octo, @andrigamerita, 2023/02/24
 HuanC Fu, @hffqyd, 2023/03/03
 
 Michelle Saad, @michsa, 2023-03-08
-
-Yukai Chou, @muzimuzhi, 2023-04-07