tiddlywiki 5.2.2 → 5.2.4

package/editions/tw5.com/tiddlers/hiddensettings/Hidden Setting Sync System Tiddlers From Server.tid

@@ -0,0 +1,13 @@
+created: 20220909094340097
+modified: 20220909094340097
+title: Hidden Setting: Sync System Tiddlers From Server
+tags: [[Hidden Settings]]
+
+<<.from-version "5.1.23">> Determines whether system tiddlers are synced from the server under Node.js. (Note that this is a one-way setting; system tiddlers are always synced //to// the server).
+
+* `no` -- system tiddlers are not synced from the server (default)
+* `yes` -- system tiddlers are synced from the server
+
+Engaging sync of system tiddlers means that tiddlers such as $:/StoryList and $:/HistoryList get synced, which can lead to unexpected outcomes when multiple users are connected to the same server at the same time (it means that the story sequence is synced between all the users).
+
+$:/config/SyncSystemTiddlersFromServer

package/editions/tw5.com/tiddlers/hiddensettings/Hidden Setting SyncLogging.tid

@@ -0,0 +1,13 @@
+created: 20190903192324700
+modified: 20190903192324700
+tags: [[Hidden Settings]]
+title: Hidden Setting: Sync Logging
+type: text/vnd.tiddlywiki
+
+Specifies whether [[Syncadaptor|https://tiddlywiki.com/dev/#Syncadaptor]] should log information to the browser's developer console or not.
+
+Defaults to `yes`. Set to `no` to disable logging.
+
+Changing needs restart to take effect.
+
+$:/config/SyncLogging

package/editions/tw5.com/tiddlers/hiddensettings/Hidden Setting_ More Tabs Horizontal.tid

@@ -0,0 +1,7 @@
+created: 20221128092648000
+modified: 20221128092903706
+tags: [[Hidden Settings]]
+title: Hidden Setting: More Tabs Horizontal
+type: text/vnd.tiddlywiki
+
+Set the $:/config/ui/SideBar/More/horizontal tiddler to ''yes'', to align the ''More -> Tabs'' in horizontal orientation.

package/editions/tw5.com/tiddlers/howtos/Constructing JSON tiddlers.tid

@@ -0,0 +1,16 @@
+title: Constructing JSON tiddlers
+tags: [[JSON in TiddlyWiki]] [[Learning]]
+created: 20220427174702859
+modified: 20220427174702859
+
+See [[JSON in TiddlyWiki]] for an overview of using JSON in TiddlyWiki.
+
+JSON data is just plain text, and so there are an wide variety of techniques to generate it in wikitext.
+
+At a high level, we have several ways to generate JSON data in TiddlyWiki's own tiddler format:
+
+* JSONTiddlerWidget
+* [[jsontiddler Macro]]
+* [[jsontiddlers Macro]]
+
+When constructing JSON data manually, the [[jsonstringify Operator]] is needed to ensure that any special characters are properly escaped.

package/editions/tw5.com/tiddlers/howtos/Creating a splash screen.tid

@@ -8,7 +8,7 @@ By default, TiddlyWiki displays a blank screen while it is loading. You can add
 
 Larger TiddlyWiki files and those loaded over a slow network connection may take a little time to load. Once fully loaded, performance improves, because everything is now running entirely within the browser. Using a splash screen ensures people know the loading process is taking place, reducing the chance they will leave the page.
 
-In order for the splash screen to be displayed before TiddlyWiki is initialised it is embedded as static HTML/CSS within the TiddlyWiki HTML file. This is done with the [[SystemTag: $:/tags/RawMarkupWikified/TopBody]].
+In order for the splash screen to be displayed before TiddlyWiki is initialised or [[decrypted|Encryption]], it is embedded as static HTML/CSS within the TiddlyWiki HTML file. This is done with the [[SystemTag: $:/tags/RawMarkupWikified/TopBody]], or any of the other system tags beginning with $:/tags/RawMarkup. 
 
 In order to remove the splash screen when the wiki has finished loading, the HTML should be wrapped in a container with the special class `tc-remove-when-wiki-loaded`. Any DOM elements with this class are automatically deleted by the core once the wiki has loaded.
 

package/editions/tw5.com/tiddlers/howtos/How to apply custom styles by tag.tid

@@ -1,11 +1,11 @@
 caption: {{!!title}} - ^^deprecated^^
 created: 20141001132300000
-modified: 201804111739
+modified: 20220704174221300
 tags: [[How to apply custom styles]] $:/deprecated
 title: How to apply custom styles by tag
 type: text/vnd.tiddlywiki
 
-<<.deprecated-since "5.1.16 <- click" "Custom styles by data-tags">>. Also see: [[How to apply custom styles]]
+<<.deprecated-since "5.1.16" "Custom styles by data-tags">>. Also see: [[How to apply custom styles]]
 
 ----
 

package/editions/tw5.com/tiddlers/howtos/How to create keyboard shortcuts.tid

@@ -66,6 +66,8 @@ In the [[Keyboard Shortcuts Tab|$:/core/ui/ControlPanel/KeyboardShortcuts]] the
 
 !! Using global Keyboard Shortcuts
 
+> See [[Keyboard Shortcut Tiddler]] for detailed information about creating new global keyboard shortcuts.
+
 > The actions for ''global'' keyboard shortcuts are stored in the ''text'' field of tiddlers tagged with <<tag $:/tags/KeyboardShortcut>>
 
 > The ''key field'' connects an action-tiddler with the corresponding shortcut through the `((my-shortcut))` syntax, called [[Keyboard Shortcut Descriptor]]

package/editions/tw5.com/tiddlers/howtos/How to customize TiddlyDesktop.tid

@@ -8,7 +8,7 @@ type: text/vnd.tiddlywiki
 
 Before experimenting with TiddlyDesktop internals you should find the location of the “user configuration folder” - click the “Settings” button on the main TiddlyDesktop window, and then click the button “Open user config folder”. Then move up to locate the parent folder, which should be called “TiddlyDesktop”. If things go wrong, you can reset TiddlyDesktop to its factory state by deleting this entire folder.
 
-Click the `Backstage` button on the main TiddlyDesktop window to open the backstage wiki. This is is a Node.js-like instance of TiddlyWiki that runs the UI and logic of TiddlyDesktop.
+Click the `Backstage` button on the main TiddlyDesktop window to open the backstage wiki. This is a Node.js-like instance of TiddlyWiki that runs the UI and logic of TiddlyDesktop.
 
 !! How do I get rid of the "Add a ~TiddlyWiki Folder" button.
 

package/editions/tw5.com/tiddlers/howtos/How to update TiddlyWiki to the latest version.tid

@@ -0,0 +1,7 @@
+created: 20220426221124514
+modified: 20220426221240671
+tags: [[Working with TiddlyWiki]]
+title: How to update TiddlyWiki to the latest version
+type: text/vnd.tiddlywiki
+
+{{Upgrading}}

package/editions/tw5.com/tiddlers/howtos/Modifying JSON tiddlers.tid

@@ -0,0 +1,18 @@
+created: 20220427174702859
+modified: 20220427171707459
+tags: [[JSON in TiddlyWiki]] Learning
+title: Modifying JSON tiddlers
+type: text/vnd.tiddlywiki
+
+See [[JSON in TiddlyWiki]] for an overview of using JSON in TiddlyWiki.
+
+Note that 
+
+!! Using ActionSetFieldWidget and ActionListopsWidget
+
+The widgets ActionSetFieldWidget and ActionListopsWidget can manipulate named properties of data tiddlers by indicating the name of the property in the $index attribute.
+
+* To create or modify a named property with ActionSetFieldWidget, provide a $value attribute
+* To delete a named property with ActionSetFieldWidget, omit the $value attribute.
+
+ActionListopsWidget assigns the named property the list constructed through its $filter and $subfilter attributes.

package/editions/tw5.com/tiddlers/howtos/Reading data from JSON tiddlers.tid

@@ -0,0 +1,34 @@
+created: 20220427174702859
+modified: 20220611104737314
+tags: [[JSON in TiddlyWiki]] Learning
+title: Reading data from JSON tiddlers
+type: text/vnd.tiddlywiki
+
+See [[JSON in TiddlyWiki]] for an overview of using JSON in TiddlyWiki.
+
+!! Filter Operators for Accessing JSON Data
+
+The following filter operators allow values to be read from JSON data:
+
+* <<.olink jsonget>> to retrieve the values of a property in JSON data
+* <<.olink jsontype>> to retrieve the type of a JSON value
+* <<.olink jsonindexes>> to retrieve the names of the fields of a JSON object, or the indexes of a JSON array
+* <<.olink jsonextract>> to retrieve a JSON value as a string of JSON
+
+!! Text References for Accessing JSON Data
+
+[[Text references|TextReference]] are a simple shortcut syntax to look up the value of a named property. For example, if a [[DictionaryTiddler|DictionaryTiddlers]] called `MonthDays` contains:
+
+```
+oct:31
+nov:30
+dec:31
+```
+
+... then `{{MonthDays##nov}}` will resolve to the value `30`.
+
+The same is true if `MonthDays` is a [[JSONTiddler|JSONTiddlers]] with the following content:
+
+```
+{"oct":31,"nov":30,"dec":31}
+```

package/editions/tw5.com/tiddlers/images/Federatial.png.meta

@@ -0,0 +1,3 @@
+title: Federatial.png
+type: image/png
+tags: picture

package/editions/tw5.com/tiddlers/images/{TiddlyMap.png.meta → Funding.png.meta}

@@ -1,3 +1,3 @@
-title: TiddlyMap.png
+title: Funding.png
 type: image/png
 tags: picture

package/editions/tw5.com/tiddlers/images/Marketplace Banner.png.meta

@@ -0,0 +1,3 @@
+title: TiddlyWiki Marketplace Banner
+type: image/jpeg
+tags: picture

package/editions/tw5.com/tiddlers/macros/JsonTiddlersMacro.tid

@@ -1,11 +1,11 @@
+caption: jsontiddlers
 created: 20150221152226000
-modified: 20200204135513721
+modified: 20220427171155184
 tags: Macros [[Core Macros]]
 title: jsontiddlers Macro
 type: text/vnd.tiddlywiki
-caption: jsontiddlers
 
-The <<.def jsontiddlers>> [[macro|Macros]] returns the fields of a [[selection of tiddlers|Title Selection]] in [[JSON|JavaScript Object Notation]] form.
+The <<.def jsontiddlers>> [[macro|Macros]] returns the fields of a [[selection of tiddlers|Title Selection]] in [[JSON|JavaScript Object Notation]] form. See [[JSON in TiddlyWiki]] for an overview.
 
 An example can be seen in the [[template tiddler for JSON exports|$:/core/templates/exporters/JsonFile]].
 

package/editions/tw5.com/tiddlers/macros/ListMacro.tid

@@ -1,6 +1,6 @@
 caption: list-links
 created: 20140917083515996
-modified: 20190206000000000
+modified: 20221105090835041
 tags: Macros [[Core Macros]]
 title: list-links Macro
 type: text/vnd.tiddlywiki
@@ -15,6 +15,8 @@ Note: Each first [[step|Filter Step]] of a [[filter run|Filter Run]] not given a
 
 ;filter
 : A [[filter|Filters]] selecting which tiddlers to include
+;caption
+: The name of the field to transclude for each list item, defaultingt to `caption`
 ;type
 : An HTML element to use for the overall list element, defaulting to `ul`
 ;subtype

package/editions/tw5.com/tiddlers/macros/TableOfContentsMacro.tid

@@ -1,5 +1,5 @@
 created: 20140919155729620
-modified: 20201017134038305
+modified: 20220819093733569
 tags: Macros [[Core Macros]]
 title: Table-of-Contents Macros
 type: text/vnd.tiddlywiki
@@ -62,4 +62,38 @@ These two parameters are combined into a single [[filter expression|Filter Expre
 ;template
 : Optionally, the title of a tiddler to use as a [[template|TemplateTiddlers]] for transcluding the selected tiddler into the right-hand panel
 
-[[Examples|Table-of-Contents Macros (Examples)]]
+!! Custom Icons
+
+<<.from-version "5.2.4">>
+
+To change the icons used by the Table-of-Contents macros, redefine the macros `toc-open-icon` and `toc-closed-icon`. This setting works for all toc-macro variants.
+
+!!! Default Settings
+
+* <<.var toc-open-icon>>: `\define toc-open-icon() $:/core/images/down-arrow`  
+
+* <<.var toc-closed-icon>>: `\define toc-closed-icon() $:/core/images/right-arrow` 
+
+!!! Custom Definitions
+
+The default settings can be overwritten in your code using the define-pragma or the let-widget. The <<.wlink LetWidget>> widget can be used, if you have multiple table of contents macros in one tiddler, that need different icons. 
+
+''Define new icons using a pragma''
+
+```
+\define toc-open-icon() $:/core/images/fold-button
+\define toc-closed-icon() $:/core/images/folder
+...
+```
+
+''Define new icons using the let-widget''
+
+```
+<$let toc-open-icon="$:/core/images/fold-button" toc-closed-icon="$:/core/images/folder">
+...
+</$let>
+```
+
+!! Examples
+
+Learn more at [[Examples|Table-of-Contents Macros (Examples)]]

package/editions/tw5.com/tiddlers/macros/TagMacro.tid

@@ -5,7 +5,7 @@ tags: Macros [[Core Macros]]
 title: tag Macro
 type: text/vnd.tiddlywiki
 
-The <<.def tag>> [[macro|Macros]] generates a tag pill for a specified tag.
+The <<.def tag>> [[macro|Macros]] generates a tag pill for a specified tag. Clicking the tag pill opens a dropdown. This can be compared to the [[tag-pill Macro]] which also features other parameters.
 
 !! Parameters
 

package/editions/tw5.com/tiddlers/macros/jsontiddler Macro.tid

@@ -1,11 +1,11 @@
 caption: jsontiddler
 created: 20170317140130417
-modified: 20170317140226040
+modified: 20220427171228844
 tags: Macros [[Core Macros]]
 title: jsontiddler Macro
 type: text/vnd.tiddlywiki
 
-The <<.def jsontiddler>> [[macro|Macros]] returns the fields of a single tiddler in [[JSON|JavaScript Object Notation]] form.
+The <<.def jsontiddler>> [[macro|Macros]] returns the fields of a single tiddler in [[JSON|JavaScript Object Notation]] form. See [[JSON in TiddlyWiki]] for an overview.
 
 !! Parameters
 

package/editions/tw5.com/tiddlers/macros/list-links-draggable Macro.tid

@@ -13,6 +13,8 @@ The <<.def list-links-draggable>> [[macro|Macros]] renders the ListField of a ti
 : The title of the tiddler containing the list
 ;field
 : The name of the field containing the list (defaults to `list`)
+;emptyMessage
+: Optional wikitext to display if there is no output (tiddler is not existed, field is not existed or empty)
 ;type
 : The element tag to use for the list wrapper (defaults to `ul`)
 ;subtype

package/editions/tw5.com/tiddlers/marketplace/TiddlyWiki Marketplace.tid

@@ -0,0 +1,18 @@
+title: TiddlyWiki Marketplace
+tags: Community
+modified: 20221204165636777
+created: 20221204165636777
+
+<span style="float:right;">[img width=200px [TiddlyWiki Marketplace Banner]]</span>
+
+Welcome to the TiddlyWiki Marketplace. This new forum is designed to provide a space for individuals and organizations to offer commercial products and services that are built around TiddlyWiki:
+
+* Paid hosting services
+* Custom solution development
+* Training courses
+* One-to-one training sessions
+* "Fix my wiki" debugging sessions
+
+<a href="https://talk.tiddlywiki.org/c/marketplace/22" class="tc-btn-big-green" style="border-radius:4px;background-color:#ff5c48;" target="_blank" rel="noopener noreferrer">
+~TiddlyWiki Marketplace
+</a>

package/editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid

@@ -15,6 +15,7 @@ System tiddlers in the namespace `$:/info/` are used to expose information about
 |!Title |!Description |
 |[[$:/info/startup-timestamp]] |<<.from-version "5.1.23">> Startup timestamp in TiddlyWiki date format |
 |[[$:/info/browser]] |Running in the browser? ("yes" or "no") |
+|[[$:/info/mobile]] |<<.from-version "5.2.3">> Is running on a mobile device? ("yes" or "no" - eg, ''<<example full>>'') |
 |[[$:/info/browser/language]] |<<.from-version "5.1.20">> Language as reported by browser (note that some browsers report two character codes such as `en` while others report full codes such as `en-GB`) |
 |[[$:/info/browser/screen/width]] |Screen width in pixels |
 |[[$:/info/browser/screen/height]] |Screen height in pixels |

package/editions/tw5.com/tiddlers/mechanisms/PluginMechanism.tid

@@ -1,5 +1,5 @@
 created: 20130826122000000
-modified: 20190928082000464
+modified: 20220613124446953
 tags: Mechanisms
 title: PluginMechanism
 type: text/vnd.tiddlywiki

package/editions/tw5.com/tiddlers/mechanisms/PopupMechanism.tid

@@ -8,6 +8,7 @@ The popup mechanism allows blocks of content to be selectively displayed and pos
 
 * [[StateTiddlers|StateMechanism]] to record whether a popup is currently displayed or not
 * The RevealWidget to selectively display the popup content
+** <<.from-version "5.2.4">> For positioning the popups relative or absolute coordinates can be used. See [[Coordinate Systems]] for more information about usage and format.
 ** For "sticky" popups — those that don't close when clicking inside one — set the ''class'' attribute to `tc-popup-keep`
 * The ButtonWidget to trigger the display of the popup by setting the state tiddler appropriately
 

package/editions/tw5.com/tiddlers/messages/WidgetMessage_ tm-close-window.tid

@@ -1,6 +1,6 @@
 caption: tm-open-window
 created: 20220228140417116
-modified: 20220301180905777
+modified: 20220409092811188
 tags: Messages
 title: WidgetMessage: tm-close-window
 type: text/vnd.tiddlywiki
@@ -15,6 +15,8 @@ The `tm-close-window` message is best generated with the ActionSendMessageWidget
 
 <<.tip """When used with the ActionSendMessageWidget, <<.param 'param'>> becomes <<.param '$param'>> """>>
 <<.tip """To close all additional browser windows that were opened with [[tm-open-window|WidgetMessage: tm-open-window]] use [[WidgetMessage: tm-close-all-windows]]""">>
+<<.tip """If the <<.param windowID>> parameter was used with [[tm-open-window|WidgetMessage: tm-open-window]] when opening a new window,  the value of <<.param windowID>> is available within that window in the variable <<.var tv-window-id>>""">>
+
 
 <$macrocall $name='wikitext-example-without-html'
 src="""

package/editions/tw5.com/tiddlers/messages/WidgetMessage_ tm-modal.tid

@@ -10,12 +10,14 @@ type: text/vnd.tiddlywiki
 |paramObject |Hashmap of variables to be provided to the modal, contains all extra parameters passed to the widget sending the message. |
 |rootwindow |<<.from-version 5.1.18>> ''yes'' or ''true'' will always display a modal in the wiki-root-window |
 
-The "currentTiddler" variable is set to the title of the modal tiddler, but can be overridden by specifying a different value in `paramObject`.
-
 The modal message is usually generated with the ButtonWidget. The modal message is handled by the TiddlyWiki core.
 
 [[Fields within the tiddler|Modals]] being displayed in the modal can be used to customize its appearance.
 
+!! paramObject
+
+The "currentTiddler" variable is set to the title of the modal tiddler, but can be overridden by specifying a different value in `paramObject`.
+
 ! Example
 
 Here is an example of displaying a modal and passing parameters to it:

package/editions/tw5.com/tiddlers/messages/WidgetMessage_ tm-new-tiddler.tid

@@ -1,6 +1,6 @@
 caption: tm-new-tiddler
 created: 20140226194405353
-modified: 20141107132122081
+modified: 20220521143507491
 tags: Messages navigator-message
 title: WidgetMessage: tm-new-tiddler
 type: text/vnd.tiddlywiki
@@ -22,13 +22,13 @@ The new tiddler message is usually generated with the ButtonWidget or ActionSend
 
 ! Examples
 
-To make a button that creates new tiddlers tagged "task", create a tiddler called "TaskTemplate" with that tag, and then make your button like this:
+To make a button that creates new tiddlers tagged "task", create a tiddler called "~TaskTemplate" with that tag, and then make your button like this:
 
 ```
 <$button message="tm-new-tiddler" param="TaskTemplate">New Task</$button>
 ```
 
-To create a new tiddler with given attributes rather than from a template:
+To create a new tiddler with explicit parameters rather than by cloning a template tiddler:
 
 ```
 <$button>
@@ -36,3 +36,12 @@ To create a new tiddler with given attributes rather than from a template:
 New Tiddler
 </$button>
 ```
+
+ To create a new tiddler from a template with additional parameters:
+
+```
+ <$button>
+ <$action-sendmessage $message="tm-new-tiddler" $param=<<currentTiddler>> fieldname="field value"/>
+ New Tiddler
+ </$button>
+ ```

package/editions/tw5.com/tiddlers/nodejs/Environment Variables on Node.js.tid

@@ -1,5 +1,5 @@
 created: 20140617211749290
-modified: 20211104172343220
+modified: 20220613114121229
 tags: [[TiddlyWiki on Node.js]]
 title: Environment Variables on Node.js
 type: text/vnd.tiddlywiki
@@ -11,15 +11,15 @@ type: text/vnd.tiddlywiki
 * `TIDDLYWIKI_LANGUAGE_PATH` - Search path for languages
 * `TIDDLYWIKI_EDITION_PATH` - Search path for editions (used by the InitCommand)
 
-''Note 1'': The delimiter may vary between operating systems. While on Windows a semicolon `;` is used, Linux implements a colon `:`.
 
-''Note 2'': On Linux systems, it may be necessary to //''export''// the variable as well as to define it.
+<$macrocall $name=".note" _="""''1.'' The delimiter may vary between operating systems. While on Windows a semicolon `;` is used, Linux implements a colon `:`.<br><br>''2.'' On Linux systems, it may be necessary to //''export''// the variable as well as to define it.
+"""/> 
 
-The additional paths should each point to folders structured like the equivalent directories in the TiddlyWiki5 GitHub repository: the plugin, theme and language directories contain `publisher/pluginname/<files>` while the edition directories contain `editionname/<files>`
+The additional paths should each point to folders structured like the equivalent directories in the ~TiddlyWiki5 GitHub repository: the plugin, theme and language directories contain `publisher/pluginname/<files>` while the edition directories contain `editionname/<files>`
 
 For example:
 
 ```
-TIDDLYWIKI_PLUGIN_PATH=~/MyPluginStore
+export TIDDLYWIKI_PLUGIN_PATH=~/MyPluginStore
 tiddlywiki mywiki --build index
 ```

package/editions/tw5.com/tiddlers/nodejs/Installing TiddlyWiki on Node.js.tid

@@ -4,7 +4,7 @@ created: 20131219100608529
 delivery: DIY
 description: Flexible hosting on your own machine or in the cloud
 method: sync
-modified: 20211003230831173
+modified: 20221115230831173
 tags: Saving [[TiddlyWiki on Node.js]] Windows Mac Linux
 title: Installing TiddlyWiki on Node.js
 type: text/vnd.tiddlywiki
@@ -12,7 +12,7 @@ type: text/vnd.tiddlywiki
 # Install [[Node.js]]
 #* Linux: 
 #*> //Debian/Ubuntu//:<br/>`apt install nodejs`<br/>May need to be followed up by:<br/>`apt install npm`
-#*> //Arch Linux//<br/>`pacman -S tiddlywiki` <br/>(installs node and tiddlywiki)
+#*> //Arch Linux//<br/>`yay -S tiddlywiki` <br/>(installs node and tiddlywiki)
 #* Mac
 #*> `brew install node`
 #* Android
@@ -23,9 +23,9 @@ type: text/vnd.tiddlywiki
 #> `npm install -g tiddlywiki`
 #> If it fails with an error you may need to re-run the command as an administrator:
 #> `sudo npm install -g tiddlywiki` (Mac/Linux)
-# Check TiddlyWiki is installed by typing:
+# Ensure ~TiddlyWiki is installed by typing:
 #> `tiddlywiki --version`
-# In response, you should see TiddlyWiki report its current version (eg "<<version>>"; you may also see other debugging information reported)
+#* In response, you should see TiddlyWiki report its current version (eg "<<version>>". You may also see other debugging information reported.)
 # Try it out:
 ## `tiddlywiki mynewwiki --init server` to create a folder for a new wiki that includes server-related components
 ## `tiddlywiki mynewwiki --listen` to start TiddlyWiki
@@ -37,11 +37,6 @@ type: text/vnd.tiddlywiki
 
 The `-g` flag causes TiddlyWiki to be installed globally. Without it, TiddlyWiki will only be available in the directory where you installed it.
 
-If you are using Debian or Debian-based Linux and you are receiving a `node: command not found` error though node.js package is installed, you may need to create a symbolic link between `nodejs` and `node`. Consult your distro's manual and `whereis` to correctly create a link. See github [[issue 1434|http://github.com/Jermolene/TiddlyWiki5/issues/1434]]
-
-Example Debian v8.0: `sudo ln -s /usr/bin/nodejs /usr/bin/node`
-
-You can also install prior versions like this:
-
-> npm install -g tiddlywiki@5.1.13
-
+<<.warning "If you are using Debian or Debian-based Linux and you are receiving a `node: command not found` error though node.js package is installed, you may need to create a symbolic link between `nodejs` and `node`. Consult your distro's manual and `whereis` to correctly create a link. See github [[issue 1434|http://github.com/Jermolene/TiddlyWiki5/issues/1434]]. <br><br>Example Debian v8.0: `sudo ln -s /usr/bin/nodejs /usr/bin/node`">>
+<br>
+<<.tip "You can also install prior versions like this: <br><code> npm install -g tiddlywiki@5.1.13</code>">>

package/editions/tw5.com/tiddlers/nodejs/Installing custom plugins on Node.js.tid

@@ -1,27 +1,19 @@
 created: 20191022095653896
-modified: 20191102131824766
-tags: [[TiddlyWiki on Node.js]]
+modified: 20220617130125173
+tags: [[TiddlyWiki on Node.js]] PluginsCS
 title: Installing custom plugins on Node.js
 type: text/vnd.tiddlywiki
 
-There are several ways in which custom plugins that are not part of TiddlyWiki's plugin library can be installed when using TiddlyWiki under Node.js. (See [[Installing a plugin from the plugin library]] for instructions on installing plugins from the library).
+\rules except wikilink
 
-* Arrange the PluginFolders containing the plugins in a convenient shared location and then use [[environment variables|Environment Variables on Node.js]] to tell TiddlyWiki to search those folders. The plugins can be referenced in `tiddlywiki.info` by their name (e.g. `tiddlytools/magic`)
-* Place the PluginFolders containing the plugins in a `plugins` folder within the [[wiki folder|TiddlyWikiFolders]]. TiddlyWiki will attempt to include every subfolder as a plugin. Do not add the plugin names to `tiddlywiki.info`. Do not add the PluginFolders under a specific namespace:<br><pre>.
-├── plugins
-│   ├── relink
-│   │   ├── js
-│   │   ├── plugin.info
-│   │   └── tiddlers
-│   └── relink-markdown
-│       ├── js
-│       ├── plugin.info
-│       └── readme.tid
-├── tiddlers
-└── tiddlywiki.info
-</pre>
-* Depending on how TiddlyWiki itself has been installed, plugins can also be installed by copying the plugin folders into the `plugins` folder of the repository. This is only recommended if working with a forked copy of the repo. It is not recommended if TiddlyWiki has been installed with npm because npm is liable to overwrite the installation when performing an update
+! Introduction
 
-Note that including a plugin as an ordinary tiddler (e.g. by dragging and dropping a plugin into the browser) will result in the plugin only being active in the browser, and not available under Node.js.
+There are several ways in which official plugins and custom plugins can be installed when using TiddlyWiki with a Node.js client-server configuration.
 
+<$macrocall $name=".note" _="""For instructions on installing plugins from libraries to ''single-file'' wikis learn more at [[Plugins]].
+"""/> 
+
+!! Plugin Load Order
+
+{{Plugin Ordering}}
 

package/editions/tw5.com/tiddlers/nodejs/Installing official plugins on Node.js.tid

@@ -0,0 +1,40 @@
+created: 20220611123344385
+modified: 20220617132351460
+tags: [[TiddlyWiki on Node.js]] PluginsCS
+title: Installing official plugins on Node.js
+type: text/vnd.tiddlywiki
+
+Follow these instructions when using TiddlyWiki with a client-server Node.js configuration:
+
+# Identify the plugins you want to install using the ''Plugins'' tab of <<controlPanel-plugin-link>> (''don't'' install the plugins from here, though)
+#* Plugins are identified by their type (ie language, theme or plugin) and their publisher and title. For example, the plugin `$:/plugins/tiddlywiki/internals` is referred to as ''tiddlywiki/internals''
+
+# Quit the server if it is running
+
+# Edit the `tiddlywiki.info` file (it is in JSON format) and locate the `plugins`, `themes` or `languages` section (see below)
+
+# Add entries corresponding to the plugins you wish to add
+#* Take care to retain ''commas ''to separate items
+#* Do ''not'' terminate the last item in a list with a comma
+
+# Restart the server
+
+```
+{
+	"plugins": [
+		"tiddlywiki/codemirror"
+	],
+	"themes": [
+		"tiddlywiki/vanilla",
+		"tiddlywiki/snowwhite"
+	],
+    "languages": [
+        "es-ES",
+        "fr-FR",
+        "en-EN"
+    ]
+}
+```
+
+<$macrocall $name=".note" _="An overview of working with plugins can be found at [[Plugins]].<br>Also see: [[Installing custom plugins on Node.js]]."/>
+

package/editions/tw5.com/tiddlers/nodejs/PluginsCS.tid

@@ -0,0 +1,9 @@
+created: 20220612082924589
+list: [[Installing custom plugins on Node.js]] [[Installing official plugins on Node.js]] [[Uninstalling a plugin with Node.js]]
+modified: 20220617124533352
+title: PluginsCS
+type: text/vnd.tiddlywiki
+
+This tiddler is used as a tag in the [[Plugins]] tiddler to create a sorted list
+
+<<list-links-draggable>>

package/editions/tw5.com/tiddlers/nodejs/TiddlyWiki on Node.js.tid

@@ -1,15 +1,20 @@
 created: 20131129094353704
-modified: 20200318115527226
+modified: 20220617114433107
 tags: Platforms
 title: TiddlyWiki on Node.js
 type: text/vnd.tiddlywiki
 
+\rules except wikilink
+
 Running TiddlyWiki on [[Node.js]] brings several important benefits over and above the single file version:
 
-* You can edit your content on any suitably compatible HTML5 browser, including smartphones and tablets
 * Individual tiddlers are stored in separate files, which you can organise as you wish
+
 * The ability to build multiple wikis that blend different combinations of shared and unique content
 
+* You can edit your content on any modern browser, including smartphones and tablets
+
+
 <<.warning """Note that TiddlyWiki on Node.js doesn't currently support directly modifying the tiddler files via the file system while it is running. The server must be restarted in order to for changes to take effect. The recommended way to interact with a running wiki is via the HTTP or JavaScript APIs.""">>
 
 For more information see: