1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-11-23 18:17:20 +00:00

Update filter docs

This commit is contained in:
Jermolene 2014-09-10 23:42:13 +01:00
parent f72bb66f6a
commit def4aca200
73 changed files with 139 additions and 96 deletions

View File

@ -1,7 +1,7 @@
title: $:/language/Search/
Filter/Caption: Filter
Filter/Hint: Search via a [[filter expression|http://tiddlywiki.com/static/TiddlerFilters.html]]
Filter/Hint: Search via a [[filter expression|http://tiddlywiki.com/static/Filters.html]]
Filter/Matches: //<small><$count filter={{$:/temp/advancedsearch}}/> matches</small>//
Matches: //<small><$count filter="[!is[system]search{$:/temp/search}]"/> matches</small>//
Shadows/Caption: Shadows

View File

@ -1,7 +1,7 @@
created: 20130827080000000
modified: 20140410103123179
tags: concepts
title: TiddlerFilters
tags: Reference concepts
title: Filters
type: text/vnd.tiddlywiki
\define bulletList(filter)
@ -10,10 +10,10 @@ type: text/vnd.tiddlywiki
Filters are used in TiddlyWiki to choose tiddlers by specifying simple match criteria. They are used by widgets like the ListWidget and the CountWidget to perform operations on multiple tiddlers at once.
* [[Introduction to Filters]] is a step-by-step introduction to how filters are used
* [[TiddlerFilter Formal Grammar]] is a technical explanation of the filter syntax.
* [[Filter Formal Grammar]] is a technical explanation of the filter syntax.
The most common filter operators are:
<<bulletList "[tag[commonfilters]]">>
<<bulletList "[tag[CommonFilters]]">>
See FilterOperators gives a complete list of available filter operators
See FilterOperators for a complete list of available filter operators

View File

@ -20,7 +20,7 @@ Note that double square brackets are not required around the target tiddler titl
! Story Permalinks
The permalink can also specify the story list of tiddlers that should be opened alongside the target tiddler as a [[TiddlerFilter|TiddlerFilters]]:
The permalink can also specify the story list of tiddlers that should be opened alongside the target tiddler as a [[TiddlerFilter|Filters]]:
[[http://tiddlywiki.com/#TiddlerFields:Tiddlers TiddlerTags TiddlerFields ContentType]]

View File

@ -1,6 +1,8 @@
created: 20140910215514237
modified: 20140910215514237
tags: concepts Reference
title: Plugins
tags: concepts [[Advanced features]]
modified: 201308091623
type: text/vnd.tiddlywiki
A plugin in TiddlyWiki5 is a bundle of tiddlers packaged together as a single tiddler. Plugins are used to distribute optional, custom components for TiddlyWiki.

View File

@ -14,7 +14,7 @@ Text references are made up of several parts, most of which can be optional:
Text references can be used in several places:
* As IndirectOperands within TiddlerFilters (eg, `<$list filter="[tag{MyTag!!name}]"/>`)
* As IndirectOperands within [[Filters]] (eg, `<$list filter="[tag{MyTag!!name}]"/>`)
* As IndirectAttributes of an element or widget (eg, `<$widget attrib={{Title!!description}}/>`)
* As the operand of a shortcut transclusion (eg, `{{MyTiddler!!title}}`)
* As the `state` attribute of the RevealWidget and the LinkCatcherWidget

View File

@ -12,7 +12,7 @@ Links are useful for modelling organic relationships between tiddlers, and parti
The TiddlerInfoPanel lists incoming links to a tiddler in the tab ''References''.
TiddlerFilters can include the following [[filter operators|TiddlerFilters]] that work with links:
[[Filters]] can include the following filter operators that work with links:
* `[links[]]` - returns the titles of the tiddlers that are linked from the currently selected tiddler(s)
* `[backlinks[]]` - returns the titles of the tiddlers that link to the currently selected tiddler(s)

View File

@ -7,6 +7,6 @@ type: text/vnd.tiddlywiki
The `list` [[field of a tiddler|TiddlerFields]] is an optional feature that can be used to help structure your content. It is defined as an ordered sequence of tiddler titles, and it can be used in several ways:
* The `list` field of a tiddler that is being used as a tag determines the ordering of the tiddlers that carry that tag - see TiddlerTags for details
* The `list` [[filter|TiddlerFilters]] selects the entries from a list
* The `listed` [[filter|TiddlerFilters]] selects the tiddlers that list the selected tiddler(s)
* The `list` [[filter|Filters]] selects the entries from a list
* The `listed` [[filter|Filters]] selects the tiddlers that list the selected tiddler(s)
* The NavigatorWidget manipulates a StoryList tiddler containing a `list` field of the tiddlers that are displayed in the main story column

View File

@ -1,7 +1,8 @@
created: 20140512103123179
modified: 20140512103123179
tags: filters
tags: Filters
title: FilterOperator: after
caption: after
type: text/vnd.tiddlywiki
The ''after'' filter operator returns the tiddler from the current list that is after the tiddler named in the operand.

View File

@ -1,7 +1,8 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters commonfilters
tags: Filters CommonFilters
title: FilterOperator: all
caption: all
type: text/vnd.tiddlywiki
The ''all'' filter operator is used to select combinations of lists of tiddlers for subsequent operations.

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: backlinks
title: FilterOperator: backlinks
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140512103123179
modified: 20140512103123179
tags: filters
tags: Filters
caption: before
title: FilterOperator: before
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: bf
title: FilterOperator: bf
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: butfirst
title: FilterOperator: butfirst
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: butlast
title: FilterOperator: butlast
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: commands
title: FilterOperator: commands
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: each
title: FilterOperator: each
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: eachday
title: FilterOperator: eachday
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters commonfilters
tags: Filters CommonFilters
caption: field
title: FilterOperator: field
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: first
title: FilterOperator: first
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140426183123179
modified: 20140426183123179
tags: filters
tags: Filters
caption: get
title: FilterOperator: get
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters commonfilters
tags: Filters CommonFilters
caption: has
title: FilterOperator: has
type: text/vnd.tiddlywiki

View File

@ -1,7 +1,8 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
title: FilterOperator: indexes
caption: indexes
type: text/vnd.tiddlywiki
The ''indexes'' filter operator returns a list of all the property indexes found in the DataTiddlers in the current list. Tiddlers that are not DataTiddlers are ignored.

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140418103123179
tags: filters commonfilters
tags: Filters CommonFilters
caption: is
title: FilterOperator: is
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: last
title: FilterOperator: last
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters commonfilters
tags: Filters CommonFilters
caption: limit
title: FilterOperator: limit
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters commonfilters
tags: Filters CommonFilters
caption: links
title: FilterOperator: links
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: list
title: FilterOperator: list
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140613103123179
tags: filters
tags: Filters
caption: listed
title: FilterOperator: listed
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: modules
title: FilterOperator: modules
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: moduletypes
title: FilterOperator: moduletypes
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: next
title: FilterOperator: next
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: nsort
title: FilterOperator: nsort
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: nsortcs
title: FilterOperator: nsortcs
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: nth
title: FilterOperator: nth
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: plugintiddlers
title: FilterOperator: plugintiddlers
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: prefix
title: FilterOperator: prefix
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: previous
title: FilterOperator: previous
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140909134102102
modified: 20140909134102102
tags: filters
tags: Filters
caption: regexp
title: FilterOperator: regexp
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: removeprefix
title: FilterOperator: removeprefix
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140828133830424
modified: 20140902145613329
tags: filters
tags: Filters
caption: removesuffix
title: FilterOperator: removesuffix
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: rest
title: FilterOperator: rest
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: reverse
title: FilterOperator: reverse
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
caption: sameday
title: FilterOperator: sameday
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,7 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters commonfilters
tags: Filters CommonFilters
caption: search
title: FilterOperator: search
type: text/vnd.tiddlywiki

View File

@ -1,7 +1,8 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
title: FilterOperator: shadowsource
caption: shadowsource
type: text/vnd.tiddlywiki
The ''shadowsource'' filter operator returns the titles of the plugin tiddlers containing any ShadowTiddlers in the current list.

View File

@ -1,7 +1,8 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters commonfilters
tags: Filters CommonFilters
title: FilterOperator: sort
caption: sort
type: text/vnd.tiddlywiki
The ''sort'' filter operator sorts the current list case insensitively (upper and lower case letters are considered equivalent), along the field specified in the operand (which defaults to `title`). Preceding the operator with `!` reverses the sort order.

View File

@ -1,7 +1,8 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
title: FilterOperator: sortcs
caption: sortcs
type: text/vnd.tiddlywiki
The ''sortcs'' filter operator sorts the current list case sensitively (upper and lower case letters are considered different), along the field specified in the operand (which defaults to `title`). Preceding the operator with `!` reverses the sort order.

View File

@ -1,7 +1,8 @@
created: 20140828133830424
modified: 20140828133830424
tags: filters
tags: Filters
title: FilterOperator: suffix
caption: suffix
type: text/vnd.tiddlywiki
The ''suffix'' filter operator returns the titles in the current list that end with a specified suffix. If the ''suffix'' operator is preceded by `!` then it returns the titles that do not end with the specified suffix.

View File

@ -1,7 +1,8 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters commonfilters
tags: Filters CommonFilters
title: FilterOperator: tag
caption: tag
type: text/vnd.tiddlywiki
The ''tag'' filter operator returns the tiddlers in the current list that have the tag specified in the operand. Preceding the operator with `!` returns tiddlers that do not have the specified tag.

View File

@ -1,7 +1,8 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
title: FilterOperator: tagging
caption: tagging
type: text/vnd.tiddlywiki
The ''tagging'' filter operator returns all the tiddlers that are tagged by the tiddlers in the current list.

View File

@ -1,7 +1,8 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
title: FilterOperator: tags
caption: tags
type: text/vnd.tiddlywiki
The ''tags'' filter operator returns all the tags present on the tiddlers in the current list.

View File

@ -1,7 +1,8 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
title: FilterOperator: title
caption: title
type: text/vnd.tiddlywiki
The ''title'' filter operator replaces the current list with the title specified in the operand.

View File

@ -1,7 +1,8 @@
created: 20140410103123179
modified: 20140410103123179
tags: filters
tags: Filters
title: FilterOperator: untagged
caption: untagged
type: text/vnd.tiddlywiki
The ''untagged'' filter operator selects from the current list any tiddlers that do not have any tags.

View File

@ -4,7 +4,7 @@ tags: introduction
title: Introduction to Filters
type: text/vnd.tiddlywiki
A step by step introduction to how TiddlerFilters are used.
A step by step introduction to how [[Filters]] are used.
You can experiment with tiddler filters by typing them into the "Filter" tab of the [[advanced search panel|$:/AdvancedSearch]].
@ -28,7 +28,7 @@ Filter operators are used to select tiddlers based on some criteria. For example
The word "tag" is the ''operator'' and "introduction" is the ''operand''.
See TiddlerFilters for a complete list of the available operators.
See [[Filters]] for a complete list of the available operators.
!! Default Filter Operator

View File

@ -1,6 +1,6 @@
created: 20131228162825226
modified: 20131228163922307
tags: macros Macros
tags: Macros
title: ChangeCountMacro
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,6 @@
created: 20140908104107181
modified: 20140908104107181
tags: macros Macros
tags: Macros
title: DumpVariablesMacro
type: text/vnd.tiddlywiki

View File

@ -1,6 +1,6 @@
created: 20131228163141555
modified: 20131228163843163
tags: macros Macros
tags: Macros
title: MakeDataUriMacro
type: text/vnd.tiddlywiki

View File

@ -1,10 +1,10 @@
created: 20140210141217955
modified: 20140909134102102
tags: dev
title: TiddlerFilter Formal Grammar
title: Filter Formal Grammar
type: text/vnd.tiddlywiki
TiddlerFilters follow a formal grammar that is presented here for users who are familiar with the notation. It isn't necessary to understand this grammar in order to write your own filter expressions.
[[Filters]] follow a formal grammar that is presented here for users who are familiar with the notation. It isn't necessary to understand this grammar in order to write your own filter expressions.
''&lt;filter-string&gt;'' ::= ''&lt;opt-whitespaces&gt;'' ''&lt;filter-operand&gt;'' | ''&lt;opt-whitespaces&gt;'' ''&lt;filter-operand&gt;'' ''&lt;filter-string&gt;''

View File

@ -1,5 +1,7 @@
created: 20140908141500000
modified: 20140910215622727
tags: Reference
title: Bookmarklets
tags: [[Advanced features]]
toc-link: no
created: 201409081415
modified: 201409081415
type: text/vnd.tiddlywiki

View File

@ -1,5 +1,7 @@
created: 20140908141300000
modified: 20140910215613444
tags: Reference
title: Editions
tags: [[Advanced features]]
created: 201409081413
modified: 201409081413
toc-link: no
type: text/vnd.tiddlywiki

View File

@ -1,5 +0,0 @@
title: Filters
tags: [[Advanced features]]
toc-link: no
created: 201409081307
modified: 201409081307

View File

@ -1,5 +1,7 @@
created: 20140908130500000
modified: 20140910215453457
tags: Reference
title: Widgets
tags: [[Advanced features]]
toc-link: no
created: 201409081305
modified: 201409081305
type: text/vnd.tiddlywiki

View File

@ -1,6 +0,0 @@
title: Advanced features
tags: TableOfContents
toc-link: no
created: 201409041030
modified: 201409041030

View File

@ -5,7 +5,7 @@ tags: widget
! Introduction
The count widget displays the number of matches to a specified [[filter expression|TiddlerFilters]].
The count widget displays the number of matches to a specified [[filter expression|Filters]].
! Content and Attributes

View File

@ -19,7 +19,7 @@ All the macros defined in tiddlers with the tag "mySpecialMacros" are available
The content of the importvariables widget is the scope within which the imported variable definitions are available.
|!Attribute |!Description |
|filter |[[Tiddler filter|TiddlerFilters]] defining the tiddlers from which macro definitions will be imported |
|filter |[[Tiddler filter|Filters]] defining the tiddlers from which macro definitions will be imported |
! Global Macros

View File

@ -5,7 +5,7 @@ title: ListWidget
! Introduction
The list widget displays a sequence of tiddlers that match a [[tiddler filter|TiddlerFilters]]. It can be used for many purposes:
The list widget displays a sequence of tiddlers that match a [[tiddler filter|Filters]]. It can be used for many purposes:
* Displaying custom lists of links, like in TiddlyWiki5's sidebar
* Custom lists, such as "all tiddlers tagged 'task' that are not tagged 'done'"

View File

@ -17,7 +17,7 @@ You can also use a TextReference instead of a tiddler title:
* `{{MyTiddler##index}}` transcludes a specified indexed property of a [[DataTiddler|DataTiddlers]]
* `{{##index}}` transcludes a specified indexed property of the current [[DataTiddler|DataTiddlers]]
A similar syntax can be used to transclude a list of tiddlers matching a specified [[TiddlerFilter|TiddlerFilters]]:
A similar syntax can be used to transclude a list of tiddlers matching a specified [[filter|Filters]]:
```
{{{ [tag[mechanism]] }}}

View File

@ -1,7 +1,7 @@
title: $:/language/Search/
Filter/Caption: Filter
Filter/Hint: Suche mit [["filter expression"|http://tiddlywiki.com/static/TiddlerFilters.html]].
Filter/Hint: Suche mit [["filter expression"|http://tiddlywiki.com/static/Filters.html]].
Filter/Matches: //<small><$count filter="[!is[system]search{$:/temp/search}]"/> Treffer</small>//
Matches: //<small><$count filter="[!is[system]search{$:/temp/search}]"/> Treffer</small>//
Shadows/Caption: Schatten

View File

@ -1,7 +1,7 @@
title: $:/language/Search/
Filter/Caption: Filtres
Filter/Hint: Recherche via une combinaison de [[filtres|http://tiddlywiki.com/static/TiddlerFilters.html]]
Filter/Hint: Recherche via une combinaison de [[filtres|http://tiddlywiki.com/static/Filters.html]]
Filter/Matches: //<small><$count filter={{$:/temp/advancedsearch}}/> correspondances</small>//
Matches: //<small><$count filter="[!is[system]search{$:/temp/search}]"/> correspondances</small>//
Shadows/Caption: Shadows

View File

@ -2,7 +2,7 @@ title: $:/language/Search/
Advanced/Matches: //<small><$count filter={{$:/temp/advancedsearch}}/> Corrispondenze</small>//
Filter/Caption: Filtro
Filter/Hint: Cerca attraverso un [[filtro|http://tiddlywiki.com/static/TiddlerFilters.html]]
Filter/Hint: Cerca attraverso un [[filtro|http://tiddlywiki.com/static/Filters.html]]
Matches: //<small><$count filter="[!is[system]search{$:/temp/search}]"/> Corrispondenze</small>//
Shadows/Caption: Nascosti
Shadows/Hint: Cerca frammenti nascosti

View File

@ -2,7 +2,7 @@ title: $:/language/Search/
Advanced/Matches: //<small><$count filter={{$:/temp/advancedsearch}}/> 件の一致</small>//
Filter/Caption: フィルター
Filter/Hint: [[フィルタの書式|http://tiddlywiki.com/static/TiddlerFilters.html]] を参照
Filter/Hint: [[フィルタの書式|http://tiddlywiki.com/static/Filters.html]] を参照
Matches: //<small><$count filter="[!is[system]search{$:/temp/search}]"/> 件の一致</small>//
Shadows/Caption: 隠し
Shadows/Hint: 隠し tiddler を検索

View File

@ -1,7 +1,7 @@
title: $:/language/Search/
Filter/Caption: 筛选
Filter/Hint: 以[[筛选表达式|http://tiddlywiki.com/static/TiddlerFilters.html]]查找
Filter/Hint: 以[[筛选表达式|http://tiddlywiki.com/static/Filters.html]]查找
Filter/Matches: //<small><$count filter={{$:/temp/advancedsearch}}/> 个条目符合条件</small>//
Matches: //<small><$count filter="[!is[system]search{$:/temp/search}]"/> 个条目符合条件</small>//
Shadows/Caption: 默认

View File

@ -1,7 +1,7 @@
title: $:/language/Search/
Filter/Caption: 篩選
Filter/Hint: 以[[篩選表達式|http://tiddlywiki.com/static/TiddlerFilters.html]]搜尋
Filter/Hint: 以[[篩選表達式|http://tiddlywiki.com/static/Filters.html]]搜尋
Filter/Matches: //<small><$count filter={{$:/temp/advancedsearch}}/> 個條目符合條件</small>//
Matches: //<small><$count filter="[!is[system]search{$:/temp/search}]"/> 個條目符合條件</small>//
Shadows/Caption: 預設