Add some warnings about the dangers of title lists

This commit is contained in:
jeremy@jermolene.com 2022-05-23 08:56:10 +01:00
parent 96cb66a27e
commit 9e3c233686
3 changed files with 10 additions and 3 deletions

View File

@ -1,7 +1,8 @@
created: 20150117152418000
modified: 20150124205659000
modified: 20220523075540462
tags: Concepts
title: Title List
type: text/vnd.tiddlywiki
A <<.def "title list">> is a line of text that presents one or more tiddler titles, strung together with a space between each one and the next.
@ -12,3 +13,5 @@ If a title <<.em contains>> a space, it needs double square brackets around it:
Title lists are used in various places, including PermaLinks and the ListField.
They are in fact the simplest case of a [[filter|Filters]], and are thus a way of expressing a [[selection of titles|Title Selection]].
<<.warning """The [[Title List]] format cannot reliably represent items that contain certain specific character sequences such as `]] `. Thus it should not be used where there is a possibility of such sequences occurring.""">>

View File

@ -1,6 +1,6 @@
caption: format
created: 20201020100834443
modified: 20210524090002126
modified: 20220523075550449
op-input: a [[selection of titles|Title Selection]]
op-output: input strings formatted according to the specified suffix <<.place B>>
op-parameter: optional format string for the formats
@ -21,4 +21,6 @@ The suffix <<.place B>> is one of the following supported string formats:
|^`relativedate` |The input string is interpreted as a UTC date and displayed as the interval from the present instant. Any operator parameters are ignored. |
|^`titlelist` |<<.from-version "5.2.0">>The input string wrapped in double square brackets if it contains a space. Appropriate for use in a [[title list|Title List]]. |
<<.warning """The [[Title List]] format cannot reliably represent items that contain certain specific character sequences such as `]] `. Thus it should not be used where there is a possibility of such sequences occurring.""">>
<<.operator-examples "format">>

View File

@ -1,6 +1,6 @@
caption: set
created: 20131115182700000
modified: 20210505095640228
modified: 20220523075522407
tags: Widgets
title: SetWidget
type: text/vnd.tiddlywiki
@ -71,6 +71,8 @@ src="""<$set name="myVariable" filter="[all[current]field:title[myMagicTitle]]"
This form of the set variable widget evaluates the filter and assigns the result to the variable as a space-separated list (using double square brackets for titles containing spaces).
<<.warning """The [[Title List]] format cannot reliably represent items that contain certain specific character sequences such as `]] `. Thus it should not be used where there is a possibility of such sequences occurring.""">>
<<<
<$macrocall $name='wikitext-example-without-html'