mirrors/TiddlyWiki5
1
0
Fork 0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2025-08-07 14:23:53 +00:00
Code Issues Releases Wiki Activity

Improve Filters doc and add "Learn more about how to use Filters" link to every operator reference tiddler (#6533)

Browse Source
This commit is contained in:
Mario Pietsch 2022-03-16 13:38:49 +01:00 committed by GitHub
parent 347355128b
commit 22fd1ca630
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 20 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
editions/tw5.com/tiddlers/concepts/Filters.tid
View File

@ -1,23 +1,27 @@
created: 20130827080000000 created: 20130827080000000
modified: 20150221225414000 list: [[Introduction to filter notation]] [[Filter Syntax]]
modified: 20220316120141494
tags: Reference Concepts tags: Reference Concepts
title: Filters title: Filters
type: text/vnd.tiddlywiki type: text/vnd.tiddlywiki
list: [[Introduction to filter notation]] [[Filter Syntax]]
\define openAdvancedSearch()
<$action-setfield $tiddler="$:/state/tab--1498284803" text="$:/core/ui/AdvancedSearch/Filter"/>
<$action-setfield $tiddler="$:/temp/advancedsearch/input" text="[tag[Filters]]"/>
\end
You can think of TiddlyWiki as a database in which the records are tiddlers. A database typically provides a way of discovering which records match a given pattern, and in ~TiddlyWiki this is done with filters. You can think of TiddlyWiki as a database in which the records are tiddlers. A database typically provides a way of discovering which records match a given pattern, and in ~TiddlyWiki this is done with filters.
A <<.def filter>> is a concise notation for selecting a particular [[set of tiddlers|Title Selection]], known as its <<.def "output">>. Whenever ~TiddlyWiki encounters a filter, it calculates the output. Further work can then be done with just those tiddlers, such as [[counting|CountWidget]] or [[listing|ListWidget]] them. A <<.def filter>> is a concise notation for selecting a particular [[set of tiddlers|Title Selection]], known as its <<.def "output">>. Whenever ~TiddlyWiki encounters a filter, it calculates the output. Further work can then be done with just those tiddlers, such as [[counting|CountWidget]] or [[listing|ListWidget]] them.
The following example passes a filter to the <<.mlink list-links>> macro to display a list of all tiddlers whose titles start with the letter H: The following example passes a filter to the <<.mlink list-links>> macro to display a list of all tiddlers whose titles are <<.olink2 tagged tag>> with the word <<.word Filters>>:
> `<<list-links "[prefix[H]]">>` <<wikitext-example-without-html """<<list-links "[tag[Filters]]">>""" >>
A filter's output can change as tiddlers are added and deleted in the wiki. ~TiddlyWiki recalculates on the fly, automatically updating any filter-based counts or lists as well. A filter output can change as tiddlers are added and deleted in the wiki. ~TiddlyWiki recalculates on the fly, automatically updating any filter-based counts or lists as well.
[[Advanced Search|$:/AdvancedSearch]] has a <<.advancedsearch-tab Filter>> tab that makes it easy to experiment with filters. ''Find out more:''
;Find out more: * <$linkcatcher message="tm-navigate" actions=<<openAdvancedSearch>> >[[Advanced Search|$:/AdvancedSearch]]</$linkcatcher> -- has a <<.advancedsearch-tab Filter>> tab that makes it easy to experiment with filters.
* [[Introduction to filter notation]] -- a step-by-step walkthrough
* [[Filter Syntax]] -- the detailed technical rules * [[Filtered Transclusions|Transclusion in WikiText]] -- If you want to use filter results in your text
* [[Filter Operators]] -- the available methods of filtering

9
editions/tw5.com/tiddlers/system/operator-template.tid
View File

@ -1,8 +1,8 @@
created: 20150203173506000 created: 20150203173506000
modified: 20150203181725000
title: $:/editions/tw5.com/operator-template
tags: $:/tags/ViewTemplate
list-before: $:/core/ui/ViewTemplate/body list-before: $:/core/ui/ViewTemplate/body
modified: 20220316121232243
tags: $:/tags/ViewTemplate
title: $:/editions/tw5.com/operator-template
\define .op-place() \define .op-place()
<$macrocall $name=".if" <$macrocall $name=".if"
@ -71,6 +71,9 @@ list-before: $:/core/ui/ViewTemplate/body
</$set> </$set>
<!-- --> <!-- -->
</table> </table>
[[Learn more about how to use Filters|Filters]]
<$list filter="[all[current]has[from-version]]" variable="listItem"> <$list filter="[all[current]has[from-version]]" variable="listItem">
<$macrocall $name=".from-version" version={{!!from-version}}/> <$macrocall $name=".from-version" version={{!!from-version}}/>
</$list> </$list>