TiddlyWiki Filter Expression：釋放 TiddlyWiki 十倍威力的工具

個人學習 TiddlyWiki 時，一個比較花時間去學習的是 Filter Expression。一旦學會了即使一點也好，也能為 TiddlyWiki 解封了十倍以上的威力。在這篇裡將會介紹什麼是 Filter Expression、Filter Expression 能做什麼、以及基本的語法和例子。

• 什麼是 Filter Expression，以及 Filter Expression 能做什麼？
• Filter Expression 的基本的語法是？
• Filter Expression 有甚麼基本和進階的應用？

> 什麼是 Filter Expression，以及Filter Expression 能做什麼？

Filter Expression 的的一個常見用途是用作找出符合條件的 tiddler 們，並在 tiddler 上展示。

Filter Expression 本身只是一個字串。例如是 [tag[Today]field:caption[hello]] 這樣。我們可以利用 Filter Expression 來找出符合條件的 tiddler 們（List of tiddler）。

例如最基本的例子是找出所有有某個 Tag 的 tiddler [tag[Today]]、找出所有標題含有某個字的 tiddler [regexp:title[Journal]] 、或者複雜一點是找出所有有某個 Tag 的 tiddler 並且標題含有某個字的 tiddler 等[tag[journal_2020]regexp:title[Journal]]。

那麼我們找出這些符會條件的 tiddler 來做什麼？例如我們可以在一個 tiddler 裡加入一個 list widget，而當我們把這句 Filter expression 放入這個 list widget 後，這個 tiddler 便會把所有符合這個條件的 tiddler 都展示出來，這對於我們管理和處理 tiddler 時十分有用。

一個常見例子就是用作 TODO List。我們可以把所有 tag 上 task 的 tiddler 展示出來，並在旁邊加上一個 check box。我們可以設定一旦該 check box 被打勾，這個 tiddler 的 tag 便會由 task 變成了 done，所以再也不會在這個 TODO List 上出現了。關於這個用途官網有一個 詳細的例子。

當然，實際上 Filter Expression 能做到的東西可以遠比剛才的例子強大得多。例如假設你把tiddler 們tag 上日子，而這個日子的格式例如是 20200716 Journal (Week 29 Thu)，我們甚至能找出所有Week 29 的 tiddler。

也因此，Filter Expression 的語法相對上比較複雜。以下會稍微介紹一下基本語法。

> 基本的語法

我們以以下的這句 filter expression 作為例子來介紹：

[tag[task]regexp:title[Blog]] -[regexp:title[omni]] +[tagging[]] ="Additional Tiddler" 

首先，一句 Filter Expression 裡是由一個或多於一個的 run 所組成（由 “ “ 所分隔）。例如這個例子裡有 4 個 run，分別是：

1. [tag[task]regexp:title[Blog]] 
2. -[regexp:title[omni]]
3. +[tagging[]] 以及
4. ="Additional Tiddler" 

至於那些 - 、 + 、= 是一個連接每個 run 的方式，稍後再談（留意這些 - 、 + 、= 並不是 run 的一部分）。

而每一個 run 是由一個或多於一個的 step 所組成（都是由 operator:suffix[parameter] 的方式來表現）、或是直接以 "<text>" 的方式來代表。operator 指的是一些官方提供的操作，例如上面出現的 tag 等等。這裡有詳細的清單。

以以上的例子來說：

• [tag[task]regexp:title[Blog]]  這個 run 裡有兩個 step。
  • 第一個是 tag[task] ，operator （名稱）是 tag、parameter 是task。
  • 第二個是 regexp:title[Blog]，operator 是 regexp、suffix 是 title、parameter 是 Blog
  • 這個 run 的意思是找出所有有 tag 為 task 、並且標題包含 Blog 的 tiddler（以 regular expression 來表達）。
• -[regexp:title[omni]]這個 run 裡有一個 step。
  • operator 是 regexp、suffix 是 title、parameter 是 omni
  • 這個 run 的意思是找出所有標題包含 omni 的 tiddler（以 regular expression 來表達）。
  • 而每一個 run 是和前面的 run 有關係的。由於這個 run 的前面有 - 的關係變成了剔除這些 tiddler 的意思，這變成了這個加上前一個 run 加起來的意思是 “找出所有有 tag 為 task 、並且標題包含 Blog 的 tiddler，並且剔除標題包含 omni 的 tiddler。”
• +[tagging[]] 這個 run 裡有一個 step， 而這個 run 的 operator 是 tagging。
  • 假設之前兩個 run 得出來的結果只有兩個 tiddler ，分別是 “Blog : Post: aaa” 和 “Blog : Post: bbb” ，那麼這三個 run 得出的結果是所有有 tag 上”Blog : Post: aaa” 或 “Blog : Post: bbb” 的 tiddler們。
• 最後，="Additional Tiddler" 指的只是一個名為 “Additional Tiddler” 的 tiddler。而 = 的意思是在前面 3 個 run 的結果上直接加上這個 run 的結果，也就是”Additional Tiddler 這個 tiddler。

例子有點複雜。但我相信有了概念後，看這幾篇應該不是問題了。

• Filter Syntax
• Filter Expression
• Filter Run
• Filter Step
• Introduction to Filter notation 這篇有更多 Filter Expression 的例子。

> 進階應用：Filter Expression 不只是為了找出 tiddler 們而存在喔

隨著時間的發展，Filter Expression 裡的 operator 也不只是為了 tiddler 而服務，例如加上了很多的關放文字操作的 operator（String operators） 和數學操作的 operator（Mathematics Operators）。

例如以下的 Filter Expression，你猜會出現了什麼的結果？

=1 =2 =3 =4 +[multiply[4]multiply[3]] -12

相信看到這裡，也知道這個 Filter Expression 有6個 run 了。以下來說每個 run 得出的結果吧。

	Run	每個 run 得出的結果（以逗號分隔的列表）
1	=1	1
2	=2	1, 2
3	=3	1, 2, 3
4	=4	1, 2, 3, 4
5	+[multiply[4]multiply[3]]	12, 24, 36, 48
6	-12	24, 36, 48

我們可以只在 TiddlyWiki 裡不用寫程式便能進行這些數學運算，不要忘記這只是一個 Wiki 軟件而已！

> 進階應用：把 variable 和 transclusion 和 Filter Expression 結合

另外，我們還可以在 step 裡放入 variable（以 <variable_name> 的方式表達） 、或是 transclusion 的表達式（以 {transclusion_value} 的方式表達）。因為 Variable 和 Transclusion 不是這篇的課題，在這裡不多談了，有興趣可以看 這裡。

此外，我們可以把 Filter Expression 的結果以 transclusion 的方式展示出來（這叫做 Filtered transclusions）。方法是使用 {{{ Filter Expression }}} 。詳細看此。但如果以這個方式以 set widget 的方式放在 variable 裡，這個 variable 只包含該 Filter Expression 的第一個結果。

事實上，還真的有人利用以上的特性製造了一個為每個 tiddler 作計時器的工具（連結按此）。由於我有把 TiddlyWiki 當作任務管理軟體的習慣，最近我還把這個工具用作為自己的每個任務計時的工具。

> 總結

Filter Expression 雖然不算容易學習，但是這是我認為和其他 wiki 應用的很大的分別，這個功能和其他的 widget 結合起來 ，就會變成了訂制度十分高的工具，功能基本上已經超越了 wiki 工具的範圍。

也因為 TiddlyWiki 有這麼彈性的功能，才能讓我們自己做出滿足自己需要的功能。

---

TiddlyWiki 教學：

• 知識連結的工具：TiddlyWiki
• TiddlyWiki 增加預設文字的方法（Snippet）
• TiddlyWiki 表格教學
• 我會用 TiddlyWiki 來做甚麼？
• TiddlyWiki 實用 macro：copy-block-1
• TiddlyWiki 製造記事連結的方法
• 我的 TiddlyWiki 個人任務管理系統
• TiddlyWiki 的收集箱：TickTick
• Zettelkasten 筆記方法在 TiddlyWiki的應用：如何建立雙向連結？
• TiddlyWiki Filter Expression：釋放 TiddlyWiki 十倍威力的工具
• 重新命名 Tiddler 很麻煩？ReLink 這個 Plugin 可以解決這個煩惱
• TiddlyWiki 教學：在每一個 Tiddler 上加入自定義頁面
• TiddlyWiki 教學：在每一個 Tiddler 上加入子分頁連結
• TiddlyWiki 卡頓了？我的效能改善方案
• TiddlyWiki 教學與案例示範：如何在每個 Tiddler 展示反向連結以及相關內容？
• TiddlyWiki 教學與示範：如何像 Evernote 般快速加入 checkbox？（CheckboxWidget、EditorToolbar、ActionSendMessageWidget）
• TiddlyWiki 教學與示範：計算電費的表格

分類: 學習筆記 知識管理 TiddlyWiki

寫作日期： 2020-07-19

Tweet

相關文章:

• TiddlyWiki 教學與示範：計算電費的表格
• TiddlyWiki 教學與示範：如何製作表格模版？（EditTextWidget、RevealWidget、WikifyWidget）
• TiddlyWiki 教學與示範：如何像 Evernote 般快速加入 checkbox？（CheckboxWidget、EditorToolbar、ActionSendMessageWidget）
• TiddlyWiki 教學與案例示範：如何在每個 Tiddler 展示反向連結以及相關內容？
• TiddlyWiki 卡頓了？我的效能改善方案

隨機文章: