tiddlywiki 5.2.0 → 5.2.3

package/editions/tw5.com/tiddlers/widgets/SelectWidget.tid

@@ -1,7 +1,7 @@
 caption: select
 created: 20131024141900000
-modified: 20190304122040876
-tags: Widgets
+modified: 20211108165037846
+tags: TriggeringWidgets Widgets
 title: SelectWidget
 type: text/vnd.tiddlywiki
 
@@ -129,3 +129,16 @@ This example uses the `multiple` keyword to specify that we should be able to se
 <$view field='title' /><br />
 </$list>
 "/>
+
+!! Actions 
+
+This example uses the actions attribute to apply days of the week as tags to the current tiddler.
+
+<$macrocall $name="wikitext-example-without-html" src="""<$select tiddler='$:/generated-list-demo-state' field='actions-test' 
+actions='<$action-listops $field="myfield" $tags={{$:/generated-list-demo-state!!actions-test}}/>'
+>
+<$list filter='[list[Days of the Week]]'>
+<option><$view field='title'/></option>
+</$list>
+</$select>
+"""/>

package/editions/tw5.com/tiddlers/widgets/SetMultipleVariablesWidget.tid

@@ -0,0 +1,33 @@
+caption: setmultiplevariables
+created: 20211023162409163
+modified: 20211023162409163
+tags: Widgets
+title: SetMultipleVariablesWidget
+type: text/vnd.tiddlywiki
+
+! Introduction
+
+The setmultiplevariables widget assigns values to multiple [[variables|Variables]] where the names and values of the variables are specified as separate filter.
+
+! Content and Attributes
+
+The content of the `<$setmultiplevariables>` widget is the scope for the value assigned to the variable.
+
+|!Attribute |!Description |
+|$names |Filter evaluating to the names of a list of variables to assign |
+|$values |Filter evaluating to the values corresponding to the list of names specified in `$names` |
+
+! Examples
+
+Here is an example of a convoluted way to display the values of the fields of the tiddler "HelloThere":
+
+<$macrocall $name='wikitext-example-without-html'
+src="""<$setmultiplevariables $names="[[HelloThere]fields[]addprefix[demo-]]" $values="[[HelloThere]fields[]] :map[[HelloThere]get<currentTiddler>]">
+<ol>
+<$list filter="[variables[]prefix[demo-]sort[]]">
+<li>
+''<$text text={{{ [<currentTiddler>removeprefix[demo-]] }}}/>'': <$text text={{{ [<currentTiddler>getvariable[]] }}}/>
+</li>
+</$list>
+</ol>
+</$setmultiplevariables>"""/>

package/editions/tw5.com/tiddlers/widgets/SetWidget.tid

@@ -1,6 +1,6 @@
 caption: set
 created: 20131115182700000
-modified: 20210505095640228
+modified: 20220523075522407
 tags: Widgets
 title: SetWidget
 type: text/vnd.tiddlywiki
@@ -71,6 +71,8 @@ src="""<$set name="myVariable" filter="[all[current]field:title[myMagicTitle]]"
 
 This form of the set variable widget evaluates the filter and assigns the result to the variable as a space-separated list (using double square brackets for titles containing spaces).
 
+<<.warning """The [[Title List]] format cannot reliably represent items that contain certain specific character sequences such as `]] `. Thus it should not be used where there is a possibility of such sequences occurring.""">>
+
 <<<
 
 <$macrocall $name='wikitext-example-without-html' 

package/editions/tw5.com/tiddlers/widgets/The Extended Listops Filters.tid

@@ -6,9 +6,10 @@ item2: seven
 item3: eight
 list: Yesterday Today Tomorrow
 marker: Thursday
-modified: 20151108054957921
+modified: 20211114011103356
 myfield: Monday Tuesday [[Middle of the Week]] Thursday Friday Saturday Sunday
 numbers: 1 2 3 4 five 6 7 8 9
+tags: Filters
 title: The Extended Listops Filters
 
 ! Introduction

package/editions/tw5.com/tiddlers/widgets/TranscludeWidget.tid

@@ -1,9 +1,9 @@
+caption: transclude
 created: 20130824142500000
-modified: 20140717175900970
+modified: 20220513114759336
 tags: Widgets
 title: TranscludeWidget
 type: text/vnd.tiddlywiki
-caption: transclude
 
 ! Introduction
 
@@ -22,12 +22,12 @@ The TranscludeWidget treats any contained content as a fallback if the target of
 
 ! Parsing modes
 
-TiddlyWiki parses text in two modes:
+TiddlyWiki [[parses text in two modes|WikiText Parser Modes]]:
 
-* ''inline'' mode recognises character formatting such as emphasis, links
-* ''block'' mode recognises all the ''inline'' formatting, and adds block formatting such as tables, headings and lists
+* [[inline mode|Inline Mode WikiText]] recognises character formatting such as emphasis, links
+* [[block mode|Block Mode WikiText]] recognises all the ''inline'' formatting, and adds block formatting such as tables, headings and lists
 
-Usually, the mode is determined by whether the transclude widget itself has been parsed in block or inline mode. This can be overridden with the `mode` attribute.
+Usually, the mode is determined by whether the transclude widget itself has been parsed in block or inline mode. This can be overridden with the <<.attr mode>> attribute.
 
 For example, consider tiddler "A" with this content:
 
@@ -57,6 +57,7 @@ This can be fixed by amending tiddler "A":
 #<$transclude tiddler="B" mode="block"/>
 # Item two
 ```
+See also these [[other examples|WikiText parser mode: transclusion examples]].
 
 ! ~SubTiddler Access
 
@@ -64,7 +65,4 @@ The transclude widget allows access to the individual tiddlers stored within a [
 
 The following example will transclude the core version of the tiddler [[$:/DefaultTiddlers]] even if it has been overridden:
 
-<<wikitext-example-without-html '
-<$transclude tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>
-
-'>>
+<<wikitext-example-without-html """<$transclude tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>""">>

package/editions/tw5.com/tiddlers/widgets/TriggeringWidgets.tid

@@ -0,0 +1,13 @@
+created: 20211031172716741
+modified: 20211113163836901
+tags: Widgets
+title: TriggeringWidgets
+type: text/vnd.tiddlywiki
+
+Triggering widgets are a type of widget which can trigger ActionWidgets. Typically these widgets (such as the ButtonWidget) will trigger actions based on interaction from the user.
+
+The following triggering widgets are provided:
+
+<<list-links "[tag[TriggeringWidgets]]">>
+
+See ActionWidgets for more information and examples of how TriggeringWidgets and ActionWidgets work together.

package/editions/tw5.com/tiddlers/widgets/VarsWidget.tid

@@ -6,20 +6,22 @@ caption: vars
 
 ! Introduction
 
-The ''vars'' widget allows multiple variables to be set in one operation. In some situations it can result in simpler code than using the more flexible SetWidget.
+The <<.wid vars>> widget allows multiple variables to be set in one operation. In some situations it can result in simpler code than using the more flexible <<.wlink SetWidget>> widget. It differs from the <<.wlink LetWidget>> in that variables cannot interfere with the evaluation of other variables within the same <<.wid vars>>.
 
 ! Content and Attributes
 
-The content of the `<$vars>` widget is the scope for the value assigned to the variable.
+The content of the <<.wid vars>> widget is the scope for the value assigned to the variable.
 
 |!Attribute |!Description |
 |//{attributes not starting with $}// |Each attribute name specifies a variable name. The attribute value is assigned to the variable |
 
+Attributes will not interfere with the evaluation of other attributes. So if one attribute sets <<.attr currentTiddler>>, and another attribute uses <<.attr currentTiddler>> in its evaluation, it will use the value of <<.attr currentTiddler>> that exists outside the widget's scope.
+
 ! Examples
 
 Consider a case where you need to set multiple variables.
 
-Using the `<$vars>` widget, this situation may be handled in the following way:
+Using the <<.wid vars>> widget, this situation may be handled in the following way:
 
 ```
 \define helloworld() Hello world!
@@ -29,7 +31,7 @@ Using the `<$vars>` widget, this situation may be handled in the following way:
 </$vars>
 ```
 
-In contrast, here is the same example using the `<$set>` widget:
+In contrast, here is the same example using the <<.wid set>> widget:
 
 ```
 <$set name="greeting" value="Hi" >
@@ -43,7 +45,7 @@ In contrast, here is the same example using the `<$set>` widget:
 
 ! Remarks
 
-It should be noted that this widget differs from the set widget in the following ways:
+It should be noted that this widget differs from the <<.wid set>> widget in the following ways:
 
 * A fallback (also known as "emptyValue") cannot be specified
 * Filters cannot be used to produce a conditional variable assignement

package/editions/tw5.com/tiddlers/widgets/ViewWidget.tid

@@ -1,6 +1,6 @@
 caption: view
 created: 20131024141900000
-modified: 20210402093330113
+modified: 20211219213444235
 tags: Widgets
 title: ViewWidget
 type: text/vnd.tiddlywiki
@@ -27,18 +27,18 @@ The content of the `<$view>` widget is displayed if the field or property is mis
 The following formats can be specified in the `format` attribute:
 
 |!Format |!Description |
-|''text'' |Plain text (default) |
-|''htmlencoded'' |The field is displayed with HTML encoding |
+|''text'' |Plain text (default) <<.tip "See also the TextWidget. `<$view format=text tiddler=MyTiddler/>` renders the same as `<$text text={{MyTiddler}}/>`">>|
+|''htmlencoded'' |The field is displayed with HTML encoding. <<.tip "Rendered value is the same as the output from the [[encodehtml|encodehtml Operator]] filter operator">>  |
 |''htmltextencoded'' |<<.from-version "5.2.0">> The field is displayed with HTML encoding, only double quotes (") are not escaped. This creates a more compact htmlencoding appropriate for html text content, but //not// for attributes. |
-|''urlencoded'' |The field is displayed with URL encoding |
-|''doubleurlencoded'' |The field is displayed with double URL encoding |
+|''urlencoded'' |The field is displayed with URL encoding <<.tip "Rendered value is the same as the output from the [[encodeuri|encodeuri Operator]] filter operator">> |
+|''doubleurlencoded'' |The field is displayed with double URL encoding <<.tip "Rendered value is the same as the output from calling the [[encodeuri|encodeuri Operator]] filter operator twice">> |
 |''htmlwikified'' |The field is wikified according to the mode attribute and the resulting HTML returned as plain text (ie HTML elements will appear in plain text) |
 |''plainwikified'' |The field is wikified according to the mode attribute and the text content of the resulting HTML returned as plain text (ie HTML elements will be removed) |
 |''htmlencodedplainwikified'' |The field is wikified according to the mode attribute and the text content of the resulting HTML returned as HTML encoded plain text (ie HTML elements will be removed) |
-|''date'' |The field is interpreted as a UTC date and displayed according to the DateFormat specified in the `template` attribute |
-|''relativedate'' |The field is interpreted as a UTC date and displayed as the interval from the present instant |
+|''date'' |The field is interpreted as a UTC date and displayed according to the DateFormat specified in the `template` attribute <<.tip "Rendered value is the same as the output from the [[format:date|format Operator]] filter operator">> |
+|''relativedate'' |The field is interpreted as a UTC date and displayed as the interval from the present instant <<.tip "Rendered value is the same as the output from the [[format:relativedate|format Operator]] filter operator">> |
 |''stripcomments'' |The field is interpreted as JavaScript source code and any lines beginning `\\#` are stripped |
-|''jsencoded'' |The field is displayed as a JavaScript encoded string |
+|''jsencoded'' |The field is displayed as a JavaScript encoded string <<.tip "Rendered value is the same as the output from the [[stringify|stringify Operator]] filter operator">> |
 
 !! "WikiText format"
 
@@ -54,3 +54,21 @@ The following example will view the core version of the tiddler [[$:/DefaultTidd
 <$view tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>
 
 '>>
+
+! Examples
+
+Given this [[Saturday]] example tiddler:
+
+|!tiddler|!raw content|!rendered content|
+|[[Saturday]]|<$text text={{Saturday}}/>|{{Saturday}}|
+
+Here is how `<$view tiddler=Saturday format=<<format>>/>` renders for each format:
+<table>
+<tr><th>format</th><th>renders as</th></tr>
+<$list filter="text htmlencoded htmltextencoded urlencoded doubleurlencoded htmlwikified plainwikified htmlencodedplainwikified stripcomments jsencoded" variable=format>
+<tr>
+<td>''<<format>>''</td>
+<td><$view tiddler="Saturday" format=<<format>>/></td>
+</tr>
+</$list>
+</table>

package/editions/tw5.com/tiddlers/widgets/WikifyWidget.tid

@@ -1,6 +1,6 @@
 caption: wikify
 created: 20160321144949700
-modified: 20161017122117062
+modified: 20220122191540121
 tags: Widgets
 title: WikifyWidget
 type: text/vnd.tiddlywiki
@@ -17,7 +17,7 @@ The content of the `<$wikify>` widget is the scope for the value assigned to the
 |name |The name of the variable to assign |
 |text |The text to parse and render |
 |type |The ContentType of the text (defaults to `text/vnd.tiddlywiki`) |
-|mode |The parse mode: `block` (the default) or `inline` |
+|mode |The parse mode: [[block|Block Mode WikiText]] (the default) or [[inline|Inline Mode WikiText]] |
 |output |Keyword indicating the desired output type, defaulting to `text` (see below) |
 
 The available output types are:

package/editions/tw5.com/tiddlers/wikitext/Code Blocks in WikiText.tid

@@ -1,14 +1,13 @@
 caption: Code Blocks
 created: 20131205160047557
-modified: 20160606140326254
+modified: 20220513120302826
 tags: WikiText
 title: Code Blocks in WikiText
 type: text/vnd.tiddlywiki
 
 You can use triple backticks <code>&#96;&#96;&#96;</code> to mark code blocks (<<.icon $:/core/images/mono-block>>):
 
-<pre>
-&#96;&#96;&#96;
+<pre>&#96;&#96;&#96;
 This will be monospaced
 &#96;&#96;&#96;
 </pre>
@@ -23,8 +22,7 @@ To be interpreted correctly, the three backticks need to be at the start of the
 
 Be aware that any preceding paragraph content should be properly terminated with a double line break, too. So, this example is wrong:
 
-<pre>
-This is an ordinary paragraph
+<pre>This is an ordinary paragraph
 &#96;&#96;&#96;
 This will be monospaced
 &#96;&#96;&#96;
@@ -32,8 +30,7 @@ This will be monospaced
 
 The correct version is:
 
-<pre>
-This is an ordinary paragraph
+<pre>This is an ordinary paragraph
 
 &#96;&#96;&#96;
 This will be monospaced

package/editions/tw5.com/tiddlers/wikitext/Dashes in WikiText.tid

@@ -1,8 +1,12 @@
+caption: Dashes
 created: 20131205160641986
-modified: 20131205160653909
+modified: 20220513111920644
+revision: 0
 tags: WikiText
 title: Dashes in WikiText
 type: text/vnd.tiddlywiki
-caption: Dashes
 
-You can create an n-dash with a double hyphen `--` and an m-dash with a triple hyphen `---`. For example -- this is an example --- and so is this
+You can create an n-dash with a double hyphen -- and an m-dash with a triple hyphen `---`.
+
+<<wikitext-example src:"""* -- n-dash example 
+* --- m-dash example --- have fun!""">>

package/editions/tw5.com/tiddlers/wikitext/Formatting in WikiText.tid

@@ -1,6 +1,6 @@
 caption: Formatting
 created: 20131205155959399
-modified: 20160606135946509
+modified: 20220513120211686
 tags: WikiText
 title: Formatting in WikiText
 type: text/vnd.tiddlywiki
@@ -8,12 +8,12 @@ type: text/vnd.tiddlywiki
 Available character formatting includes:
 
 * <code>&#96;backticks&#96;</code> for `code` (<<.icon $:/core/images/mono-line>>)
-** Alternatively, <code>&#96;&#96;double backticks allows &#96;embedded&#96; backticks&#96;&#96;</code>
-* `''bold''` for ''bold text'' (<<.icon $:/core/images/bold>>)
-* `//italic//` for //italic text// (<<.icon $:/core/images/italic>>)
-* `__underscore__` for __underscored text__ (<<.icon $:/core/images/underline>>)
-* `^^superscript^^` for ^^superscripted^^ text (<<.icon $:/core/images/superscript>>)
-* `,,subscript,,` for ,,subscripted,, text (<<.icon $:/core/images/subscript>>)
+** Alternatively, <code>&#96;&#96;double backticks allows &#96;embedded&#96; backticks&#96;&#96;</code><br><br>
+* `''bold''` for ''bold text'' (<<.icon $:/core/images/bold>>)<br><br>
+* `//italic//` for //italic text// (<<.icon $:/core/images/italic>>)<br><br>
+* `__underscore__` for __underscored text__ (<<.icon $:/core/images/underline>>)<br><br>
+* `^^superscript^^` for ^^superscripted^^ text (<<.icon $:/core/images/superscript>>)<br><br>
+* `,,subscript,,` for ,,subscripted,, text (<<.icon $:/core/images/subscript>>)<br><br>
 * `~~strikethrough~~` for ~~strikethrough~~ text (<<.icon $:/core/images/strikethrough>>)
 
 See also: [[Code Blocks in WikiText]]

package/editions/tw5.com/tiddlers/wikitext/HTML in WikiText.tid

@@ -1,6 +1,6 @@
 caption: HTML
 created: 20131205160816081
-modified: 20210614100305329
+modified: 20220123174919252
 tags: WikiText
 title: HTML in WikiText
 type: text/vnd.tiddlywiki
@@ -35,9 +35,11 @@ some text <!-- inline comment -->
 
 ! Block mode versus Inline mode
 
-To get the content of an HTML element to be parsed in block mode, the opening tag must be followed by two linebreaks.
+To get the content of an HTML element to be [[parsed|WikiText Parser Modes]] in [[block mode|Block Mode WikiText]], the opening tag must be followed by two linebreaks.
 
-Without the two linebreaks, the tag content will be parsed in inline mode which means that block mode formatting such as wikitext tables, lists and headings is not recognised.
+Without the two linebreaks, the tag content will be [[parsed|WikiText Parser Modes]] in [[inline mode|Inline Mode WikiText]] which means that block mode formatting such as wikitext tables, lists and headings is not recognised.
+
+See also [[WikiText parser mode: HTML examples]] and [[WikiText parser mode transitions]].
 
 ! Self closing elements
 
@@ -56,6 +58,26 @@ In an extension of conventional HTML syntax, attributes of elements/widgets can
 * a transclusion of a [[macro/variable|Macros in WikiText]]
 * as the result of a [[Filter Expression]]
 
+!! Style Attributes
+
+<<.from-version "5.2.2">> TiddlyWiki supports the usual HTML ''style'' attribute for assigning CSS styles to elements:
+
+```
+<div style="color:red;">Hello</div>
+```
+
+In an extension to HTML, TiddlyWiki also supports accessing individual CSS styles as independent attributes. For example:
+
+```
+<div style.color="red">Hello</div>
+```
+
+The advantage of this syntax is that it simplifies assigning computed values to CSS styles. For example:
+
+```
+<div style.color={{!!color}}>Hello</div>
+```
+
 !! Literal Attribute Values
 
 Literal attribute values can use several different styles of quoting:
@@ -92,6 +114,7 @@ attr={{tiddler}}
 attr={{!!field}}
 attr={{tiddler!!field}}
 ```
+<<.warning "The attribute's value will be the exact text retrieved from the TextReference. Any wiki syntax in that text will be left as-is.">>
 
 !! Variable Attribute Values
 
@@ -102,14 +125,17 @@ Variable attribute values are indicated with double angle brackets around a [[ma
 ...
 </div>
 ```
+<<.warning "The text from the macro's definition will be retrieved and text substitution will be performed (i.e. <<.param $param$>> and <<.param &#36;(...)&#36;>> syntax). The attribute's value will be the resulting text. Any wiki syntax in that text (including further macro calls and variable references) will be left as-is.">>
 
 !! Filtered Attribute Values
 
 Filtered attribute values are indicated with triple curly braces around a [[Filter Expression]]. The value will be the first item in the resulting list, or the empty string if the list is empty.
 
+<<.from-version "5.2.2">> To improve readability, newlines can be included anywhere that whitespace is allowed within filtered attributes.
+
 This example shows how to add a prefix to a value:
 
 ```
 <$text text={{{ [<currentTiddler>addprefix[$:/myprefix/]] }}} />
 ```
-
+<<.warning "The attribute's value will be the exact text from the first item in the resulting list. Any wiki syntax in that text will be left as-is.">>

package/editions/tw5.com/tiddlers/wikitext/Headings in WikiText.tid

@@ -1,9 +1,9 @@
+caption: Headings
 created: 20131205161234909
-modified: 20190412000000000
+modified: 20220513110830487
 tags: WikiText
 title: Headings in WikiText
 type: text/vnd.tiddlywiki
-caption: Headings
 
 Headings are specified with one up to six leading `!` characters:
 
@@ -17,4 +17,4 @@ Headings are specified with one up to six leading `!` characters:
 
 CSS classes can be assigned to individual headings like this:
 
-<<wikitext-example src:"" "!!.myStyle This heading has the class `myStyle`">>
+<<wikitext-example src:"""!!.myStyle This heading has the class `myStyle`""">>

package/editions/tw5.com/tiddlers/wikitext/Horizontal Rules in WikiText.tid

@@ -1,12 +1,10 @@
+caption: Horizontal Rules
 created: 20131205160706975
-modified: 20131205160719633
+modified: 20220513111257531
 tags: WikiText
 title: Horizontal Rules in WikiText
 type: text/vnd.tiddlywiki
-caption: Horizontal Rules
 
 You can include a horizontal rule with three or more dashes on their own on a line:
 
-<<wikitext-example src:"
----
-">>
+<<wikitext-example src:"---">>

package/editions/tw5.com/tiddlers/wikitext/Images in WikiText.tid

@@ -1,6 +1,6 @@
 caption: Images
 created: 20131205160221762
-modified: 20210519160846733
+modified: 20220129152627668
 tags: WikiText [[Working with TiddlyWiki]]
 title: Images in WikiText
 type: text/vnd.tiddlywiki
@@ -14,7 +14,7 @@ Images can be included in WikiText with the following syntax:
 [img[https://tiddlywiki.com/favicon.ico]]
 ```
 
-You can also insert images from the editor toolbar. Click ''picture'' (<<.icon $:/core/images/picture>>) and select a picture file.
+You can also insert image tiddlers from the editor toolbar. Click ''picture'' (<<.icon $:/core/images/picture>>) and select a picture file.
 
 If the image source is the title of an image tiddler then that tiddler is directly displayed. Otherwise it is interpreted as a URL and an HTML `<img>` tag is generated with the `src` attribute containing the URL.
 
@@ -63,6 +63,6 @@ Renders as:
 ! Importing Images
 
 Use the <<.button import>> button (under the <<.sidebar-tab Tools>> tab in the sidebar), or drag and drop.
-See [[ImportingTiddlers]] for details.
+See [[Importing Tiddlers]] for details.
 
 <<.from-version "5.2.0">> You can also import images by dropping or pasting images into the tiddler editor.

package/editions/tw5.com/tiddlers/wikitext/Linking in WikiText.tid

@@ -1,6 +1,6 @@
 caption: Linking
 created: 20131205155230596
-modified: 20160607095245257
+modified: 20211230145939554
 tags: WikiText
 title: Linking in WikiText
 type: text/vnd.tiddlywiki
@@ -80,3 +80,46 @@ You can also use the extended syntax to force an external link:
 
 See the LinkWidget for details of the underlying widget used to implement tiddler links, including macros that can be used to customise its behaviour.
 
+! Generating dynamic links
+
+[[Linking in WikiText]] does not lend itself well to creating dynamic links. The reason is because this WikiText link:
+
+```
+[[link to myself|Linking in WikiText]]
+```
+is shorthand for using the LinkWidget and TextWidget like this:
+
+```
+<$link to="Linking in WikiText">
+  <$text text="link to myself"/>
+</$link>
+```
+Since both the link title ("link to myself") and the link target ("Linking in ~WikiText") are used as widget attributes, no WikiText expansion takes place.
+
+For example, an attempt to use a [[reference|TextReference]] and a [[variable|Variables]] to dynamically generate a link like this:
+
+<<.bad-example "`[[{{!!caption}}|<<currentTiddler>>]]`">>
+
+is the same as trying to use the LinkWidget and TextWidget like this:
+
+<<.bad-example """```
+<$link to="<<currentTiddler>>">
+  <$text text="{{!!caption}}"/>
+</$link>
+```""">>
+
+This will not work as desired. Content inside of quoted widget attributes is [[treated as a literal value|HTML in WikiText]] and protected from WikiText expansion, so it will render like this:
+
+<<.bad-example "[[{{!!caption}}|<<currentTiddler>>]]">>
+
+In order to get the desired result, the LinkWidget can be used directly like this:
+
+<<wikitext-example-without-html src:"<$link to=<<currentTiddler>>>{{!!caption}}</$link>">>
+
+See also another example of [[constructing dynamic links|Concatenating text and variables using macro substitution]].
+
+! Linking within tiddlers - "anchor links"
+
+In TiddlyWiki anchor links can help us link to target points and distinct sections within rendered tiddlers. They can help the reader navigate longer tiddler content.
+
+See [[Anchor Links using HTML]] for more information.

package/editions/tw5.com/tiddlers/wikitext/Macro Calls in WikiText.tid

@@ -1,9 +1,9 @@
+caption: Macro Calls
 created: 20150220182252000
-modified: 20150221221340000
+modified: 20220122193853161
 tags: WikiText
 title: Macro Calls in WikiText
 type: text/vnd.tiddlywiki
-caption: Macro Calls
 
 To call a [[macro|Macros]], place `<<`double angle brackets`>>` around the name and any parameter values.
 
@@ -19,7 +19,7 @@ The syntax is actually a shorthand for a <<.wlink MacroCallWidget>> widget. The
 
 As macros are simply parameterised [[variables|Variables]], a variable's value can be inserted using the same techniques.
 
-[[Examples|Macro Calls in WikiText (Examples)]]
+[[Examples|Macro Calls in WikiText (Examples)]] and [[more examples|WikiText parser mode: macro examples]]
 
 !! Named vs.unnamed parameters