From 68095eb392cff3f6262f927c639618a1c3fa643e Mon Sep 17 00:00:00 2001 From: "jeremy@jermolene.com" Date: Thu, 25 Nov 2021 08:38:17 +0000 Subject: [PATCH 1/3] Docs: Misc minor edits --- ...ing custom-made tiddlers to the user interface.tid | 4 ++-- .../tiddlers/community/TiddlyWiki Hangouts.tid | 4 ++-- .../tiddlers/customising/Customise TiddlyWiki.tid | 4 ++-- editions/tw5.com/tiddlers/definitions/MathML.tid | 4 ++-- .../tw5.com/tiddlers/demonstrations/SampleAlert.tid | 9 --------- editions/tw5.com/tiddlers/features/Scalability.tid | 6 ++++-- .../tiddlers/platforms/TiddlyFox Apocalypse.tid | 4 ++-- .../platforms/TiddlyWiki in the Sky for TiddlyWeb.tid | 11 +++-------- 8 files changed, 17 insertions(+), 29 deletions(-) delete mode 100644 editions/tw5.com/tiddlers/demonstrations/SampleAlert.tid diff --git a/editions/tw5.com/tiddlers/Adding custom-made tiddlers to the user interface.tid b/editions/tw5.com/tiddlers/Adding custom-made tiddlers to the user interface.tid index 856870862..ae6718eb4 100644 --- a/editions/tw5.com/tiddlers/Adding custom-made tiddlers to the user interface.tid +++ b/editions/tw5.com/tiddlers/Adding custom-made tiddlers to the user interface.tid @@ -1,9 +1,9 @@ created: 20211124205353184 -modified: 20211124205351142 +modified: 20211124215729065 tags: [[Page and tiddler layout customisation]] title: Adding custom-made tiddlers to the user interface type: text/vnd.tiddlywiki -You can also create any tiddler you want and tag it with the appropriate [[system tag|SystemTags]], and it will appear in that place. For example, if you create a tiddler 'Reminder to self', add the text 'This is a reminder' and tag it `$:/tags/EditTemplate`, the words 'This is a reminder' will appear inside every tiddler when you edit it. +You can create any tiddler you want and tag it with the appropriate [[system tag|SystemTags]], and it will appear in that place. For example, if you create a tiddler 'Reminder to self', add the text 'This is a reminder' and tag it `$:/tags/EditTemplate`, the words 'This is a reminder' will appear inside every tiddler when you edit it. When you add new tiddlers to be displayed within tiddlers or within the page layout, you will also probably need to reposition it so that it appears precisely where you want it to appear. To do this, edit the appropriate shadow tiddler with the prefix `$:/tags/`, and insert the title of your tiddler in the proper place in the list field. For example, if you want the words 'This is a reminder' from the example above to appear above the tags editor in editing mode, edit the tiddler $:/tags/EditTemplate, go to the 'list' field, and insert `[[Reminder to self]]` right before `$:/core/ui/EditTemplate/tags`. \ No newline at end of file diff --git a/editions/tw5.com/tiddlers/community/TiddlyWiki Hangouts.tid b/editions/tw5.com/tiddlers/community/TiddlyWiki Hangouts.tid index 4a0f0b829..bf5806667 100644 --- a/editions/tw5.com/tiddlers/community/TiddlyWiki Hangouts.tid +++ b/editions/tw5.com/tiddlers/community/TiddlyWiki Hangouts.tid @@ -1,10 +1,10 @@ created: 20130823091700000 -modified: 20140912150339263 +modified: 20211124214214045 tags: Community Videos title: TiddlyWiki Hangouts type: text/vnd.tiddlywiki -The TiddlyWiki community holds regular Google Hangouts, usually every Tuesday from 4pm to 6pm (UK time). They are announced in the [[TiddlyWiki Google group|https://groups.google.com/d/forum/tiddlywiki]] and on the [[TiddlyWiki Twitter account|https://twitter.com/TiddlyWiki]]. +The TiddlyWiki community has held many Google Hangouts over the years. They are announced in the [[TiddlyWiki Google group|https://groups.google.com/d/forum/tiddlywiki]] and on the [[TiddlyWiki Twitter account|https://twitter.com/TiddlyWiki]]. Past Hangouts are archived in this ~YouTube playlist: diff --git a/editions/tw5.com/tiddlers/customising/Customise TiddlyWiki.tid b/editions/tw5.com/tiddlers/customising/Customise TiddlyWiki.tid index 3c1327366..a0bc138c2 100644 --- a/editions/tw5.com/tiddlers/customising/Customise TiddlyWiki.tid +++ b/editions/tw5.com/tiddlers/customising/Customise TiddlyWiki.tid @@ -1,6 +1,6 @@ created: 20140904101600000 -list: [[Adding a table of contents to the sidebar]] [[Configuring startup tiddlers]] [[Configuring the default TiddlerInfo tab]] [[Creating a custom export format]] [[Creating a splash screen]] [[Customising search results]] [[Hidden Settings]] [[How to add a new tab to the sidebar]] [[How to apply custom styles]] [[How to create keyboard shortcuts]] [[How to turn off camel case linking]] [[How to widen tiddlers (aka storyriver)]] [[Making a custom journal button]] [[Page and tiddler layout customisation]] [[Alternative page layouts]] [[Preserving open tiddlers at startup]] [[Setting a favicon]] [[Setting a page background image]] [[Using Stylesheets]] -modified: 20201123173044437 +list: [[Adding a table of contents to the sidebar]] [[Alternative page layouts]] [[Configuring startup tiddlers]] [[Configuring the default TiddlerInfo tab]] [[Creating a custom export format]] [[Creating a splash screen]] [[Customising search results]] [[Hidden Settings]] [[How to add a new tab to the sidebar]] [[How to apply custom styles]] [[How to create keyboard shortcuts]] [[How to turn off camel case linking]] [[How to widen tiddlers (aka storyriver)]] [[Making a custom journal button]] [[Page and tiddler layout customisation]] [[Preserving open tiddlers at startup]] [[Setting a favicon]] [[Setting a page background image]] [[Using Stylesheets]] +modified: 20211124215925621 tags: TableOfContents title: Customise TiddlyWiki type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/definitions/MathML.tid b/editions/tw5.com/tiddlers/definitions/MathML.tid index 7b350041b..99b179aaa 100644 --- a/editions/tw5.com/tiddlers/definitions/MathML.tid +++ b/editions/tw5.com/tiddlers/definitions/MathML.tid @@ -1,6 +1,6 @@ created: 20130901213100000 -modified: 20140919161635814 -tags: Definitions Features +modified: 20211124215351987 +tags: Definitions title: MathML type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/demonstrations/SampleAlert.tid b/editions/tw5.com/tiddlers/demonstrations/SampleAlert.tid deleted file mode 100644 index 4a316fb25..000000000 --- a/editions/tw5.com/tiddlers/demonstrations/SampleAlert.tid +++ /dev/null @@ -1,9 +0,0 @@ -component: demo -created: 20160107230134172 -modified: 20160107230134172 -title: SampleAlert -type: text/vnd.tiddlywiki - -This is a demonstration alert. - -Note that the trashcan icon deletes the tiddler containing this alert. You can also remove it by opening the tiddler SampleAlert and editing it to remove the tag [[$:/tags/Alert]]. diff --git a/editions/tw5.com/tiddlers/features/Scalability.tid b/editions/tw5.com/tiddlers/features/Scalability.tid index 8708affd2..0d275bd8d 100644 --- a/editions/tw5.com/tiddlers/features/Scalability.tid +++ b/editions/tw5.com/tiddlers/features/Scalability.tid @@ -1,7 +1,9 @@ created: 20130822173400000 -modified: 20140912145800365 +modified: 20211124215615812 tags: Features title: Scalability type: text/vnd.tiddlywiki -You might expect that TiddlyWiki's architecture as a SinglePageApplication would make it unsuitable for large amounts of data. In fact, TiddlyWiki users regularly work with files that are 20 or 30 megabytes without problems - and successful experiments have been done up into the gigabytes. \ No newline at end of file +You might expect that TiddlyWiki's architecture as a SinglePageApplication would make it unsuitable for large amounts of data. In fact, TiddlyWiki users regularly work with files that are tens or even over a hundred megabytes without problems - and successful experiments have been done up into the gigabytes. + +See [[performance tips|Performance]] for large wikis. \ No newline at end of file diff --git a/editions/tw5.com/tiddlers/platforms/TiddlyFox Apocalypse.tid b/editions/tw5.com/tiddlers/platforms/TiddlyFox Apocalypse.tid index 9cf4867d6..2c1c1c5fc 100644 --- a/editions/tw5.com/tiddlers/platforms/TiddlyFox Apocalypse.tid +++ b/editions/tw5.com/tiddlers/platforms/TiddlyFox Apocalypse.tid @@ -1,6 +1,6 @@ created: 20171109170823847 -modified: 20171113161750857 -tags: Platforms +modified: 20211124214943222 +tags: TiddlyFox title: TiddlyFox Apocalypse type: text/vnd.tiddlywiki diff --git a/editions/tw5.com/tiddlers/platforms/TiddlyWiki in the Sky for TiddlyWeb.tid b/editions/tw5.com/tiddlers/platforms/TiddlyWiki in the Sky for TiddlyWeb.tid index 5113aaa1c..67b01eb45 100644 --- a/editions/tw5.com/tiddlers/platforms/TiddlyWiki in the Sky for TiddlyWeb.tid +++ b/editions/tw5.com/tiddlers/platforms/TiddlyWiki in the Sky for TiddlyWeb.tid @@ -1,12 +1,7 @@ created: 20131129100250644 -modified: 20150412185535373 -tags: [[Hosting your TiddlyWiki on the web]] Platforms +modified: 20211124214855770 +tags: $:/deprecated title: TiddlyWiki in the Sky for TiddlyWeb type: text/vnd.tiddlywiki -TiddlyWiki in the Sky for TiddlyWeb allows content to be synchronised between TiddlyWiki running in the browser and a TiddlyWeb server. Features include: - -* Lazy loading -* Two way synchronisation between the browser and the server -** Synchronising from the server is accomplished by polling (currently every 60 seconds) -* Throttling so that rapidly changing tiddlers don't overwhelm the server +The term "TiddlyWiki in the Sky for TiddlyWeb" was used to refer to the ability for content to be synchronised between TiddlyWiki running in the browser and a TiddlyWeb server. This configuration should still work but is no longer commonly used. \ No newline at end of file From 6512b038c5de0e555837dd3b7f6e65da037468d6 Mon Sep 17 00:00:00 2001 From: btheado Date: Thu, 25 Nov 2021 13:03:30 -0500 Subject: [PATCH 2/3] Added examples to compare :map filter run prefix to + prefix (#6282) * Added examples to compare :map filter run prefix to + prefix * Prefer ':and' over '+' --- .../Map Filter Run Prefix (Examples).tid | 27 ++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/editions/tw5.com/tiddlers/filters/syntax/Map Filter Run Prefix (Examples).tid b/editions/tw5.com/tiddlers/filters/syntax/Map Filter Run Prefix (Examples).tid index b7ade6b38..008e5d0c5 100644 --- a/editions/tw5.com/tiddlers/filters/syntax/Map Filter Run Prefix (Examples).tid +++ b/editions/tw5.com/tiddlers/filters/syntax/Map Filter Run Prefix (Examples).tid @@ -1,5 +1,5 @@ created: 20210618134753828 -modified: 20210618140945870 +modified: 20211125152755859 tags: [[Filter Syntax]] [[Filter Run Prefix Examples]] [[Map Filter Run Prefix]] title: Map Filter Run Prefix (Examples) type: text/vnd.tiddlywiki @@ -14,3 +14,28 @@ Replace the input titles with the caption field if it exists, otherwise preserve For each title in a shopping list, calculate the total cost of purchasing each item: <<.operator-example 2 "[tag[shopping]] :map[get[quantity]else[0]multiply{!!price}]">> + +!! Comparison between `:map` and `:and`/`+` filter run prefixes + +The functionality of the `:map` filter run prefix has some overlap with the `:and` prefix (alias `+`). They will sometimes return the same results as each other. In at least these cases, the results will be different: + +# The `:and` filter run can modify the number of items (either increase or decrease). The `:map` run will never alter the number of items. +# The number of items in the `:and` filter run will also decrease due to de-duplication. The `:map` run will not de-duplicate. +# Explicit references to the "currentTiddler" variable will behave differently +# Implicit references to the "currentTiddler" using TextReference will behave differently. + +| `:map` | `:and` | +|!results are the same|<| +|^<<.operator-example 1.1 "[range[5]] :map[add[1]]">>|^<<.operator-example 1.2 "[range[5]] :and[add[1]]">>| +|^<<.operator-example 2.1 "[range[5]] :map[addsuffix[ hello]]">>|^<<.operator-example 2.2 "[range[5]] :and[addsuffix[ hello]]">>| +|^<<.operator-example 3.1 "[tag[shopping]] :map[get[quantity]]">>|^<<.operator-example 3.2 "[tag[shopping]] :and[get[quantity]]">>| +|!decrease in the number of items|<| +|^<<.operator-example 4.1 "[range[5]] :map[sum[]]">>|^<<.operator-example 4.2 "[range[5]] :and[sum[]]">>| +|^<<.operator-example 5.1 "[range[5]] :map[join[,]]">>|^<<.operator-example 5.2 "[range[5]] :and[join[,]]">>| +|!increase in the number of items|<| +|^<<.operator-example 6.1 "[[1,2,3]] [[4,5]] :map[split[,]]">>|^<<.operator-example 6.2 "[[1,2,3]] [[4,5]] :and[split[,]]">>| +|!de-duplication|<| +|^<<.operator-example 7.1 "[range[5]] :map[[hello]]">>|^<<.operator-example 7.2 "[range[5]] :and[[hello]]">>| +|!currentTiddler|<| +|^<<.operator-example 8.1 "[tag[shopping]] :map[]">>|^<<.operator-example 8.2 "[tag[shopping]] :and[]">>| +|^<<.operator-example 9.1 "[tag[shopping]] :map[{!!quantity}]">>|^<<.operator-example 9.2 "[tag[shopping]] :and[{!!quantity}]">>| From b80d079d71ae9d72e53e8103ee0f6e40091ccb01 Mon Sep 17 00:00:00 2001 From: "jeremy@jermolene.com" Date: Fri, 26 Nov 2021 11:18:03 +0000 Subject: [PATCH 3/3] Move docs tiddlers out of the root folder Some of which I'd accidentally left from 1348607c8fb6ceee7e6ce80cdc25449e1ea45eea, but I thought it was worth clearing them all up --- editions/tw5.com/tiddlers/$__StoryList.tid | 6 +++--- editions/tw5.com/tiddlers/{ => about}/License.tid | 0 .../Adding custom-made tiddlers to the user interface.tid | 0 ...ng new buttons for the ViewToolbar and page controls.tid | 0 .../Removing shadow tiddlers from the user interface.tid | 0 editions/tw5.com/tiddlers/{ => hellothere}/AllTiddlers.tid | 0 editions/tw5.com/tiddlers/{ => images}/Icon Gallery.tid | 0 editions/tw5.com/tiddlers/{ => system}/TableOfContents.tid | 0 editions/tw5.com/tiddlers/{ => widgets}/Keyboard Codes.tid | 0 .../tiddlers/{ => widgets}/MessageHandlerWidgets.tid | 0 .../tw5.com/tiddlers/{ => widgets}/TriggeringWidgets.tid | 0 11 files changed, 3 insertions(+), 3 deletions(-) rename editions/tw5.com/tiddlers/{ => about}/License.tid (100%) rename editions/tw5.com/tiddlers/{ => customising}/Adding custom-made tiddlers to the user interface.tid (100%) rename editions/tw5.com/tiddlers/{ => customising}/Creating new buttons for the ViewToolbar and page controls.tid (100%) rename editions/tw5.com/tiddlers/{ => customising}/Removing shadow tiddlers from the user interface.tid (100%) rename editions/tw5.com/tiddlers/{ => hellothere}/AllTiddlers.tid (100%) rename editions/tw5.com/tiddlers/{ => images}/Icon Gallery.tid (100%) rename editions/tw5.com/tiddlers/{ => system}/TableOfContents.tid (100%) rename editions/tw5.com/tiddlers/{ => widgets}/Keyboard Codes.tid (100%) rename editions/tw5.com/tiddlers/{ => widgets}/MessageHandlerWidgets.tid (100%) rename editions/tw5.com/tiddlers/{ => widgets}/TriggeringWidgets.tid (100%) diff --git a/editions/tw5.com/tiddlers/$__StoryList.tid b/editions/tw5.com/tiddlers/$__StoryList.tid index f21633f4a..5528728b6 100644 --- a/editions/tw5.com/tiddlers/$__StoryList.tid +++ b/editions/tw5.com/tiddlers/$__StoryList.tid @@ -1,5 +1,5 @@ -created: 20210322152203906 -list: [[Documentation Macros]] HelloThere GettingStarted Community -modified: 20210322152237613 +created: 20211126104006194 +list: [[Page and tiddler layout customisation]] [[Creating new buttons for the ViewToolbar and page controls]] [[Structuring TiddlyWiki]] Tagging [[Introduction to Lists]] [[Icon Gallery]] [[How to widen tiddlers (aka storyriver)]] [[How to turn off camel case linking]] [[How to put the last modification date in a banner]] [[How to hide the author's and other fields with CSS]] [[How to export tiddlers]] [[How to Customize TiddlyDesktop]] [[Editing Tiddlers with Vim]] [[Concatenating text and variables using macro substitution]] [[Demonstration: keyboard-driven-input Macro]] HelloThere GettingStarted Community +modified: 20211126111221917 title: $:/StoryList type: text/vnd.tiddlywiki \ No newline at end of file diff --git a/editions/tw5.com/tiddlers/License.tid b/editions/tw5.com/tiddlers/about/License.tid similarity index 100% rename from editions/tw5.com/tiddlers/License.tid rename to editions/tw5.com/tiddlers/about/License.tid diff --git a/editions/tw5.com/tiddlers/Adding custom-made tiddlers to the user interface.tid b/editions/tw5.com/tiddlers/customising/Adding custom-made tiddlers to the user interface.tid similarity index 100% rename from editions/tw5.com/tiddlers/Adding custom-made tiddlers to the user interface.tid rename to editions/tw5.com/tiddlers/customising/Adding custom-made tiddlers to the user interface.tid diff --git a/editions/tw5.com/tiddlers/Creating new buttons for the ViewToolbar and page controls.tid b/editions/tw5.com/tiddlers/customising/Creating new buttons for the ViewToolbar and page controls.tid similarity index 100% rename from editions/tw5.com/tiddlers/Creating new buttons for the ViewToolbar and page controls.tid rename to editions/tw5.com/tiddlers/customising/Creating new buttons for the ViewToolbar and page controls.tid diff --git a/editions/tw5.com/tiddlers/Removing shadow tiddlers from the user interface.tid b/editions/tw5.com/tiddlers/customising/Removing shadow tiddlers from the user interface.tid similarity index 100% rename from editions/tw5.com/tiddlers/Removing shadow tiddlers from the user interface.tid rename to editions/tw5.com/tiddlers/customising/Removing shadow tiddlers from the user interface.tid diff --git a/editions/tw5.com/tiddlers/AllTiddlers.tid b/editions/tw5.com/tiddlers/hellothere/AllTiddlers.tid similarity index 100% rename from editions/tw5.com/tiddlers/AllTiddlers.tid rename to editions/tw5.com/tiddlers/hellothere/AllTiddlers.tid diff --git a/editions/tw5.com/tiddlers/Icon Gallery.tid b/editions/tw5.com/tiddlers/images/Icon Gallery.tid similarity index 100% rename from editions/tw5.com/tiddlers/Icon Gallery.tid rename to editions/tw5.com/tiddlers/images/Icon Gallery.tid diff --git a/editions/tw5.com/tiddlers/TableOfContents.tid b/editions/tw5.com/tiddlers/system/TableOfContents.tid similarity index 100% rename from editions/tw5.com/tiddlers/TableOfContents.tid rename to editions/tw5.com/tiddlers/system/TableOfContents.tid diff --git a/editions/tw5.com/tiddlers/Keyboard Codes.tid b/editions/tw5.com/tiddlers/widgets/Keyboard Codes.tid similarity index 100% rename from editions/tw5.com/tiddlers/Keyboard Codes.tid rename to editions/tw5.com/tiddlers/widgets/Keyboard Codes.tid diff --git a/editions/tw5.com/tiddlers/MessageHandlerWidgets.tid b/editions/tw5.com/tiddlers/widgets/MessageHandlerWidgets.tid similarity index 100% rename from editions/tw5.com/tiddlers/MessageHandlerWidgets.tid rename to editions/tw5.com/tiddlers/widgets/MessageHandlerWidgets.tid diff --git a/editions/tw5.com/tiddlers/TriggeringWidgets.tid b/editions/tw5.com/tiddlers/widgets/TriggeringWidgets.tid similarity index 100% rename from editions/tw5.com/tiddlers/TriggeringWidgets.tid rename to editions/tw5.com/tiddlers/widgets/TriggeringWidgets.tid