From d7d9c83fead4f33d6b0587041a2c0e5deb3bc610 Mon Sep 17 00:00:00 2001
From: pmario <pmariojo@gmail.com>
Date: Wed, 31 Jan 2024 10:28:51 +0100
Subject: [PATCH 1/9] add a store.area.template to tiddlywiki5.html.tid. To
 work properly

it needs to go behind `{{$:/core/templates/store.info.template.html}}`

On branch 6684-add-last-saved-timestamp
Changes to be committed:
	modified:   core/templates/tiddlywiki5.html.tid
---
 core/templates/tiddlywiki5.html.tid | 1 +
 1 file changed, 1 insertion(+)

diff --git a/core/templates/tiddlywiki5.html.tid b/core/templates/tiddlywiki5.html.tid
index a94ae2693..f0cc90d26 100644
--- a/core/templates/tiddlywiki5.html.tid
+++ b/core/templates/tiddlywiki5.html.tid
@@ -41,6 +41,7 @@ title: $:/core/templates/tiddlywiki5.html
 </noscript>
 <!--~~ Ordinary tiddlers ~~-->
 `{{$:/core/templates/store.area.template.html}}`
+`{{$:/core/templates/store.info.template.html}}`
 <!--~~ Library modules ~~-->
 <div id="libraryModules" style="display:none;">
 `{{{ [is[system]type[application/javascript]library[yes]] ||$:/core/templates/javascript-tiddler}}}`

From c89b351cb4ea40a46ced029ef84a2641faccdd2f Mon Sep 17 00:00:00 2001
From: pmario <pmariojo@gmail.com>
Date: Wed, 31 Jan 2024 10:40:35 +0100
Subject: [PATCH 2/9] add new store.info.template and
 store.info.tiddler.template tiddlers

the info.tiddler.template is tagged: $:/tags/InfoTiddlerTemplate so
several tagged tiddlers can be injected, if needed.

Important: The templates have to use the TW HTML template syntax

On branch 6684-add-last-saved-timestamp
Changes to be committed:
	new file:   core/templates/store.info.template.html.tid
	new file:   core/templates/store.info.tiddler.template.tid
---
 core/templates/store.info.template.html.tid   | 21 ++++++++++++++++++
 .../templates/store.info.tiddler.template.tid | 22 +++++++++++++++++++
 2 files changed, 43 insertions(+)
 create mode 100644 core/templates/store.info.template.html.tid
 create mode 100644 core/templates/store.info.tiddler.template.tid

diff --git a/core/templates/store.info.template.html.tid b/core/templates/store.info.template.html.tid
new file mode 100644
index 000000000..b1aaf53ec
--- /dev/null
+++ b/core/templates/store.info.template.html.tid
@@ -0,0 +1,21 @@
+title: $:/core/templates/store.info.template.html
+
+\whitespace trim
+<!-- Unencrypted -->
+<$list filter="[[$:/isEncrypted]get[text]else[no]match[no]]">
+	<$list filter="[[storeAreaFormat]is[variable]getvariable[]else[json]match[json]]">
+		<!-- New-style JSON store area -->
+		`<script class="tiddlywiki-tiddler-store" type="application/json">[`
+            <$let
+				newline={{{ [charcode[10]] }}}
+				join=`,$(newline)$`
+			>
+				<$text text=<<newline>>/>
+					<$list filter="[all[shadows+tiddlers]tag[$:/tags/InfoTiddlerTemplate]]">
+						<$transclude mode=block/>
+					</$list>
+				<$text text=<<newline>>/>
+			</$let>
+		`]</script>`
+	</$list>
+</$list>
diff --git a/core/templates/store.info.tiddler.template.tid b/core/templates/store.info.tiddler.template.tid
new file mode 100644
index 000000000..ec5d42b0d
--- /dev/null
+++ b/core/templates/store.info.tiddler.template.tid
@@ -0,0 +1,22 @@
+title: $:/core/templates/store.info.tiddler.template
+tags: $:/tags/InfoTiddlerTemplate
+
+<!-- This template will be injected into the html file when the wiki is saved. It is activated by $:/core/templates/store.info.template.html -->
+\whitespace trim
+\procedure readableFormat() [UTC]YYYY-0MM-0DD 0hh:0mm:0ss.0XXX UTC TZD
+
+<!-- It's needed to use variables, to have the absolute same timestamp for all tiddlers -->
+<$let
+	timestamp={{{ [<now format:[UTC]YYYY0MM0DD0hh0mm0ss0XXX>] }}}
+	timeReadable={{{ [<timestamp>format:date<readableFormat>] }}}
+>
+	<% if [{$:/info/browser}match[yes]] %>
+		`{"title": "$:/info/last-saved/timestamp", "created":"`<<timestamp>>`", "modified":"`<<timestamp>>`", "text":"`<<timestamp>>`"}`
+		<$text text=<<join>>/>
+		`{"title": "$:/info/last-saved/date",  "created":"`<<timestamp>>`", "modified":"`<<timestamp>>`", "text":"`<<timeReadable>>`"}`
+	<% elseif [{$:/info/node}match[yes]] %>
+		`{"title": "$:/info/server-created-wiki/timestamp", "created":"`<<timestamp>>`", "modified":"`<<timestamp>>`", "text":"`<<timestamp>>`"}`
+		<$text text=<<join>>/>
+		`{"title": "$:/info/server-created-wiki/date",  "created":"`<<timestamp>>`", "modified":"`<<timestamp>>`", "text":"`<<timeReadable>>`"}`
+	<% endif %>
+</$let>
\ No newline at end of file

From cc569db97368029a9db74e6da1f0b9a6f63257db Mon Sep 17 00:00:00 2001
From: pmario <pmariojo@gmail.com>
Date: Wed, 31 Jan 2024 10:41:35 +0100
Subject: [PATCH 3/9] add some docs to the new $:/Info/last-saved ... tiddlers

---
 .../tiddlers/mechanisms/InfoMechanism.tid     | 42 ++++++++++++++++++-
 1 file changed, 40 insertions(+), 2 deletions(-)

diff --git a/editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid b/editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid
index 040dd7bd2..08f86d22f 100644
--- a/editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid
+++ b/editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid
@@ -1,5 +1,5 @@
 created: 20140720164948099
-modified: 20201124185829706
+modified: 20240130224322884
 tags: Mechanisms
 title: InfoMechanism
 type: text/vnd.tiddlywiki
@@ -13,7 +13,7 @@ System tiddlers in the namespace `$:/info/` are used to expose information about
 ! Information Tiddlers
 
 |!Title |!Description |
-|[[$:/info/startup-timestamp]] |<<.from-version "5.1.23">> Startup timestamp in TiddlyWiki date format |
+|[[$:/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`) |
@@ -29,3 +29,41 @@ System tiddlers in the namespace `$:/info/` are used to expose information about
 |[[$:/info/url/protocol]] |<<.from-version "5.1.14">> Protocol portion of URL of wiki (eg, ''<<example protocol>>'') |
 |[[$:/info/url/search]] |<<.from-version "5.1.14">> Search portion of URL of wiki (eg, ''<<example search>>'') |
 |[[$:/info/darkmode]] |<<.from-version "5.1.23">> Is dark mode enabled? ("yes" or "no") |
+
+!! Last Saved -- Single File Wiki
+
+The following tiddlers will be "injected" into the HTML file when the wiki is saved. Tagged template tiddlers are used to create the info tiddlers. Those tiddlers will be overwritten with the next automatic or manual save action.
+
+`$:/info/last-saved/*` will  not be created on a server if used with a client-server configuration. They will be created, if a "snapshot" is saved to the disk.
+
+|! Title |! Description |
+|$:/info/last-saved/timestamp |<<.from-version "5.3.4">> This tiddler will be created when a single file wiki is saved. It uses ~TiddlyWiki DateFormat |
+|$:/info/last-saved/date |<<.from-version "5.3.4">> Shows the same last-saved timestamp in human readable form. Eg: "2024-01-30 15:36:04.430 UTC +01:00"<br>using the following format: `[UTC]YYYY-0MM-0DD 0hh:0mm:0ss.0XXX UTC TZD` |
+
+!! Client Server Configuration
+
+<<.warning """If a client server configuration is used, the TW template is used to create the wiki file on the server. So the timestamps saved to the "server-created" info tiddlers are generated by the server. Depending on the server "local time" this timestamp ''can be different'' to the current "user time". Whenever the wiki file is created, the values will be set. `server-created-*` tiddlers will ''not'' be deleted if saved as a single file. The information may have some value""">>
+
+|! Title |! Description |
+|$:/info/server-created-wiki/timestamp |<<.from-version "5.3.4">> This tiddler will be created when a single file wiki is saved. It uses ~TiddlyWiki DateFormat |
+|$:/info/server-created-wiki/date |<<.from-version "5.3.4">> Shows the same last-saved timestamp in human readable form.<br>using the following format: `YYYY-0MM-0DD 0hh:0mm:0ss.0XXX` |
+
+!! Additional information
+
+By default ~TiddlyWiki does not save the full URL information to the file, due to privacy concerns. Eg: `$:/info/last-saved/full/url` can contain private information. Users are free to include the following code into their wiki, if they decide to do so. 
+
+<details><summary>Show code to add the full path to an info tiddler</summary>
+<$codeblock code="""title: inject-full-path
+tags: $:/tags/InfoTiddlerTemplate
+
+<!-- This template will be injected into the html file when the wiki is saved. It is activated by $:/core/templates/store.info.template.html -->
+\whitespace trim
+
+\function timestamp() [<now format:[UTC]YYYY0MM0DD0hh0mm0ss0XXX>]
+
+<% if [{$:/info/browser}match[yes]] %>
+	<$text text=<<join>>/>
+	`{"title": "$:/info/last-saved/full/url",  "created":"`<<timestamp>>`", "modified":"`<<timestamp>>`", "text":"`{{$:/info/url/full}}`"}`
+<% endif %>
+"""/>
+</details>

From 7b0f23b2cc05c0fead63ec7265a5d54d940b2d52 Mon Sep 17 00:00:00 2001
From: pmario <pmariojo@gmail.com>
Date: Wed, 31 Jan 2024 11:05:50 +0100
Subject: [PATCH 4/9] fix client-server docs

---
 editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid b/editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid
index 08f86d22f..836b25345 100644
--- a/editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid
+++ b/editions/tw5.com/tiddlers/mechanisms/InfoMechanism.tid
@@ -1,5 +1,5 @@
 created: 20140720164948099
-modified: 20240130224322884
+modified: 20240131100514913
 tags: Mechanisms
 title: InfoMechanism
 type: text/vnd.tiddlywiki
@@ -45,8 +45,8 @@ The following tiddlers will be "injected" into the HTML file when the wiki is sa
 <<.warning """If a client server configuration is used, the TW template is used to create the wiki file on the server. So the timestamps saved to the "server-created" info tiddlers are generated by the server. Depending on the server "local time" this timestamp ''can be different'' to the current "user time". Whenever the wiki file is created, the values will be set. `server-created-*` tiddlers will ''not'' be deleted if saved as a single file. The information may have some value""">>
 
 |! Title |! Description |
-|$:/info/server-created-wiki/timestamp |<<.from-version "5.3.4">> This tiddler will be created when a single file wiki is saved. It uses ~TiddlyWiki DateFormat |
-|$:/info/server-created-wiki/date |<<.from-version "5.3.4">> Shows the same last-saved timestamp in human readable form.<br>using the following format: `YYYY-0MM-0DD 0hh:0mm:0ss.0XXX` |
+|$:/info/server-created-wiki/timestamp |<<.from-version "5.3.4">> This tiddler will be created when the server creates a wiki to be transferred to the client, ''ore'' if as single-file wiki is created by the server using the `--build index` command. It uses ~TiddlyWiki DateFormat |
+|$:/info/server-created-wiki/date |<<.from-version "5.3.4">> Shows the same timestamp in human readable form |
 
 !! Additional information
 

From 322fbdb36ba584c64492c718f69b2711ecbad11c Mon Sep 17 00:00:00 2001
From: pmario <pmariojo@gmail.com>
Date: Mon, 11 Mar 2024 15:28:37 +0100
Subject: [PATCH 5/9] rename sore.info -> store.custom, rename tag to
 $:/tags/InjectCustomTiddlers

---
 ...nfo.template.html.tid => store.custom.template.html.tid} | 2 +-
 ...ddler.template.tid => store.custom.tiddler.template.tid} | 6 +++---
 core/templates/tiddlywiki5.html.tid                         | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)
 rename core/templates/{store.info.template.html.tid => store.custom.template.html.tid} (87%)
 rename core/templates/{store.info.tiddler.template.tid => store.custom.tiddler.template.tid} (86%)

diff --git a/core/templates/store.info.template.html.tid b/core/templates/store.custom.template.html.tid
similarity index 87%
rename from core/templates/store.info.template.html.tid
rename to core/templates/store.custom.template.html.tid
index b1aaf53ec..e7fc2ff7e 100644
--- a/core/templates/store.info.template.html.tid
+++ b/core/templates/store.custom.template.html.tid
@@ -11,7 +11,7 @@ title: $:/core/templates/store.info.template.html
 				join=`,$(newline)$`
 			>
 				<$text text=<<newline>>/>
-					<$list filter="[all[shadows+tiddlers]tag[$:/tags/InfoTiddlerTemplate]]">
+					<$list filter="[all[shadows+tiddlers]tag[$:/tags/InjectCustomTiddlers]]">
 						<$transclude mode=block/>
 					</$list>
 				<$text text=<<newline>>/>
diff --git a/core/templates/store.info.tiddler.template.tid b/core/templates/store.custom.tiddler.template.tid
similarity index 86%
rename from core/templates/store.info.tiddler.template.tid
rename to core/templates/store.custom.tiddler.template.tid
index ec5d42b0d..0dfc14fd6 100644
--- a/core/templates/store.info.tiddler.template.tid
+++ b/core/templates/store.custom.tiddler.template.tid
@@ -1,7 +1,7 @@
-title: $:/core/templates/store.info.tiddler.template
-tags: $:/tags/InfoTiddlerTemplate
+title: $:/core/templates/store.custom.tiddler.template
+tags: $:/tags/InjectCustomTiddlers
 
-<!-- This template will be injected into the html file when the wiki is saved. It is activated by $:/core/templates/store.info.template.html -->
+<!-- This template will be injected into the html file when the wiki is saved. It is activated by $:/core/templates/store.custom.template.html -->
 \whitespace trim
 \procedure readableFormat() [UTC]YYYY-0MM-0DD 0hh:0mm:0ss.0XXX UTC TZD
 
diff --git a/core/templates/tiddlywiki5.html.tid b/core/templates/tiddlywiki5.html.tid
index f0cc90d26..1ef4f7dd6 100644
--- a/core/templates/tiddlywiki5.html.tid
+++ b/core/templates/tiddlywiki5.html.tid
@@ -41,7 +41,7 @@ title: $:/core/templates/tiddlywiki5.html
 </noscript>
 <!--~~ Ordinary tiddlers ~~-->
 `{{$:/core/templates/store.area.template.html}}`
-`{{$:/core/templates/store.info.template.html}}`
+`{{$:/core/templates/store.custom.template.html}}`
 <!--~~ Library modules ~~-->
 <div id="libraryModules" style="display:none;">
 `{{{ [is[system]type[application/javascript]library[yes]] ||$:/core/templates/javascript-tiddler}}}`

From 5655d02ab39b7216712828a1447a2f994b14ab48 Mon Sep 17 00:00:00 2001
From: pmario <pmariojo@gmail.com>
Date: Mon, 11 Mar 2024 15:31:44 +0100
Subject: [PATCH 6/9] fix template title

---
 core/templates/store.custom.template.html.tid | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/core/templates/store.custom.template.html.tid b/core/templates/store.custom.template.html.tid
index e7fc2ff7e..718be4e94 100644
--- a/core/templates/store.custom.template.html.tid
+++ b/core/templates/store.custom.template.html.tid
@@ -1,4 +1,4 @@
-title: $:/core/templates/store.info.template.html
+title: $:/core/templates/store.custom.template.html
 
 \whitespace trim
 <!-- Unencrypted -->

From ab53652cde8e720054909efe66ccb01be5d9e082 Mon Sep 17 00:00:00 2001
From: pmario <pmariojo@gmail.com>
Date: Mon, 11 Mar 2024 15:42:03 +0100
Subject: [PATCH 7/9] rename .custom. to .injected.

---
 ...tom.template.html.tid => store.injected.template.html.tid} | 2 +-
 ...ddler.template.tid => store.injected.tiddler.template.tid} | 4 ++--
 core/templates/tiddlywiki5.html.tid                           | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)
 rename core/templates/{store.custom.template.html.tid => store.injected.template.html.tid} (91%)
 rename core/templates/{store.custom.tiddler.template.tid => store.injected.tiddler.template.tid} (88%)

diff --git a/core/templates/store.custom.template.html.tid b/core/templates/store.injected.template.html.tid
similarity index 91%
rename from core/templates/store.custom.template.html.tid
rename to core/templates/store.injected.template.html.tid
index 718be4e94..b372973b0 100644
--- a/core/templates/store.custom.template.html.tid
+++ b/core/templates/store.injected.template.html.tid
@@ -1,4 +1,4 @@
-title: $:/core/templates/store.custom.template.html
+title: $:/core/templates/store.injected.template.html
 
 \whitespace trim
 <!-- Unencrypted -->
diff --git a/core/templates/store.custom.tiddler.template.tid b/core/templates/store.injected.tiddler.template.tid
similarity index 88%
rename from core/templates/store.custom.tiddler.template.tid
rename to core/templates/store.injected.tiddler.template.tid
index 0dfc14fd6..be3610c39 100644
--- a/core/templates/store.custom.tiddler.template.tid
+++ b/core/templates/store.injected.tiddler.template.tid
@@ -1,7 +1,7 @@
-title: $:/core/templates/store.custom.tiddler.template
+title: $:/core/templates/store.injected.tiddler.template
 tags: $:/tags/InjectCustomTiddlers
 
-<!-- This template will be injected into the html file when the wiki is saved. It is activated by $:/core/templates/store.custom.template.html -->
+<!-- This template will be injected into the html file when the wiki is saved. It is activated by $:/core/templates/store.injected.template.html -->
 \whitespace trim
 \procedure readableFormat() [UTC]YYYY-0MM-0DD 0hh:0mm:0ss.0XXX UTC TZD
 
diff --git a/core/templates/tiddlywiki5.html.tid b/core/templates/tiddlywiki5.html.tid
index 1ef4f7dd6..a59a48568 100644
--- a/core/templates/tiddlywiki5.html.tid
+++ b/core/templates/tiddlywiki5.html.tid
@@ -41,7 +41,7 @@ title: $:/core/templates/tiddlywiki5.html
 </noscript>
 <!--~~ Ordinary tiddlers ~~-->
 `{{$:/core/templates/store.area.template.html}}`
-`{{$:/core/templates/store.custom.template.html}}`
+`{{$:/core/templates/store.injected.template.html}}`
 <!--~~ Library modules ~~-->
 <div id="libraryModules" style="display:none;">
 `{{{ [is[system]type[application/javascript]library[yes]] ||$:/core/templates/javascript-tiddler}}}`

From 8be89ab7ef99a55afff4fa167ce5943163c99693 Mon Sep 17 00:00:00 2001
From: pmario <pmariojo@gmail.com>
Date: Mon, 11 Mar 2024 16:51:34 +0100
Subject: [PATCH 8/9] rename timestamp template to
 $:/core/templates/store.injected.timestamps.template

---
 ...ler.template.tid => store.injected.timestamps.template.tid} | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
 rename core/templates/{store.injected.tiddler.template.tid => store.injected.timestamps.template.tid} (91%)

diff --git a/core/templates/store.injected.tiddler.template.tid b/core/templates/store.injected.timestamps.template.tid
similarity index 91%
rename from core/templates/store.injected.tiddler.template.tid
rename to core/templates/store.injected.timestamps.template.tid
index be3610c39..bc0744995 100644
--- a/core/templates/store.injected.tiddler.template.tid
+++ b/core/templates/store.injected.timestamps.template.tid
@@ -1,4 +1,5 @@
-title: $:/core/templates/store.injected.tiddler.template
+title: $:/core/templates/store.injected.timestamps.template
+caption: Inject last-saved and server-created timestamps
 tags: $:/tags/InjectCustomTiddlers
 
 <!-- This template will be injected into the html file when the wiki is saved. It is activated by $:/core/templates/store.injected.template.html -->

From 23f3362e3b7c304685dfc11d3430b5daa64b7f9f Mon Sep 17 00:00:00 2001
From: pmario <pmariojo@gmail.com>
Date: Mon, 11 Mar 2024 16:52:09 +0100
Subject: [PATCH 9/9] description for new SystemTag:
 $:/tags/InjectCustomTiddlers

---
 .../SystemTag_ $__tags_InjectCustomTiddlers.tid      | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 editions/tw5.com/tiddlers/SystemTag_ $__tags_InjectCustomTiddlers.tid

diff --git a/editions/tw5.com/tiddlers/SystemTag_ $__tags_InjectCustomTiddlers.tid b/editions/tw5.com/tiddlers/SystemTag_ $__tags_InjectCustomTiddlers.tid
new file mode 100644
index 000000000..2a5322ceb
--- /dev/null
+++ b/editions/tw5.com/tiddlers/SystemTag_ $__tags_InjectCustomTiddlers.tid	
@@ -0,0 +1,12 @@
+caption: $:/tags/InjectCustomTiddlers
+created: 20240311144347147
+description: marks JSON serialized tiddlers to be injected into a custom store prior to a save-file action
+modified: 20240311153411624
+tags: SystemTags
+title: SystemTag: $:/tags/InjectCustomTiddlers
+type: text/vnd.tiddlywiki
+
+The [[system tag|SystemTags]] `$:/tags/InjectCustomTiddlers` marks JSON serialized tiddlers to be injected [[into a custom store section|$:/core/templates/store.injected.template.html]] in the generated HTML file.
+
+Note that the wiki must be saved and reloaded in order for the tiddlers to be seen. More implementation details can be found in the [[developers wiki|https://tiddlywiki.com/dev/#SystemTag%3A %24%3A%2Ftags%2FInjectCustomTiddlers]]. 
+