| purpose | insert an item T into a list immediately after an item A |
|---|---|
| input | a selection of titles |
| suffix | (optional) the name of a variable containing the title of the tiddler after which this one should be inserted |
| parameter | the insertafter operator accepts 1 or 2 parameters, see below for details |
| output | the input tiddler list with the new entry inserted |
Learn more about how to use Filters
The insertafter operator requires at least one parameter which specifies the title to insert into the input list. A second parameter can be used to specify the title after which the new title should be inserted.
A suffix can also be used to specify A, the title after which the new title should be inserted, but this form is deprecated. Instead, the two-parameter form is recommended. If the two-parameter form is used, the suffixes start and end can be used to specify where the item should be inserted if A is not found.
insertafter:<after-title-variable>[<title>]
insertafter:<missing-location>[<title>],[<after-title>]- title : a title
Tto insert in the input list. - after-title : (optional). Insert
Tafter this titleAin the input list. - after-title-variable : (optional). The name of a variable specifying
Ainstead of theafter-titleparameter. - missing-location : (optional). Either
startorend: where to insertTifAis not found in the list.
If the item A isn't present in the input list then the new item is inserted at the end of the list. Introduced in v5.2.3 The suffixes start and end can be spedified to control where the new item is inserted when A is not found. The suffix end is the default, inserting the new item at the end of the list. The suffix start will cause the new item to be inserted at the start of the list when A is not found.