tiddlywiki 5.1.23 → 5.2.2

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

@@ -1,5 +1,5 @@
 created: 20150117152607000
-modified: 201804111739
+modified: 20211230150413997
 tags: $:/tags/Macro
 title: $:/editions/tw5.com/doc-macros
 type: text/vnd.tiddlywiki
@@ -113,6 +113,20 @@ This is an example tiddler. See [[Table-of-Contents Macros (Examples)]].
 </$list>
 \end
 
+\define .bad-example(eg)
+<table class="doc-bad-example">
+<tbody>
+<tr class="evenRow">
+<td><span class="tc-inline-style" style="font-size:1.5em;">&#9888;</span> Warning:<br> Don't do it this way!</td>
+<td>
+
+$eg$
+</td>
+</tr>
+</tbody>
+</table>
+\end
+
 \define .link-badge(text,link,colour)
 <a href=<<__link__>> class="doc-link-badge" style="background-color:$colour$;" target="_blank" rel="noopener noreferrer"><$text text=<<__text__>>/></a>
 \end
@@ -130,4 +144,31 @@ This is an example tiddler. See [[Table-of-Contents Macros (Examples)]].
 \define .link-badge-renamed(link,colour:#b4b995) <<.link-badge "renamed" """$link$""" """$colour$""">>
 \define .link-badge-updated(link,colour:#91ba66) <<.link-badge "updated" """$link$""" """$colour$""">>
 
+\define .tiddler-fields(tiddler)
+<$tiddler tiddler=<<__tiddler__>>>
+<div class="doc-tiddler-fields">
+<h2>
+<$link>
+<span class="tc-tiddler-title-icon">{{||$:/core/ui/TiddlerIcon}}</span><$text text=<<currentTiddler>>/>
+</$link>
+</h2>
+<table class="tc-view-field-table">
+<tbody>
+<$list filter="[all[current]fields[]sort[title]] -title" template="$:/core/ui/TiddlerFieldTemplate" variable="listItem"/>
+</tbody>
+</table>
+</div>
+</$tiddler>
+\end
+
+\define .banner-credits(credit,url)
+<img src=<<__url__>> width="140" style="float:left;margin-right:0.5em;"/>
+
+$credit$
+
+<div style="clear:both;">
+
+</div>
+\end
+
 <pre><$view field="text"/></pre>

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

@@ -1,5 +1,5 @@
 created: 20150117152612000
-modified: 201804111739
+modified: 20211230150725145
 tags: $:/tags/Stylesheet
 title: $:/editions/tw5.com/doc-styles
 type: text/vnd.tiddlywiki
@@ -110,6 +110,10 @@ td svg {
 	padding-bottom: 0;
 	margin-top: 0.2em;
 }
+
+.doc-example input[type=search] { 
+  width: 95%;
+}
 .doc-example pre:first-child {
 	margin-top: 0;
 }
@@ -129,6 +133,10 @@ td svg {
 	padding-left: 20px;
 }
 
+.doc-bad-example code, .doc-bad-example pre, table.doc-bad-example {
+  background-color:#ffff80;
+}
+
 .doc-table th, .doc-table tr {
 	vertical-align: top;
 }
@@ -218,8 +226,29 @@ tr.doc-table-subheading {
     text-decoration: underline;
 }
 
-.doc-plain-list ul,
-.doc-plain-list ol {
-	list-style: none;
-	padding-left: 0;
+.doc-tiddler-fields {
+	background-color: <<colour code-background>>;
+	border: 1px solid <<colour tiddler-border>>;
+	border-radius: 4px;
+    padding: 0 0.5em;
+}
+
+.doc-tiddler-fields h2 svg {
+	height: 1em;
+}
+
+
+.doc-tiddler-fields table, 
+.doc-tiddler-fields h2 {
+	margin: 0.5em 0;
+}
+
+.doc-tiddler-fields table {
+	background-color: <<colour tiddler-background>>;
+}
+
+@media screen {
+	.doc-tiddler-fields {
+		<<box-shadow "1px 1px 6px rgba(0, 0, 0, 0.6)">>
+	}
 }

package/editions/tw5.com/tiddlers/system/download-empty.tid

@@ -1,4 +1,5 @@
 title: $:/editions/tw5.com/download-empty
+code-body: yes
 
 \define saveTiddlerFilter()
 [[$:/core]] [[$:/isEncrypted]] [[$:/themes/tiddlywiki/snowwhite]] [[$:/themes/tiddlywiki/vanilla]] -[[$:/boot/boot.css]] -[type[application/javascript]library[yes]] -[[$:/boot/boot.js]] -[[$:/boot/bootprefix.js]] +[sort[title]]

package/editions/tw5.com/tiddlers/system/operator-macros.tid

@@ -1,26 +1,33 @@
 created: 20150117152607000
-modified: 20150228114306000
-title: $:/editions/tw5.com/operator-macros
+modified: 20220227210111054
 tags: $:/tags/Macro
+title: $:/editions/tw5.com/operator-macros
 
 \define .operator-examples(op,text:"Examples") <$link to="$op$ Operator (Examples)">$text$</$link>
 
+\define .operator-example-tryit-actions() <$action-setfield $tiddler=<<.state>> text="show" filter=<<__eg__>>/>
 \define .operator-example(n,eg,ie)
 <div class="doc-example">
-`$eg$`
-<$macrocall $name=".if" cond="""$ie$""" then="""<dd>&rarr; $ie$</dd>"""/>
 <$list filter="[title<.state-prefix>addsuffix{!!title}addsuffix[/]addsuffix[$n$]]" variable=".state">
 <$reveal state=<<.state>> type="nomatch" text="show">
+	`$eg$`
+	<$macrocall $name=".if" cond="""$ie$""" then="""<dd>&rarr; $ie$</dd>"""/>
 	<dl>
-	<dd><$button set=<<.state>> setTo="show">Try it</$button></dd>
+	<dd><$button actions=<<.operator-example-tryit-actions>>>Try it</$button></dd>
 	</dl>
 </$reveal>
 <$reveal state=<<.state>> type="match" text="show">
+	<$edit-text tiddler=<<.state>> field="filter" tag="input" type=search focus="true"/>
 	<dl>
-	<dd><$button set=<<.state>> setTo="">Hide</$button></dd>
+	<dd>
+	<$button set=<<.state>> setTo="">Hide</$button>
+	<$reveal stateTitle=<<.state>> stateField="filter" type="nomatch" text=<<__eg__>>>
+		<$button actions=<<.operator-example-tryit-actions>>>Reset</$button>
+	</$reveal>
+	</dd>
 	</dl>
 	<blockquote class="doc-example-result">
-	<ul><$list filter="""$eg$""" emptyMessage="(empty)">
+	<ul><$list filter={{{[<.state>get[filter]]}}} emptyMessage="(empty)">
 	<li><$link><$view field="title"/></$link></li>
 	</$list></ul>
 	</blockquote>
@@ -41,3 +48,5 @@ tags: $:/tags/Macro
 <$macrocall $name=".note" _="This operator is <<.em not>> available when ~TiddlyWiki is running in a web browser."/>
 
 \end
+
+<pre><$view field="text"/></pre>

package/editions/tw5.com/tiddlers/system/operator-template.tid

@@ -1,8 +1,8 @@
 created: 20150203173506000
-modified: 20150203181725000
-title: $:/editions/tw5.com/operator-template
-tags: $:/tags/ViewTemplate
 list-before: $:/core/ui/ViewTemplate/body
+modified: 20220316121232243
+tags: $:/tags/ViewTemplate
+title: $:/editions/tw5.com/operator-template
 
 \define .op-place()
 <$macrocall $name=".if"
@@ -23,25 +23,25 @@ list-before: $:/core/ui/ViewTemplate/body
 <$set name="op-name" value="">
 <$list filter="[all[current]tag[Filter Operators]]">
 <table class="doc-table before-tiddler-body">
-<!-->
+<!-- -->
 <$set name="op-head" value="purpose">
 <$set name="op-body" value={{!!op-purpose}}>
 <<.op-row>>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="[[input|Filter Syntax]]">
 <$set name="op-body" value={{!!op-input}}>
 <<.op-row>>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="`!` input">
 <$set name="op-body" value={{!!op-neg-input}}>
 <<.op-row>>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="[[suffix|Filter Step]]">
 <$set name="op-body" value={{!!op-suffix}}>
 <$set name="op-name" value={{!!op-suffix-name}}>
@@ -49,7 +49,7 @@ list-before: $:/core/ui/ViewTemplate/body
 </$set>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="[[parameter|Filter Parameter]]">
 <$set name="op-body" value={{!!op-parameter}}>
 <$set name="op-name" value={{!!op-parameter-name}}>
@@ -57,20 +57,23 @@ list-before: $:/core/ui/ViewTemplate/body
 </$set>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="output">
 <$set name="op-body" value={{!!op-output}}>
 <<.op-row>>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="`!` output">
 <$set name="op-body" value={{!!op-neg-output}}>
 <<.op-row>>
 </$set>
 </$set>
-<!-->
+<!-- -->
 </table>
+
+[[Learn more about how to use Filters|Filters]]
+
 <$list filter="[all[current]has[from-version]]" variable="listItem">
 <$macrocall $name=".from-version" version={{!!from-version}}/>
 </$list>

package/editions/tw5.com/tiddlers/system/style-guide-macros.tid

@@ -1,5 +1,7 @@
-title: $:/editions/tw5.com/style-guide-macros
+created: 20220227210120989
+modified: 20220227210123695
 tags: $:/tags/Macro
+title: $:/editions/tw5.com/style-guide-macros
 
 \define style-guide(good,bad)
 <table>
@@ -15,3 +17,5 @@ tags: $:/tags/Macro
 </tbody>
 </table>
 \end
+
+<pre><$view field="text"/></pre>

package/editions/tw5.com/tiddlers/system/variable-macros.tid

@@ -1,7 +1,7 @@
 created: 20150228114241000
-modified: 20150228141312000
-title: $:/editions/tw5.com/variable-macros
+modified: 20220227210136243
 tags: $:/tags/Macro
+title: $:/editions/tw5.com/variable-macros
 
 \define .variable-examples(v,text:"Examples") <$link to="$v$ Variable (Examples)">$text$</$link>
 \define .macro-examples(m,text:"Examples") <$link to="$m$ Macro (Examples)">$text$</$link>
@@ -17,3 +17,5 @@ It can be set to <<.value yes>> or <<.value no>> prior to transcluding such a bu
 
 The standard page template sets it to the value found in [[$configTiddler$]], with the result that this becomes the default for the whole page. The user can adjust this default by using a tickbox on the <<.controlpanel-tab Settings>> tab of the [[Control Panel|$:/ControlPanel]].
 \end
+
+<pre><$view field="text"/></pre>

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

@@ -1,7 +1,8 @@
 created: 20150117184156000
-modified: 20150117184616000
-title: $:/editions/tw5.com/wikitext-macros
+modified: 20220227210152153
 tags: $:/tags/Macro
+title: $:/editions/tw5.com/wikitext-macros
+type: text/vnd.tiddlywiki
 
 \define wikitext-example(src)
 <div class="doc-example">
@@ -14,7 +15,9 @@ $src$
 
 That renders as:
 
+$$$text/vnd.tiddlywiki
 $src$
+$$$
 
 ... and the underlying HTML is:
 
@@ -35,10 +38,23 @@ $src$
 
 That renders as:
 
+$$$text/vnd.tiddlywiki
 $src$
+$$$
 </div>
 \end
 
+\define wikitext-example-table-header() <thead><tr><th/><th>wiki text</th><th>renders as</th></tr></thead>
+
+\define wikitext-example-table-row(id, code)
+ <tr>
+<th><<__id__>></th><td><$codeblock code=<<__code__>>/></td><td>
+
+<<__code__>>
+</td>
+</tr>
+\end
+
 \define tw-code(tiddler)
 <$codeblock language={{$tiddler$!!type}} code={{$tiddler$}}/>
 \end
@@ -47,4 +63,6 @@ $src$
 [[$tiddler$]]:
 
 <<tw-code $tiddler$>>
-\end
+\end
+
+<pre><$view field="text"/></pre>

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_ControlPanel_Plugins.tid

@@ -0,0 +1,9 @@
+caption: $:/tags/ControlPanel/Plugins
+created: 20210807123106257
+description: marks elements to be placed under "Plugins" tab in Control Panel
+modified: 20210807123621182
+tags: SystemTags
+title: SystemTag: $:/tags/ControlPanel/Plugins
+type: text/vnd.tiddlywiki
+
+The [[system tag|SystemTags]] `$:/tags/ControlPanel/Plugins` marks elements to be placed under "Plugins" tab in [[$:/ControlPanel]]

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_EditorTools.tid

@@ -0,0 +1,9 @@
+caption: $:/tags/EditorTools
+created: 20210519160245560
+description: marks the edit mode tiddler toolbar for non-button elements.
+modified: 20210519160509587
+tags: SystemTags
+title: SystemTag: $:/tags/EditorTools
+type: text/vnd.tiddlywiki
+
+The [[system tag|SystemTags]]  `$:/tags/EditorTools` can be used to include non-button UI elements in the edit mode tiddler toolbar. For buttons see [[SystemTag: $:/tags/EditToolbar]].

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_Image.tid

@@ -1,9 +1,9 @@
 caption: $:/tags/Image
 created: 20180926170345251
 description: marks (core) images
-modified: 20180926171456494
+modified: 20211018102336342
 tags: SystemTags
 title: SystemTag: $:/tags/Image
 type: text/vnd.tiddlywiki
 
-The [[system tag|SystemTags]] `$:/tags/Image` marks (core) images
+The [[system tag|SystemTags]] `$:/tags/Image` marks core images. An overview of system icons can be found in the [[Icon Gallery]]

package/editions/tw5.com/tiddlers/variables/examples/Sample Headings 1-2-3.tid

@@ -1,5 +1,6 @@
 created: 20180609112450207
-modified: 20180609112450207
+modified: 20211117024604173
+tags: [[Variable Examples]]
 title: Sample Headings 1,2,3
 
 ! This is a Level 1 Heading

package/editions/tw5.com/tiddlers/variables/examples/Sample Headings 3-4-5.tid

@@ -1,5 +1,6 @@
 created: 20180609112450207
-modified: 20180609112450207
+modified: 20211117024620368
+tags: [[Variable Examples]]
 title: Sample Headings 3,4,5
 
 !!! This is written as a Level 3 heading

package/editions/tw5.com/tiddlers/variables/examples/Sample Headings 4-5-6.tid

@@ -1,5 +1,6 @@
 created: 20180609112450207
-modified: 20180609112450207
+modified: 20211117024620368
+tags: [[Variable Examples]]
 title: Sample Headings 4,5,6
 
 !!!! This is written as a Level 4 heading

package/editions/tw5.com/tiddlers/webserver/Using HTTPS.tid

@@ -1,12 +1,14 @@
 created: 20180702160923664
-modified: 20180703100549667
+modified: 20211111023610539
 tags: [[WebServer Guides]]
 title: Using HTTPS
 type: text/vnd.tiddlywiki
 
 By default, TiddlyWiki's WebServer serves resources over the insecure HTTP protocol. The risk is minimal if it is only being used within a private, trusted network but in many situations it is desirable to use a secure HTTPS connection.
 
-HTTPS requires the server to be configured with a certificate via a "cert" file and a "key" file, configured via the [[tls-cert|WebServer Parameter: tls-cert]] and [[tls-key|WebServer Parameter: tls-key]] parameters
+HTTPS requires the server to be configured with a certificate via a "cert" file and a "key" file, configured via the [[tls-cert|WebServer Parameter: tls-cert]] and [[tls-key|WebServer Parameter: tls-key]] parameters.
+
+<<.from-version "5.2.2">> The optional [[tls-passphrase|WebServer Parameter: tls-passphrase]] parameter allows the server to use certificate files that have been generated with a passphrase/password.
 
 Certificates can be obtained from a certification authority such as https://letsencrypt.org/, or you can create a self-signed certificate for internal testing.
 
@@ -17,3 +19,16 @@ openssl req -newkey rsa:2048 -new -nodes -keyout mywikifolder/key.pem -out mywik
 openssl x509 -req -days 365 -in mywikifolder/csr.pem -signkey mywikifolder/key.pem -out mywikifolder/server.crt
 tiddlywiki mywikifolder --listen username=joe password=bloggs tls-key=key.pem tls-cert=server.crt
 ```
+
+If using a [[tls-passphrase|WebServer Parameter: tls-passphrase]] to generate the certificate files, the commands would change as below:
+
+* remove the `-nodes` flag, which specifies "no encryption"
+* replace `TLS_PASSPHRASE` in the `-passout` and `-passin` parameters in the below commands with your chosen string.
+
+This is the simplest, but __least secure method,__ of passing a passphrase to the certificate utility. See [[this Stack Exchange anwser on openssl certificates|https://security.stackexchange.com/questions/106525/generate-csr-and-private-key-with-password-with-openssl]] and the [[openssl|https://www.openssl.org/docs/man1.0.2/man1/openssl.html]] and [[openssl-passphrase-options|https://www.openssl.org/docs/manmaster/man1/openssl-passphrase-options.html]] page in the openssl utility documentation.
+
+```
+openssl req -newkey rsa:2048 -passout pass:TLS_PASSPHRASE -new -keyout mywikifolder/key.pem -out mywikifolder/csr.pem -passout pass:TLS_PASSPHRASE
+openssl x509 -req -days 365 -in mywikifolder/csr.pem -signkey mywikifolder/key.pem -out mywikifolder/server.crt -passin pass:TLS_PASSPHRASE
+tiddlywiki mywikifolder --listen username=joe password=bloggs tls-key=key.pem tls-cert=server.crt tls-passphrase=TLS_PASSPHRASE
+```

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

@@ -1,23 +1,100 @@
 created: 20180905075846391
-modified: 20200814110131083
+modified: 20210611055708739
 tags: [[WebServer Guides]]
 title: Using the external JavaScript template
 type: text/vnd.tiddlywiki
 
-Setting the [[root-tiddler|WebServer Parameter: root-tiddler]] parameter to `$:/core/save/all-external-js` switches to a special template that externalises TiddlyWiki's core ~JavaScript into a separate file. For example:
+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.
+
+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.
+
+! 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.
 
 ```
-tiddlywiki editions/tw5.com-server/ --listen host=0.0.0.0 "root-tiddler=$:/core/save/all-external-js"
+tiddlywiki YOUR_WIKI_FOLDER --listen 'root-tiddler=$:/core/save/all-external-js' use-browser-cache=yes
 ```
 
-To ensure that the "save changes" button saves a full, standalone wiki, it is also necessary to set the tiddler $:/config/SaveWikiButton/Template to contain `$:/core/save/all-external-js`.
+<<.tip """You can activate your browser's ''Developer Tools: Network'' tab and reload the page to see how it works.""">>
 
-The provided edition `server-external-js` contains all the configuration necessary to use the external ~JavaScript template.
+<<.tip """On Windows, Command Prompt (CMD) users need to replace single quotes `'` with double quotation marks `"`.""">>
 
-!! Background
+!! Initializing a new wiki
 
-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.
+The provided edition `server-external-js` contains all the configuration necessary to use the external ~JavaScript template. Here is an example:
 
-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.
+```
+tiddlywiki ./myNewWiki --init server-external-js
+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.
+
+To customize your `--build listen` command, see [[tiddlywiki.info Files]] and [[ListenCommand]].
+
+! 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]])
+
+<<.warning "This functionality is intended for advanced users: there are many more ways for things to go wrong than with the standard single file configuration">>
+
+!! Saving your snapshots
+
+If you start your ~TiddlyWiki server in the "external-js" configuration, snapshots you save from the wiki will also have the external-js configuration.
+
+You can click on the "cloud" button and choose <<.icon $:/core/images/download-button>>  ''Save snapshot for offline use''. The html wiki you saved will have a reduced file size compared to a regular snapshot because the ~TiddlyWiki core code has been externalized. However, to be able to use this wiki, you ''must'' also have a copy of ~TiddlyWiki's core ~JavaScript in the same directory; see below for instructions for obtaining it
+
+The "server-external-js" edition lets you save the snapshot from the command line:
+
+```
+tiddlywiki YOUR_WIKI_FOLDER --build index
+```
+
+The files `index.html` and `tiddlywikicore-5.x.x.js` will be saved in your wiki folder's `output` directory.
+
+!! 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).
+
+!! Obtaining the ~TiddlyWiki core with Node.js
+
+You can also run the following command to obtain the core ~JavaScript. The file `tiddlywikicore-5.x.x.js` will be saved in the`output` directory of your wiki folder:
+
+```
+tiddlywiki YOUR_WIKI_FOLDER \
+    --render '$:/core/templates/tiddlywiki5.js' \
+    '[[tiddlywikicore-]addsuffix<version>addsuffix[.js]]' \
+    'text/plain'
+```
+
+The "server-external-js" edition has a shortcut for the BuildCommand to do the same thing:
+
+```
+tiddlywiki YOUR_WIKI_FOLDER --build tiddlywikicore
+```
+
+! Upgrading your standalone wiki
+
+<<.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:
+
+# Proceed with the [[Upgrade Process for Standalone TiddlyWikis|Upgrading]]. Your wiki will be converted to a full standalone HTML.
+
+# Open your upgraded wiki in the browser. If you'd like to revert to using the regular template, restore the original shadow tiddler `$:/config/SaveWikiButton/Template` by deleting any custom copy. Save your wiki and you are done. 
+
+# Otherwise, from your wiki, select the ''Tools'' tab from the sidebar and click on the <<.icon $:/core/images/star-filled>> ''export tiddlywiki core'' button to obtain the core from your wiki.
+
+# Verify that `$:/config/SaveWikiButton/Template` still contains `$:/core/save/offline-external-js`. Modify if necessary.
 
-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.
+# Save your wiki again. Your wiki is now converted to using the external core.

package/editions/tw5.com/tiddlers/webserver/WebServer API_ Delete Tiddler.tid

@@ -1,5 +1,5 @@
 created: 20181002112106875
-modified: 20181002124355314
+modified: 20210418100750769
 tags: [[WebServer API]]
 title: WebServer API: Delete Tiddler
 type: text/vnd.tiddlywiki
@@ -14,6 +14,10 @@ Parameters:
 
 * ''title'' - URI encoded title of the tiddler to delete
 
+Headers:
+
+* ''x-requested-with'' - must be set to `TiddlyWiki` in order for the request to succeed, unless [[WebServer Parameter: csrf-disable]] is set to `yes`
+
 Response:
 
 * 204 No Content

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

@@ -20,7 +20,7 @@ In order to avoid denial of service attacks with malformed filters in the defaul
 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:
 
 ```
-title: $:/config/Server/ExternalFilters/[all[tiddlers]] -[[$:/isEncrypted]] -[prefix[$:/temp/]] -[prefix[$:/status/]]
+title: $:/config/Server/ExternalFilters/[all[tiddlers]] -[[$:/isEncrypted]] -[prefix[$:/temp/]] -[prefix[$:/status/]] -[[$:/boot/boot.js]] -[[$:/boot/bootprefix.js]] -[[$:/library/sjcl.js]] -[[$:/core]]
 text: yes
 ```
 

package/editions/tw5.com/tiddlers/webserver/WebServer API_ Put Tiddler.tid

@@ -1,5 +1,5 @@
 created: 20181002131341062
-modified: 20181002131556452
+modified: 20210418100750769
 tags: [[WebServer API]]
 title: WebServer API: Put Tiddler
 type: text/vnd.tiddlywiki
@@ -16,6 +16,10 @@ Parameters:
 
 * ''title'' - URI encoded title of the tiddler to save
 
+Headers:
+
+* ''x-requested-with'' - must be set to `TiddlyWiki` in order for the request to succeed, unless [[WebServer Parameter: csrf-disable]] is set to `yes`
+
 Response:
 
 * 204 No Content

package/editions/tw5.com/tiddlers/webserver/WebServer Authorization.tid

@@ -1,18 +1,24 @@
 created: 20180630194006239
-modified: 20180904174030250
+modified: 20211122004159427
 tags: WebServer
 title: WebServer Authorization
 type: text/vnd.tiddlywiki
 
-''Authorization'' is the process of determining which resources may be accessed by a particular user. It occurs after [[authentication|WebServer Authentication]] has determined the identity of the user. TiddlyWiki's WebServer implements a simple authorization scheme which permits independent control of who has read and write access to a wiki.
+''Authorization'' is the process of determining which resources may be accessed by a particular user. It occurs after [[authentication|WebServer Authentication]] has determined the identity of the user. TiddlyWiki's WebServer implements a simple authorization scheme which permits independent control of who has administrator access to the server, and read and write access to a wiki.
 
-The WebServer parameters [[readers|WebServer Parameter: readers]] and [[writers|WebServer Parameter: writers]] each contain a comma separated list of //principals// (which is to say, either usernames or certain special tokens) which should have read or write access respectively.
+The WebServer parameters [[admin|WebServer Parameter: admin]], [[readers|WebServer Parameter: readers]] and [[writers|WebServer Parameter: writers]] each contain a comma separated list of //principals// (which is to say, either usernames or certain special tokens) which should have read or write access respectively. 
 
 The available special tokens are:
 
 * ''(anon)'' - indicates all anonymous users
 * ''(authenticated)'' - indicates all authenticated users
 
+!! Admin Functions
+
+<<.tip"""The ''(anon)'' token is not valid for the [[admin|WebServer Parameter: admin]] parameter.""">>
+
+At this time, no server functions are restricted to ''admin'' authorized users in the unmodified [[Tiddlywiki server|WebServer]]. Third party plugins can leverage this to restrict routes or commands to a subset of authorized users.
+
 !! Read-only Mode
 
 Read-only mode is engaged when the current user is not authorized to write to the current wiki.
@@ -39,3 +45,9 @@ In the following example, read access is granted to all authenticated users, but
 ```
 tiddlywiki mywikifolder --listen credentials=myusers.csv "readers=(authenticated)" writers=mary
 ```
+
+In the following example, read and write access is granted to all authenticated users, but only "mary" is granted admin access:
+
+```
+tiddlywiki mywikifolder --listen credentials=myusers.csv "readers=(authenticated)" "writers=(authenticated)" admin=mary
+```

package/editions/tw5.com/tiddlers/webserver/WebServer Parameter_ admin.tid

@@ -0,0 +1,8 @@
+caption: admin
+created: 20211111015634164
+modified: 20211111023141767
+tags: [[WebServer Parameters]]
+title: WebServer Parameter: admin
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.2.2">> The [[web server configuration parameter|WebServer Parameters]] ''admin'' is used to specify the security principals with administrator access to the [[WebServer]]. Does not accept the ''(anon)'' special token. See [[WebServer Authorization]] for more details.