tiddlywiki 5.2.1 → 5.2.2

package/editions/tw5.com/tiddlers/community/Forums.tid

@@ -1,28 +1,31 @@
 created: 20140721121924384
-modified: 20201222114755959
+modified: 20220131165124489
 tags: Community
 title: Forums
 type: text/vnd.tiddlywiki
 
-! Users
+! Official Forums
 
-The ~TiddlyWiki discussion groups are mailing lists for talking about ~TiddlyWiki: requests for help, announcements of new releases and plugins, debating new features, or just sharing experiences. You can participate via the associated website, or subscribe via email.
+The new official forum for talking about ~TiddlyWiki: requests for help, announcements of new releases and plugins, debating new features, or just sharing experiences. You can participate via the associated website, or subscribe via email.
 
-* The main ~TiddlyWiki group: https://groups.google.com/group/TiddlyWiki
-*> Note that you do not need a Google Account to join the discussion groups. Subscribe by sending an email to mailto:tiddlywiki+subscribe@googlegroups.com.
-** An enhanced group search facility is available on [[mail-archive.com|https://www.mail-archive.com/tiddlywiki@googlegroups.com/]]
-* Watch recordings of our regular [[TiddlyWiki Hangouts]]
-* Follow [[@TiddlyWiki on Twitter|http://twitter.com/TiddlyWiki]] for the latest news
-* New: Join us on our live chat at https://gitter.im/TiddlyWiki/public !
-* There is also a discord available at https://discord.gg/HFFZVQ8
+https://talk.tiddlywiki.org/
 
+Note that talk.tiddlywiki.org is a community run service that we host and maintain ourselves. The modest running costs are covered by community contributions.
 
-! Developers
+For the convenience of existing users, we also continue to operate the original ~TiddlyWiki group (hosted on Google Groups since 2005):
+
+https://groups.google.com/group/TiddlyWiki
+
+! Developer Forums
 
 {{Developers}}
 
-New releases of TiddlyWiki, TiddlyDesktop and TiddlyFox are announced via the discussion groups and [[Twitter|https://twitter.com/TiddlyWiki]] (you can also subscribe to an Atom/RSS feed of [[TiddlyWiki releases from GitHub|https://github.com/jermolene/tiddlywiki5/releases.atom]])
+! Other Forums
+
+* [[TiddlyWiki Subreddit|https://www.reddit.com/r/TiddlyWiki5/]]
+* Chat with Gitter at https://gitter.im/TiddlyWiki/public !
+* Chat on Discord at https://discord.gg/HFFZVQ8
 
-! Documentation
+!! Documentation
 
 There is also a discussion group specifically for discussing TiddlyWiki documentation improvement initiatives: https://groups.google.com/group/tiddlywikidocs

package/editions/tw5.com/tiddlers/community/Signing the Contributor License Agreement.tid

@@ -1,5 +1,5 @@
 created: 20150630205653005
-modified: 20190115165616599
+modified: 20220226175503241
 tags: 
 title: Signing the Contributor License Agreement
 type: text/vnd.tiddlywiki
@@ -8,7 +8,7 @@ Create a GitHub pull request to add your name to `cla-individual.md` or `cla-ent
 
 ''step by step''
 
-# Navigate to [[licenses/CLA-individual|https://github.com/Jermolene/TiddlyWiki5/tree/master/licenses/cla-individual.md]] or [[licenses/CLA-entity|https://github.com/Jermolene/TiddlyWiki5/tree/master/licenses/cla-entity.md]] according to whether you are signing as an individual or representative of an organisation
+# Navigate to [[licenses/CLA-individual|https://github.com/Jermolene/TiddlyWiki5/tree/tiddlywiki-com/licenses/cla-individual.md]] or [[licenses/CLA-entity|https://github.com/Jermolene/TiddlyWiki5/tree/tiddlywiki-com/licenses/cla-entity.md]] according to whether you are signing as an individual or representative of an organisation
 # Ensure that the "branch" dropdown at the top left is set to `tiddlywiki-com`
 # Click the "edit" button at the top-right corner (clicking this button will fork the project so you can edit the file)
 # Add your name at the bottom

package/editions/tw5.com/tiddlers/community/plugins/TiddlyClip by buggyjay.tid

@@ -1,14 +1,14 @@
 created: 20140910102845245
-modified: 20210106151027576
+modified: 20220311184412211
 tags: [[Community Plugins]]
 title: TiddlyClip by buggyjay
 type: text/vnd.tiddlywiki
 url: http://tiddlyclip.tiddlyspot.com
 
-BuggyJay's TiddlyClip browser extension for [[Firefox]] permits clipping of text and graphics from web pages:
+~BuggyJay's ~TiddlyClip browser extension for Firefox permits clipping of text and graphics from web pages:
 
 {{!!url}}
 
 <<<
-TiddlyClip allows parts of webpages to be clipped into a TiddlyWiki, and consists of two parts, the browser addon and the TiddlyWiki plugin. The addon is completely memoryless, any configuration is determined by the current TiddlyWiki that the user has select to work with (we say that the addon is docked to the TiddlyWiki). TiddlyClip is designed to work (in a basic mode) without configuration. Once the addon and plugin are installed, all the user has to do is select which TW to dock to.
+~TiddlyClip allows parts of webpages to be clipped into a ~TiddlyWiki, and consists of two parts, the browser addon and the ~TiddlyWiki plugin. The addon is completely memoryless, any configuration is determined by the current ~TiddlyWiki that the user has select to work with (we say that the addon is docked to the ~TiddlyWiki). ~TiddlyClip is designed to work (in a basic mode) without configuration. Once the addon and plugin are installed, all the user has to do is select which TW to dock to.
 <<<

package/editions/tw5.com/tiddlers/concepts/Cascades.tid

@@ -39,6 +39,7 @@ The TiddlyWiki core uses cascades to choose the following elements:
 |[[View Template Title Cascade]] |The template used to display the title of a particular tiddler (used by the default view template to display the tiddler title) |
 |[[View Template Body Cascade]] |The template used to display the view mode body of a particular tiddler (used by the default view template to display the tiddler body) |
 |[[Edit Template Body Cascade]] |The template used to display the edit mode body of a particular tiddler (used by the default edit template to display the tiddler body editor) |
+|[[Field Editor Cascade]] |The template used to display the edit mode of a tiddler field (used by the default edit template to display the field editor) |
 
 You can see the current settings for each cascade in $:/ControlPanel under the ''Info'' -> ''Advanced'' -> ''Cascades'' tab.
 

package/editions/tw5.com/tiddlers/concepts/Customizing EditTemplate Field Rendering.tid

@@ -0,0 +1,31 @@
+created: 20220305183700000
+modified: 20220305183700000
+tags: Concepts
+title: Customizing EditTemplate field rendering
+type: text/vnd.tiddlywiki
+
+When editing a tiddler the [[EditTemplate|$:/core/ui/EditTemplate/fields]] normally renders fields as simple input boxes. To modify this behaviour, the [[cascade mechanism|Cascades]] can be used. Via the [[Field Editor Cascade|Field Editor Cascade]] the name of the tiddler used for rendering the field editor can be specified. The content of this tiddler is transcluded to represent the content of the field.
+
+To modify the appearance of all fields whose name ends with `-date` create a new tiddler and add the `$:/tags/FieldEditorFilter` tag to it. Add a `list-before` field and assign the value `$:/config/FieldEditorFilters/default`. Now you have to put the filter for the cascade into the tiddler's text field: `[regexp[-date$]then[$:/config/EditTemplateFields/Templates/dates]]`. This will transclude the tiddler named `$:/config/EditTemplateFields/Templates/dates` to render the input elements for all fields with names matching the regular expression.
+
+The variables `currentTiddler` and `currentField` are set to pass information about the tiddler and field that are edited to the transcluded tiddler.
+
+For example, a tiddler containing the following WikiText would render the field as an HTML input element of the type `date`. This will show a date picker for the fields on all modern browsers:
+
+```
+<$edit-text tiddler=<<currentTiddler>> field=<<currentField>> type="date" class="tc-edit-texteditor" placeholder="Set your date" tabindex={{$:/config/EditTabIndex}} cancelPopups="yes"/>
+```
+
+The `tabindex` and `cancelPopups` attributes make sure the HTML input element behaves exactly the default elements provided by TiddlyWiki.
+
+Not only the `EditTextWidget` can be used. A tiddler containing the following WikiText will render the field as a drop-down-list that allows the user to select the name of a tiddler. The name of the selected tiddler will be stored in the field.
+
+```
+<$select tiddler=<<currentTiddler>> field=<<currentField>> class="tc-edit-texteditor" cancelPopups="yes">
+    <$list filter='[all[tiddlers]sort[title]]'>
+        <option value=<<currentTiddler>>><$view field='title'/></option>
+    </$list>
+</$select>
+```
+
+The class `tc-edit-texteditor` should be used to style the `input` and `select` elements to match the theme of the TiddlyWiki installation.

package/editions/tw5.com/tiddlers/concepts/Field Editor Cascade.tid

@@ -0,0 +1,17 @@
+created: 20220305173931551
+modified: 20220305173931551
+tags: Cascades
+title: Field Editor Cascade
+type: text/vnd.tiddlywiki
+
+The field editor cascade is a [[cascade|Cascades]] used to choose a template for rendering the field editor within the [[EditTemplate|$:/core/ui/EditTemplate/fields]].
+
+The default field editor cascade only contains one element:
+
+# Use the tiddler $:/core/ui/EditTemplate/fieldEditor/default to render the field
+
+See [[Customizing EditTemplate field rendering]] for more details.
+
+You can see the current settings for the field editor cascade in $:/ControlPanel under the ''Info'' -> ''Advanced'' -> ''Cascades''  -> ''Field Editor'' tab.
+
+<<list-links "[tag[Tiddler Field Editor Cascade]]">>

package/editions/tw5.com/tiddlers/concepts/Filters.tid

@@ -1,23 +1,28 @@
 created: 20130827080000000
-modified: 20150221225414000
+list: [[Introduction to filter notation]] [[Filter Syntax]]
+modified: 20220316145511797
 tags: Reference Concepts
 title: Filters
 type: text/vnd.tiddlywiki
-list: [[Introduction to filter notation]] [[Filter Syntax]]
+
+\define openAdvancedSearch()
+<$action-setfield $tiddler="$:/state/tab--1498284803" text="$:/core/ui/AdvancedSearch/Filter"/>
+<$action-setfield $tiddler="$:/temp/advancedsearch/input" text="[tag[Filters]]"/>
+<$action-setfield $tiddler="$:/temp/advancedsearch" text="[tag[Filters]]"/>
+\end
 
 You can think of TiddlyWiki as a database in which the records are tiddlers. A database typically provides a way of discovering which records match a given pattern, and in ~TiddlyWiki this is done with filters.
 
 A <<.def filter>> is a concise notation for selecting a particular [[set of tiddlers|Title Selection]], known as its <<.def "output">>. Whenever ~TiddlyWiki encounters a filter, it calculates the output. Further work can then be done with just those tiddlers, such as [[counting|CountWidget]] or [[listing|ListWidget]] them.
 
-The following example passes a filter to the <<.mlink list-links>> macro to display a list of all tiddlers whose titles start with the letter H:
+The following example passes a filter to the <<.mlink list-links>> macro to display a list of all tiddlers whose titles are <<.olink2 tagged tag>> with the word <<.word Filters>>:
+
+<<wikitext-example-without-html """<<list-links "[tag[Filters]]">>""" >>
 
-> `<<list-links "[prefix[H]]">>`
+A filter output can change as tiddlers are added and deleted in the wiki. ~TiddlyWiki recalculates on the fly, automatically updating any filter-based counts or lists as well.
 
-A filter's output can change as tiddlers are added and deleted in the wiki. ~TiddlyWiki recalculates on the fly, automatically updating any filter-based counts or lists as well.
+''Find out more:''
 
-[[Advanced Search|$:/AdvancedSearch]] has a <<.advancedsearch-tab Filter>> tab that makes it easy to experiment with filters.
+* <$linkcatcher message="tm-navigate" actions=<<openAdvancedSearch>> >[[Advanced Search|$:/AdvancedSearch]]</$linkcatcher> -- has a <<.advancedsearch-tab Filter>> tab that makes it easy to experiment with filters.
 
-;Find out more:
-* [[Introduction to filter notation]] -- a step-by-step walkthrough
-* [[Filter Syntax]] -- the detailed technical rules
-* [[Filter Operators]] -- the available methods of filtering
+* [[Filtered Transclusions|Transclusion in WikiText]] -- If you want to use filter results in your text

package/editions/tw5.com/tiddlers/concepts/Macros.tid

@@ -1,5 +1,5 @@
 created: 20140211171341271
-modified: 20200103092706002
+modified: 20220128112317724
 tags: Concepts Reference
 title: Macros
 type: text/vnd.tiddlywiki
@@ -14,8 +14,6 @@ They are created using the `\define` [[pragma|Pragma]]. (Behind the scenes, this
 
 The snippet and its incoming parameter values are treated as simple strings of characters with no WikiText meaning, at least until the placeholders have been filled in and the macro call has returned. This means that a macro can assemble and return the complete syntax of a ~WikiText component, such as a [[link|Linking in WikiText]]. (See [[Transclusion and Substitution]] for further discussion of this.)
 
-The string returned by a macro call is parsed separately from any surrounding ~WikiText components. So a safe way to insert a special character sequence (such as `[[` or `<`) without triggering its normal ~WikiText meaning is to wrap it in a macro.
-
 Within a snippet itself, the only markup detected is `$name$` (a placeholder for a macro parameter) and `$(name)$` (a placeholder for a [[variable|Variables]]).
 
 The <<.mlink dumpvariables>> macro lists all variables (including macros) that are available at that position in the widget tree.

package/editions/tw5.com/tiddlers/concepts/Pragma.tid

@@ -1,6 +1,6 @@
 created: 20150219175930000
-modified: 20180928145730028
-tags: Concepts
+modified: 20220122182842041
+tags: Concepts [[WikiText Parser Modes]]
 title: Pragma
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/concepts/TiddlerFields.tid

@@ -1,5 +1,5 @@
 created: 20130825213300000
-modified: 20191206152031468
+modified: 20220109101407050
 tags: Concepts
 title: TiddlerFields
 type: text/vnd.tiddlywiki
@@ -25,6 +25,7 @@ Other fields used by the core are:
 
 |!Field Name |!Description |
 |`class` |<<lingo class>> |
+|`code-body` |<<.from-version "5.2.1">> <<lingo code-body>> |
 |`color` |<<lingo color>> |
 |`description` |<<lingo description>> |
 |`draft.of` |<<lingo draft.of>> |