npm - tiddlywiki - Versions diffs - 5.2.3 → 5.2.5 - Mend

tiddlywiki 5.2.3 → 5.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (412) hide show

package/editions/tw5.com/tiddlers/system/wikitext-macros.tid CHANGED Viewed

@@ -46,21 +46,17 @@ open the ''example edition'' in a new window
 <$macrocall $name="copy-to-clipboard-above-right" src=<<__src__>>/>
-```
-$src$
-```
+<$codeblock code=<<__src__>>/>
 That renders as:
-$$$text/vnd.tiddlywiki
-$src$
-$$$
+<$macrocall $name="__src__"/>
 ... and the underlying HTML is:
-$$$text/vnd.tiddlywiki>text/html
-$src$
-$$$
+<$wikify name="html" text=<<__src__>> output="html">
+<$codeblock code=<<html>>/>
+</$wikify>
 </div>
 \end
@@ -69,15 +65,12 @@ $$$
 <$macrocall $name="copy-to-clipboard-above-right" src=<<__src__>>/>
-```
-$src$
-```
+<$codeblock code=<<__src__>>/>
 That renders as:
-$$$text/vnd.tiddlywiki
-$src$
-$$$
+<$macrocall $name="__src__"/>
 </div>
 \end
@@ -101,3 +94,38 @@ $$$
 <<tw-code $tiddler$>>
 \end
+\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 ]] }}}>
+		<$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]] }}}>
+					<div class="tc-card-ribbon-inner">
+						<$text text={{!!ribbon-text}}/>
+					</div>
+				</div>
+			</div>
+		</$list>
+		<$list filter="[<currentTiddler>has<__imageField__>]" variable="ignore">
+			<div class="tc-card-image">
+				<$image source={{{ [<currentTiddler>get<__imageField__>] }}}/>
+			</div>
+		</$list>
+		<div class="tc-card-title"><$transclude field=<<__captionField__>>><$view field="title"/></$transclude></div>
+		<$list filter="[<__subtitle__>!is[blank]]" variable="ignore">
+			<div class="tc-card-subtitle">
+				<$text text=<<__subtitle__>>/>
+			</div>
+		</$list>
+		<div class="tc-card-body-wrapper">
+			<div class="tc-card-body">
+				<$transclude field=<<__descriptionField__>> mode="block"/>
+			</div>
+			<div class="tc-card-body-clear">
+			</div>
+		</div>
+	</div>
+</$link>
+\end

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_ClassFilters_PageTemplate.tid ADDED Viewed

@@ -0,0 +1,9 @@
+caption: $:/tags/ClassFilters/PageTemplate
+created: 20221020035315795
+description: marks filters evaluated to dynamically add classes to the page template.
+modified: 20221020035945262
+tags: SystemTags
+title: SystemTag: $:/tags/ClassFilters/PageTemplate
+type: text/vnd.tiddlywiki
+The [[system tag|SystemTags]] `$:/tags/ClassFilters/PageTemplate` marks filters marks filters evaluated to dynamically add their output as CSS classes to the page template.

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_ClassFilters_TiddlerTemplate.tid ADDED Viewed

@@ -0,0 +1,9 @@
+caption: $:/tags/ClassFilters/TiddlerTemplate
+created: 20221020035738692
+description: marks filters evaluated to dynamically add classes to the page template.
+modified: 20221020035933363
+tags: SystemTags
+title: SystemTag: $:/tags/ClassFilters/TiddlerTemplate
+type: text/vnd.tiddlywiki
+The [[system tag|SystemTags]] `$:/tags/ClassFilters/TiddlerTemplate`  marks filters evaluated to dynamically add their output as CSS classes to the tiddler template.

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_Filter.tid CHANGED Viewed

@@ -1,9 +1,9 @@
 caption: $:/tags/Filter
 created: 20180926170345251
-description: marks filters in advanced seach sample filter dropdown
+description: marks filters in advanced search sample filter dropdown
 modified: 20180926171456495
 tags: SystemTags
 title: SystemTag: $:/tags/Filter
 type: text/vnd.tiddlywiki
-The [[system tag|SystemTags]] `$:/tags/Filter` marks filters in advanced seach sample filter dropdown
+The [[system tag|SystemTags]] `$:/tags/Filter` marks filters in advanced search sample filter dropdown

package/editions/tw5.com/tiddlers/testimonials/Testimonials - Joe Armstrong.tid ADDED Viewed

@@ -0,0 +1,8 @@
+title: Testimonials - Joe Armstrong
+tags: Testimonial
+caption: Joe Armstrong, Co-inventor of Erlang
+extlink: https://joearms.github.io/
+The ~TiddlyWiki is the best software I've ever found for organising my ideas.
+It's well worth spending an hour or so playing with it to see how it can help you. This will be time well-spent and will change how you think and how you organise your ideas.

package/editions/tw5.com/tiddlers/testimonials/Testimonials - Network World.tid ADDED Viewed

@@ -0,0 +1,8 @@
+title: Testimonials - Network World
+tags: Testimonial
+caption: Mark Gibbs, Network World
+extlink: http://www.networkworld.com/article/3028098/open-source-tools/tiddlywiki-a-free-open-source-wiki-revisited.html
+~TiddlyWiki gets a Gearhead rating of 6 out of 5 (it's that good).
+Finding code that works flawlessly after just two or three years is magical enough but after seven years?!

package/editions/tw5.com/tiddlers/testimonials/Testimonials - Product Hunt.tid ADDED Viewed

@@ -0,0 +1,6 @@
+title: Testimonials - Product Hunt
+tags: Testimonial
+caption: Product Hunt
+extlink: https://www.producthunt.com/posts/tiddlywiki-2?utm_source=badge-top-post-badge&utm_medium=badge&utm_souce=badge-tiddlywiki-2
+<div style="text-align:center;">{{Product Hunt Link}}</div>

package/editions/tw5.com/tiddlers/webserver/Using the external JavaScript template.tid CHANGED Viewed

@@ -1,22 +1,22 @@
 created: 20180905075846391
-modified: 20210611055708739
+modified: 20221207112242775
 tags: [[WebServer Guides]]
 title: Using the external JavaScript template
 type: text/vnd.tiddlywiki
-You can use a special template to externalise TiddlyWiki's core code into a separate file. This configuration allows the browser to cache the core for improved efficiency.
+You can use a special template to externalise ~TiddlyWiki's core code into a separate file. This configuration allows the browser to cache the core for improved efficiency.
 ! Background
-TiddlyWiki in the single file configuration ordinarily packs everything into a single file: your data, and the ~JavaScript, CSS and HTML comprising TiddlyWiki itself. This lack of dependencies is usually very convenient: it means that it is impossible for the parts of a TiddlyWiki to become separated, and enormously improves the chances of it still functioning in the future.
+~TiddlyWiki in the single file configuration ordinarily packs everything into a single file: your data, and the ~JavaScript, CSS and HTML comprising ~TiddlyWiki itself. This lack of dependencies is usually very convenient: it means that it is impossible for the parts of a ~TiddlyWiki to become separated, and enormously improves the chances of it still functioning in the future.
 However, there is some inefficiency in this arrangement because the core code is repeatedly loaded and saved every time the content of the wiki is saved. This inefficiency is partially ameliorated when working in the client server configuration because once the wiki is loaded by the browser the synchronisation process only transmits individual tiddlers back and forth to the server.
-The remaining inefficiency when working in the client server configuration is that the single page wiki that is initially loaded will contain a copy of the entire core code of TiddlyWiki, making it impossible for the browser to cache it.
+The remaining inefficiency when working in the client server configuration is that the single page wiki that is initially loaded will contain a copy of the entire core code of ~TiddlyWiki, making it impossible for the browser to cache it.
-! Using the external JavaScript template with the client-server configuration
+! Using the external ~JavaScript template with the client-server configuration
-The mechanism is activated by setting the [[root-tiddler|WebServer Parameter: root-tiddler]] parameter to `$:/core/save/all-external-js`. This template externalises TiddlyWiki's core JavaScript into a separate file. For example, the following command will start your server with caching enabled. It will transfer the wiki with two GET requests, and the core can be cached by the browser.
+The mechanism is activated by setting the [[root-tiddler|WebServer Parameter: root-tiddler]] parameter to `$:/core/save/all-external-js`. This template externalises ~TiddlyWiki's core ~JavaScript into a separate file. For example, the following command will start your server with caching enabled. It will transfer the wiki with two GET requests, and the core can be cached by the browser.
 ```
 tiddlywiki YOUR_WIKI_FOLDER --listen 'root-tiddler=$:/core/save/all-external-js' use-browser-cache=yes
@@ -38,11 +38,11 @@ tiddlywiki ./myNewWiki --build listen
 The above commands perform the following:
 * Create a new wiki with external JavaScript customization included.
-* Start the server with external JavaScript enabled. The server listens on port 8080. Visit http://localhost:8080 in your browser.
+* Start the server with external ~JavaScript enabled. The server listens on port 8080. Visit http://localhost:8080 in your browser.
 To customize your `--build listen` command, see [[tiddlywiki.info Files]] and [[ListenCommand]].
-! Using the external JavaScript template with the single file configuration
+! Using the external ~JavaScript template with the single file configuration
 You can use the "external-js" template with your single file wiki, but this requires that you have ~TiddlyWiki's core ~JavaScript saved alongside your HTML file. You may prefer this configuration, for example, if you have several wikis on a ~WebDav server. (See: [[Saving via WebDAV]])
@@ -64,7 +64,7 @@ The files `index.html` and `tiddlywikicore-5.x.x.js` will be saved in your wiki
 !! Obtaining the ~TiddlyWiki core in the browser
-To download a copy of the TiddlyWiki core JavaScript file from any existing TiddlyWiki, visit the system tiddler $:/core/ui/ExportTiddlyWikiCore and click the download button. (You can search for ''~ExportTiddlyWikiCore'' in the ''Shadows'' tab of $:/AdvancedSearch).
+{{$:/core/ui/ExportTiddlyWikiCore}}
 !! Obtaining the ~TiddlyWiki core with Node.js
@@ -87,7 +87,7 @@ tiddlywiki YOUR_WIKI_FOLDER --build tiddlywikicore
 <<.warning "This procedure is experimental, please take care to backup your data">>
-Before you proceed, backup your wiki first! Follow the steps below to upgrade a single-file wiki with the external JavaScript template:
+Before you proceed, backup your wiki first! Follow the steps below to upgrade a single-file wiki with the external ~JavaScript template:
 # Proceed with the [[Upgrade Process for Standalone TiddlyWikis|Upgrading]]. Your wiki will be converted to a full standalone HTML.

package/editions/tw5.com/tiddlers/webserver/WebServer API_ Get All Tiddlers.tid CHANGED Viewed

@@ -1,5 +1,5 @@
 created: 20181002131215403
-modified: 2020031109590546
+modified: 20220909094340097
 tags: [[WebServer API]]
 title: WebServer API: Get All Tiddlers
 type: text/vnd.tiddlywiki
@@ -17,6 +17,8 @@ Parameters:
 In order to avoid denial of service attacks with malformed filters in the default configuration the only filter that is accepted is the default filter "[all[tiddlers]!is[system]sort[title]]"; attempts to use any other filter will result in an HTTP 403 error.
+<<.note "System tiddlers will not be returned by this API unless the [[Hidden Setting: Sync System Tiddlers From Server]] is explicitly switched on by setting $:/config/SyncSystemTiddlersFromServer to `yes`">>
 To enable a particular filter, create a tiddler with the title "$:/config/Server/ExternalFilters/" concatenated with the filter text, and the text field set to "yes". For example, the TiddlyWeb plugin includes the following shadow tiddler to enable the filter that it requires:
 ```

package/editions/tw5.com/tiddlers/widgets/ActionPopupWidget.tid CHANGED Viewed

@@ -1,6 +1,6 @@
 caption: action-popup
 created: 20200303114556528
-modified: 20210501203451387
+modified: 20220815205132124
 tags: Widgets ActionWidgets
 title: ActionPopupWidget
 type: text/vnd.tiddlywiki
@@ -15,10 +15,11 @@ The ''action-popup'' widget is invisible. Any content within it is ignored.
 |!Attribute |!Description |
 |$state |The title of the state tiddler for the popup |
-|$coords |Optional coordinates for the handle to which popup is positioned (in the format `(x,y,w,h)`) |
+|$coords |Optional coordinates for the handle to which popup is positioned (see [[Coordinate Systems]] for the supported formats) |
 |$floating |<<.from-version "5.2.0">> Optional. Defaults to `no`. Set to `yes` to create a popup that must be closed explicitly. |
-<<.from-version "5.1.23">> If the ''$coords'' attribute is missing or empty then all popups are cancelled.
+<<.from-version "5.1.23">> If the ''$coords'' attribute is missing or empty then all popups are cancelled.<br/>
+<<.from-version "5.2.4">> The ''$coords'' attribute supports absolute and relative coordinates. See [[Coordinate Systems]] for more information.
 <<.tip "Delete the state tiddler for a floating popup to close it.">>

package/editions/tw5.com/tiddlers/widgets/ButtonWidget.tid CHANGED Viewed

@@ -1,6 +1,6 @@
 caption: button
 created: 20131024141900000
-modified: 20211009121239795
+modified: 20220810192251345
 tags: Widgets TriggeringWidgets
 title: ButtonWidget
 type: text/vnd.tiddlywiki
@@ -37,6 +37,7 @@ The content of the `<$button>` widget is displayed within the button.
 |default |Default value if <<.attr set>> tiddler is missing for testing against <<.attr setTo>> to determine <<.attr selectedClass>> |
 |popup |Title of a state tiddler for a popup that is toggled when the button is clicked. See PopupMechanism for details |
 |popupTitle |Title of a state tiddler for a popup that is toggled when the button is clicked. In difference to the <<.attr popup>> attribute, ''no'' TextReference is used. See PopupMechanism for details |
+|popupAbsCoords |<<.from-version "5.2.4">> If set to ''yes'' writes absolute coordinates to the tiddler referenced by the <<.attr popup>>. If set to ''no'' (the default) uses relative coordinates. See [[Coordinate Systems]] for details |
 |aria-label |Optional [[Accessibility]] label |
 |tooltip |Optional tooltip |
 |class |An optional CSS class name to be assigned to the HTML element|

package/editions/tw5.com/tiddlers/widgets/DraggableWidget.tid CHANGED Viewed

@@ -41,7 +41,8 @@ The LinkWidget incorporates the functionality of the DraggableWidget via the ''d
 |!Variables |!Description |
 |`modifier` |The [[modifier Variable]] contains the Modifier Key held while dragging |
 |`dom-*` |All DOM attributes of the node being dragged are made available as variables, with the prefix `dom-` |
-|`tv-popup-coords` |A co-ordinate string that can be used with the ActionPopupWidget to trigger a popup at the DOM node that's being dragged where the event originated |
+|`tv-popup-coords` |A relative co-ordinate string that can be used with the ActionPopupWidget to trigger a popup at the DOM node matching the selector where the event originated (see [[Coordinate Systems]] for more information) |
+|`tv-popup-abs-coords` |<<.from-version "5.2.4">> An absolute co-ordinate string that can be used with the ActionPopupWidget to trigger a popup at the DOM node matching the selector where the event originated (see [[Coordinate Systems]] for more information) |
 |`tv-selectednode-posx` |`x` offset position of the dragged DOM node |
 |`tv-selectednode-posy` |`y` offset position of the dragged DOM node  |
 |`tv-selectednode-width` |`offsetWidth` of the dragged DOM node |

package/editions/tw5.com/tiddlers/widgets/ErrorWidget.tid ADDED Viewed

@@ -0,0 +1,17 @@
+caption: error
+created: 20220909111836951
+modified: 20220909111836951
+tags: Widgets
+title: ErrorWidget
+type: text/vnd.tiddlywiki
+<<.from-version "5.2.4">> The <<.wlink ErrorWidget>> widget is used by the core to display error messages such as the recursion errors reported by the <<.wlink TranscludeWidget>> widget.
+The <<.wlink ErrorWidget>> does not provide any useful functionality to end users. It is only required by the core for technical reasons.
+! Content and Attributes
+The content of the <<.wlink ErrorWidget>> widget is ignored.
+|!Attribute |!Description |
+|$message |The error message |

package/editions/tw5.com/tiddlers/widgets/EventCatcherWidget.tid CHANGED Viewed

@@ -1,5 +1,5 @@
 created: 20201123113532200
-modified: 20220507184043398
+modified: 20221012194222875
 tags: Widgets TriggeringWidgets
 title: EventCatcherWidget
 type: text/vnd.tiddlywiki
@@ -10,7 +10,7 @@ type: text/vnd.tiddlywiki
 //This is an advanced widget intended for use by those familiar with HTML, CSS and JavaScript handling of DOM events.//
-The event catcher widget traps DOM-initiated Javascript events dispatched within its child content, and allows invoking a series of ActionWidgets in response to those events.
+The event catcher widget traps DOM-initiated Javascript events dispatched within its child content, and allows invoking a series of ActionWidgets in response to those events.
 In order for the events to be trapped:
@@ -47,7 +47,8 @@ The following variables are made available to the actions:
 |`event-mousebutton` |The mouse button (if any) used to trigger the event (can be "left", "right" or "middle"). Note that not all event types support the mousebutton property |
 |`event-type` |The type property of the JavaScript event |
 |`event-detail-*` |Any properties in the detail attribute of the event are made available with the prefix `event-detail-` |
-|`tv-popup-coords` |A co-ordinate string that can be used with the ActionPopupWidget to trigger a popup at the DOM node matching the selector where the event originated |
+|`tv-popup-coords` |A relative co-ordinate string that can be used with the ActionPopupWidget to trigger a popup at the DOM node matching the selector where the event originated (see [[Coordinate Systems]] for more information) |
+|`tv-popup-abs-coords` |<<.from-version "5.2.4">> An absolute co-ordinate string that can be used with the ActionPopupWidget to trigger a popup at the DOM node matching the selector where the event originated (see [[Coordinate Systems]] for more information) |
 |`tv-widgetnode-width` |<<.from-version "5.2.3">> `offsetWidth` of the DOM node created by the eventcatcher widget |
 |`tv-widgetnode-height` |<<.from-version "5.2.3">> `offsetHeight` of the DOM node created by the eventcatcher widget |
 |`tv-selectednode-posx` |`x` offset position of the selected DOM node |

package/editions/tw5.com/tiddlers/widgets/GenesisWidget.tid ADDED Viewed

@@ -0,0 +1,41 @@
+caption: genesis
+created: 20221101100729587
+modified: 20221101100729587
+tags: Widgets
+title: GenesisWidget
+type: text/vnd.tiddlywiki
+! Introduction
+<<.from-version "5.2.4">> The <<.wlink GenesisWidget>> widget allows the dynamic construction of another widget, where the name and attributes of the new widget can be dynamically determined, without needing to be known in advance.
+! Content and Attributes
+The content of the <<.wlink GenesisWidget>> widget is used as the content of the dynamically created widget.
+|!Attribute |!Description |
+|$type |The type of widget or element to create (an initial `$` indicates a widget, otherwise an HTML element will be created) |
+|$names |An optional filter evaluating to the names of a list of attributes to be applied to the widget |
+|$values |An optional filter evaluating to the values corresponding to the list of names specified in `$names` |
+|//{other attributes starting with $}// |Other attributes starting with a single dollar sign are reserved for future use |
+|//{attributes starting with $$}// |Attributes starting with two dollar signs are appplied as attributes to the output widget, but with the attribute name changed to use a single dollar sign |
+|//{attributes not starting with $}// |Any other attributes that do not start with a dollar are applied as attributes to the output widget |
+Note that attributes explicitly specified take precedence over attributes with the same name specified in the `$names` filter.
+! Examples
+<$macrocall $name='wikitext-example-without-html'
+src='<$genesis $type="div" class="tc-thing" label="Squeak">Mouse</$genesis>'/>
+<$macrocall $name='wikitext-example-without-html'
+src="""\define my-banner(mode:"inline",caption)
+<$genesis $type={{{ [<__mode__>match[inline]then[span]else[div]] }}} class="tc-mybanner">
+<<__caption__>>
+</$genesis>
+\end
+<<my-banner caption:"I'm in a SPAN">>
+<<my-banner mode:"block" caption:"I'm in a DIV">>
+"""/>

package/editions/tw5.com/tiddlers/widgets/LetWidget.tid CHANGED Viewed

@@ -1,5 +1,6 @@
 title: LetWidget
 created: 20211028115900000
+modified: 20221001094658854
 tags: Widgets
 caption: let
@@ -12,10 +13,12 @@ caption: let
 The content of the <<.wid let>> 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}// |Each attribute name specifies a variable name. The attribute value is assigned to the variable |
 Attributes are evaluated in the order they are written. Attributes with the same name are allowed. Each time a duplicate attribute is encountered, it will replace the existing value set by the earlier duplicate.
+<<.note """<<.from-version "5.2.4">> There is no longer any restriction on using variable names that start with the $ character.""">>
 ! Examples
 Consider a case where you need to set multiple variables, where some depend on the evaluation of others.

package/editions/tw5.com/tiddlers/widgets/ScrollableWidget.tid CHANGED Viewed

@@ -36,7 +36,7 @@ This example requires the following CSS definitions from [[$:/_tw5.com-styles]]:
 This wiki text shows how to display a list within the scrollable widget:
 <<wikitext-example-without-html "<$scrollable class='tc-scrollable-demo'>
-<$list filter='[!is[system]]'>
+<$list filter='[tag[Reference]]'>
 <$view field='title'/>: <$list filter='[all[current]links[]sort[title]]' storyview='pop'>
 <$link><$view field='title'/></$link>

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

@@ -40,6 +40,7 @@ The content of the `<$select>` widget should be one or more HTML `<option>` or `
 |multiple |If present, switches to multiple selection mode |
 |size |The number of rows to display in multiple selection mode |
 |actions |A string containing ActionWidgets to be triggered when the key combination is detected |
+|focus |<<.from-version "5.2.4">> Optional. Set to "yes" to automatically focus the HTML select element after creation |
 ! Examples

package/editions/tw5.com/tiddlers/wikitext/Macro Definitions in WikiText.tid CHANGED Viewed

@@ -1,13 +1,15 @@
 caption: Macro Definitions
 created: 20150220181617000
-modified: 20180820165115455
+modified: 20221207094236472
 tags: WikiText
 title: Macro Definitions in WikiText
 type: text/vnd.tiddlywiki
 A [[macro|Macros]] is defined using a `\define` [[pragma|Pragma]]. Like any pragma, this can only appear at the start of a tiddler.
-The first line of the definition specifies the macro name and any parameters. Each parameter has a name and, optionally, a default value that is used if no value is supplied on a particular call to the macro. The lines that follow contain the text of the macro text (i.e. the snippet represented by the macro name), until `\end` appears on a line by itself:
+The first line of the definition specifies the macro name and any parameters. Each parameter has a name and, optionally, a default value that is used if no value is supplied on a particular call to the macro.
+The lines that follow contain the text of the macro text (i.e. the snippet represented by the macro name), until `\end` appears on a line by itself:
 <$codeblock code={{$:/editions/tw5.com/macro-examples/say-hi}}/>
@@ -17,8 +19,6 @@ Alternatively, the entire definition can be presented on a single line without a
 \define sayhi(name:"Bugs Bunny") Hi, I'm $name$.
 ```
-A more formal [[presentation|Macro Definition Syntax]] of this syntax is also available.
 !! Accessing variables and parameters
 Inside the macro there are several methods for accessing variables defined outside of the macro or parameters from the macro parameter list.
@@ -77,3 +77,26 @@ To make a macro available to all tiddlers, define it in a tiddler that has the t
 It is also possible to write a macro as a [[JavaScript module|https://tiddlywiki.com/dev/index.html#JavaScript%20Macros]]. ~JavaScript macros are available to all tiddlers, and offer the maximum flexibility.
 A tiddler can manually import macro definitions from a [[selection|Title Selection]] of other tiddlers by using the <<.wlink ImportVariablesWidget>> widget.
+!! Nested Macro Definitions
+Macro definitions can be nested to any number of required levels by specifying the name of the macro in the `\end` marker. Nested macro definitions must appear at the start of the definition that contains them. For example:
+<<wikitext-example-without-html src:"""\define special-button(caption:"Click me")
+\define actions()
+<$action-sendmessage $message="tm-notify" $param="HelloThere"/>
+\end actions
+<$button actions=<<actions>>>
+$caption$
+</$button>
+\end special-button
+<<special-button>>
+""">>
+Note that the textual substitution of macro parameters that occurs when the outer macro is rendered will apply to the nested definitions as well. That generally means that textual substitution of macro parameters should not be used within nested macros.
+Parameters of nested macros can also be accessed via the `<<__variablename__>>` syntax. As ordinary variables, these parameters are available within nested child macros (and grandchildren etc).
+A more formal [[presentation|Macro Definition Syntax]] of this syntax is also available.

package/editions/tw5.com/tiddlers/wikitext/Styles and Classes in WikiText.tid CHANGED Viewed

@@ -1,6 +1,6 @@
 created: 20131205160532119
 modified: 20131205160549129
-tags: WikiText
+tags: WikiText [[How to apply custom styles]]
 title: Styles and Classes in WikiText
 type: text/vnd.tiddlywiki
 caption: Styles and Classes

package/editions/tw5.com/tiddlers/wikitext/Table Classes Captions Headers and Footers.tid ADDED Viewed

@@ -0,0 +1,20 @@
+created: 20220819100636227
+modified: 20220819101309072
+tags: [[Tables in WikiText]]
+title: Table Classes, Captions, Headers and Footers
+type: text/vnd.tiddlywiki
+Table CSS classes, captions, headers and footers can be specified as special pseudo-rows. The following example:
+* `|myclass anotherClass|k` assigns the CSS classes "myclass" and "anotherClass" to the table
+* `|This is a caption |c` gives the table the caption "This is a caption"
+* `|Header|Header|h` adds a header row of cells with the text "Header"
+* `|Footer|Footer|f` adds a footer row of cells with the text "Footer"
+<<wikitext-example-without-html src:"""|myclass anotherClass|k
+|This is a caption |c
+|Cell1 |Cell2 |
+|Cell3 |Cell3 |
+|Header|Header|h
+|Footer|Footer|f
+""">>

package/editions/tw5.com/tiddlers/wikitext/Tables in WikiText.tid CHANGED Viewed

@@ -1,6 +1,6 @@
 caption: Tables
 created: 20130914132100000
-modified: 20220513115945053
+modified: 20220819103416274
 tags: WikiText
 title: Tables in WikiText
 type: text/vnd.tiddlywiki
@@ -66,17 +66,7 @@ To merge a table cell with the one above, use the special cell text `~`. To merg
 ! Table Classes, Captions, Headers and Footers
-Table CSS classes, captions, headers and footers can be specified as special pseudo-rows. The following example:
+{{Table Classes, Captions, Headers and Footers}}
-* assigns the CSS classes "myclass" and "anotherClass" to the table
-* gives the table the caption "This is a caption"
-* adds a header row of cells with the text "Header"
-* adds a footer row of cells with the text "Footer"
-<<wikitext-example-without-html src:"""|myclass anotherClass|k
-|This is a caption |c
-|Cell1 |Cell2 |
-|Cell3 |Cell3 |
-|Header|Header|h
-|Footer|Footer|f
-""">>
+More examples can be found at: [[Tables in WikiText CSS Utility Classes]]

package/editions/tw5.com/tiddlers/wikitext/Utility Classes.tid ADDED Viewed

@@ -0,0 +1,20 @@
+created: 20220818093624828
+modified: 20221010074235929
+tags: WikiText
+title: Utility Classes
+type: text/vnd.tiddlywiki
+<<.from-version "5.2.4">> The following outlines a few predefined CSS classes intended to make it simpler to style [[HTML block-elements|HTML Block Elements]] and [[wikitext tables|Tables in WikiText CSS Utility Classes]].
+!! General Utility Classes
+|`tc-center` |Centres a block-element to the middle of the container |
+|`tc-max-width `|Expands a block-element to use the maximum width of the container |
+|`tc-max-width-80`|Sets the width of a block-element to use 80% of the maximum container width. This setting is useful with the `tc-center` class |
+|`tc-edit-max-width `|Expands [[TextWidget]]s to use the maximum available width. See [[ControlPanel -> Info -> Basics|$:/core/ui/ControlPanel/Basics]]|
+|`tc-first-link-nowrap` |Ensures that any links in the first table column will never wrap to the next line |
+!! Table Utility Classes
+|`tc-table-no-border` |Removes the borders of a table |
+|`tc-first-col-min-width` |The first column of a table will take up minimal possible width. It adapts to the content |

package/editions/tw5.com/tiddlers/wikitext/parser/WikiText Parser Modes.tid CHANGED Viewed

@@ -10,7 +10,7 @@ In order to display Tiddlers (usually the text field), the WikiText parser reads
 * ''block mode'' - the parser will recognise only [[block mode WikiText|Block Mode WikiText]] punctuation
 * ''inline mode'' - the parser will recognise only [[inline mode WikiText|Inline Mode WikiText]]
-The parser [[transitions between these modes|WikiText parser mode transitions]] based on the text it encounters. In addition, there are  [[places where the parser ignores WikiText|Places where the parser ignores WikiText]] punctuation.
+The parser [[transitions between these modes|WikiText parser mode transitions]] based on the text it encounters. In addition, there are  [[places where the parser ignores WikiText|Places where the parser ignores WikiText]] punctuation. The parser mode can also be set directly with the [[Pragma: \parsermode]].
 <<.tip "The concept of inline vs block also exists for standard HTML elements. For HTML, these [[two layout modes|https://www.w3schools.com/html/html_blocks.asp]] determine if the output flows together on the same line or not.
 <p>Most [[block mode WikiText|Block Mode WikiText]] corresponds to [[block level HTML elements|https://developer.mozilla.org/en-US/docs/Web/HTML/Block-level_elements]] and most [[inline mode WikiText|Inline Mode WikiText]] corresponds to [[inline level HTML elements|https://developer.mozilla.org/en-US/docs/Web/HTML/Inline_elements]]. However, for Wikitext the two modes are just as important for determining which syntax will be recognised by the parser as they are for determining how the output will flow.</p>">>

package/editions/twitter-archivist/tiddlers/DefaultTiddlers.tid ADDED Viewed

@@ -0,0 +1,4 @@
+title: $:/DefaultTiddlers
+[[Twitter Archives]]
+HelloThere

package/editions/twitter-archivist/tiddlers/HelloThere.tid ADDED Viewed

@@ -0,0 +1,9 @@
+title: HelloThere
+!!! Welcome to the Twitter Archivist for TiddlyWiki
+<$tiddler tiddler="$:/plugins/tiddlywiki/twitter-archivist">
+	<$set name="tabsList" filter="[list<currentTiddler>]">
+		<$macrocall $name="tabs" state=<<qualify "$:/state/tabs/twitter-archivist">> tabsList=<<tabsList>> default={{{ [enlist<tabsList>] }}} template="$:/core/ui/PluginInfo"/>
+	</$set>
+</$tiddler>

package/editions/twitter-archivist/tiddlers/SiteSubtitle.tid ADDED Viewed

@@ -0,0 +1,3 @@
+title: $:/SiteTitle
+Get Your Tweets Into ~TiddlyWiki

package/editions/twitter-archivist/tiddlers/SiteTitle.tid ADDED Viewed

@@ -0,0 +1,3 @@
+title: $:/SiteTitle
+Twitter Archivist

package/editions/twitter-archivist/tiddlywiki.info ADDED Viewed

@@ -0,0 +1,16 @@
+{
+	"description": "Twitter Archivist Edition",
+	"plugins": [
+		"tiddlywiki/twitter-archivist"
+	],
+	"languages": [
+	],
+	"themes": [
+		"tiddlywiki/vanilla",
+		"tiddlywiki/snowwhite"
+	],
+	"build": {
+		"index": [
+			"--rendertiddler","$:/core/save/all","index.html","text/plain"]
+	}
+}

package/languages/ar-PS/ControlPanel.multids CHANGED Viewed

@@ -8,7 +8,7 @@ Appearance/Hint: طرق لتخصيص مظهر وكي خاص بك.
 Basics/AnimDuration/Prompt: مدة الرسوم المتحركة
 Basics/AutoFocus/Prompt: موقع مؤشر الماوس الإفتراضي للتدلرز الجددة
 Basics/Caption: أساسيات
-Basics/DefaultTiddlers/BottomHint: إستخدم &#91;&#91;أقواس مربعة مزدوجة&#93;&#93; للعناوين مع مسافات. أو بإمكانك إختيار<$button set="$:/DefaultTiddlers" setTo="[list[$:/StoryList]]">الإحتفاظ بترتيب القصة</$button>
+Basics/DefaultTiddlers/BottomHint: إستخدم &#91;&#91;أقواس مربعة مزدوجة&#93;&#93; للعناوين مع مسافات. أو بإمكانك إختيار{{الإحتفاظ بترتيب القصة||$:/snippets/retain-story-ordering-button}}
 Basics/DefaultTiddlers/Prompt: تدلرز مفترضة
 Basics/DefaultTiddlers/TopHint: أي تدلرز ستظهر عند التشغيل
 Basics/Language/Prompt: مرحبا! اللغة الحالية:

package/languages/ca-ES/ControlPanel.multids CHANGED Viewed

@@ -7,7 +7,7 @@ Appearance/Hint: Formes de personalitzar l'aparença del vostre TiddlyWiki.
 Basics/AnimDuration/Prompt: Duració de l'animació:
 Basics/AutoFocus/Prompt: Focus dels nous tiddlers
 Basics/Caption: Bàsic
-Basics/DefaultTiddlers/BottomHint: Useu &#91;&#91;claudàtors dobles&#93;&#93; per als títols amb espais. O trieu <$button set="$:/DefaultTiddlers" setTo="[list[$:/StoryList]]">restaura la sessió anterior en arrencar</$button>
+Basics/DefaultTiddlers/BottomHint: Useu &#91;&#91;claudàtors dobles&#93;&#93; per als títols amb espais. O trieu {{restaura la sessió anterior en arrencar||$:/snippets/retain-story-ordering-button}}
 Basics/DefaultTiddlers/Prompt: Tiddlers per omissió:
 Basics/DefaultTiddlers/TopHint: Trieu quins tiddlers s'han de mostrar a l'inici:
 Basics/Language/Prompt: Bon dia! Trieu l'idioma:

package/languages/cs-CZ/ControlPanel.multids CHANGED Viewed

@@ -6,7 +6,7 @@ Appearance/Caption: Vzhled
 Appearance/Hint: Možnosti přizpůsobení vzhledu vaší TiddlyWiki.
 Basics/AnimDuration/Prompt: Délka animace:
 Basics/Caption: Základní
-Basics/DefaultTiddlers/BottomHint: Použijte &#91;&#91;dvojité hranaté závorky&#93;&#93; pro názvy s mezerami. Nebo můžete zvolit <$button set="$:/DefaultTiddlers" setTo="[list[$:/StoryList]]">zachování toku</$button>
+Basics/DefaultTiddlers/BottomHint: Použijte &#91;&#91;dvojité hranaté závorky&#93;&#93; pro názvy s mezerami. Nebo můžete zvolit {{zachování toku||$:/snippets/retain-story-ordering-button}}
 Basics/DefaultTiddlers/Prompt: Výchozí tiddlery:
 Basics/DefaultTiddlers/TopHint: Vyberte které tiddlery budou zobrazeny po spuštění:
 Basics/Language/Prompt: Ahoj! Aktuální jazyk: