搜尋語法速查表
Agenda 中的搜尋既簡單又快速,你只要輸入幾個搜尋詞,就能立即搜遍你所有的筆記。位於目前所選概覽或專案中的搜尋結果會顯示在結果列表最上方,位於已封存專案或垃圾桶中的則顯示在最後。
不過,你也可以建立複雜得多的查詢,方式包括按一下/點一下在你按下空格鍵或 return 鍵時於搜尋欄位中建立的搜尋代符,也可以透過與文字動作非常類似的系統(請參閱 文字動作速查表 一章),並搭配強大的自動完成功能。
搜尋屬性以反斜線字元(\)作為前綴,它會叫出一個自動完成選單,顯示可用來搜尋的屬性,你還可以輸入想使用的動作的前幾個字元來進一步篩選。
提示: 在沒有實體鍵盤的 iPhone 和 iPad 上,輸入反斜線字元可能有點麻煩。你可以改為直接點一下搜尋欄位中的放大鏡圖像。很方便!
同樣地,在某些鍵盤上,例如中文或日文鍵盤,很難輸入反斜線字元,因此凡是顯示反斜線字元的地方,你也可以使用兩個反引號(``)或兩個間隔號字元(
··)。
其中許多屬性可以在括號內帶入所謂的 參數(類似於你可以為標籤加上數值參數的做法,請參閱 標籤、人物、文字動作與連結 一章),以進一步調整這些動作的行為。舉例來說,\title(starts-with: yak) 會搜尋筆記標題開頭處的 yak 這個字。
標示為 預設 的參數,會在未提供任何參數時被視為預設參數。舉例來說,\tag(important) 與 \tag(name: important) 被視為相同。
以下你會找到 Agenda 目前支援的搜尋屬性完整總覽。
筆記屬性
\all
- 搜尋筆記的所有欄位(預設)
- 同義詞:
everything
\on-the-agenda
- 依筆記的「在議程上」狀態搜尋
- 同義詞:
ontheagenda、ota、agenda
\title
- 依筆記的標題搜尋
- 同義詞:
ti
\assigned-date
- 依筆記的指定日期搜尋,也就是被指定單一日期的筆記
- 同義詞:
- 簡寫:
\today、\tomorrow、\yesterday、\monday、\tuesday、\wednesday、\thursday、\friday、\saturday、\sunday
\start-date
- 依筆記的開始日期搜尋,也就是被指定日期範圍的筆記的第一天
- 同義詞:
\end-date
- 依筆記的結束日期搜尋,也就是被指定日期範圍的筆記的最後一天
- 同義詞:
指定日期與開始/結束日期的差別:
\assigned-date適用於被指定單一日期的筆記,而\start-date和\end-date則適用於被指定日期範圍的筆記。如果某則筆記只有單一日期,\assigned-date和\start-date會比對到相同的筆記,因此它們的結果會重疊。只有當筆記具有日期範圍時,兩者的差異才會顯現出來。
\linked-event
- 依連結到筆記的行程搜尋
- 同義詞:
\calendar
- 依連結到筆記的行程所屬行事曆搜尋
- 同義詞:
\due-date
- 依筆記中提醒事項的到期日搜尋
- 同義詞:
\color
- 依筆記的背景顏色搜尋
- 同義詞:
\pinned
- 依筆記的釘選狀態搜尋
- 同義詞:
\footnote
- 依筆記的置底筆記狀態搜尋
- 同義詞:
\done
- 依筆記的完成狀態搜尋
- 同義詞:
\locked
- 依筆記的鎖定狀態搜尋
- 同義詞:
\shared
- 依筆記的共享狀態搜尋
- 同義詞:
\edited-date
- 依筆記的編輯日期搜尋
- 同義詞:
\creation-date
- 依筆記的建立日期搜尋
- 同義詞:
\template
- 依用來建立筆記的範本搜尋
- 同義詞:
筆記內容
\tag
- 依筆記內容中的標籤搜尋
- 同義詞:
#
參數
name- 標籤的名稱 - 預設、必須的color- 標籤顏色的名稱或十六進位值 - Premium 功能value、text、string- 選用的文字值 - 第二預設day、on、after、before、until、from、in- 選用的日子值date、at- 選用的日期值int、integer、number、level- 選用的整數值float、double- 選用的浮點數值
範例
\tag(name: important)- 建立標籤#important,等同於\tag(important)\tag(important, color: blue)- 建立藍色的標籤#important\tag(important, color: #333)- 建立十六進位顏色為 #333 的標籤#important\tag(priority, value: high)- 建立標籤#priority(high),等同於\tag(priority, high)\tag(due, day: tomorrow)- 建立標籤#due(6 April 2022)\tag(due, in: 3 weeks)- 建立標籤#due(26 April 2022)\tag(deadline, at: 17 oct 2022 13pm)- 建立標籤#deadline(17 Oct 2022 at 13.00)\tag(priority, int: 1, color: red)- 建立紅色的標籤#priority(1)\tag(version, float: 2.1)- 建立標籤#version(2.1)
\person
- 依筆記內容中的人物搜尋
- 同義詞:
@、contact
參數
name、alias、nickname- 人物的姓名 - 預設、必須的
範例
\person(name: Tom G)- 建立人物@(Tom G),等同於\person(Tom G)
\reminder
- 依筆記內容中的提醒事項搜尋
- 同義詞:
\remind、
參數
none- 插入一個未排定時間的佔位提醒事項due-date- 代表未來某個日期的自然語言字串 - 預設title- 要排定的提醒事項標題list- 要在「提醒事項」應用程式中排定該提醒事項的列表all-day- 將該提醒事項排定為全天提醒事項
範例
\reminder- 建立一個未排定時間的提醒事項並開啟編輯彈出視窗\reminder(today)- 為今天 30 分鐘後排定一則提醒事項\reminder(today at 6pm)- 為今天 6 點排定一則提醒事項\reminder(tomorrow evening)- 為明天 6 點排定一則提醒事項\reminder(in 3 weeks)- 排定一則從現在起 21 天後的提醒事項\reminder(25 dec 2020, at 8pm)` - 為 2020 年 12 月 25 日 8 點排定一則提醒事項\reminder(today at 6pm, list: important)- 在提醒事項列表「important」中,為今天 6 點排定一則提醒事項\reminder(all-day: tomorrow)- 為明天排定一則全天提醒事項
\table
- 依筆記內容中的表格搜尋
- 同義詞:
\link
- 依筆記內容中的連結搜尋
- 同義詞:
\attachment
- 依筆記內容中的附件搜尋
- 同義詞:
\drawing
- 依筆記內容中的繪圖搜尋
- 同義詞:
\starred
- 依筆記內容中的星號狀態搜尋
- 同義詞:
\has-todo
- 依筆記內容中是否含有待辦項目搜尋
- 同義詞:
\has-checklist
- 依筆記內容中是否含有檢查列表搜尋
- 同義詞:
\has-list
- 依筆記內容中是否含有編號列表、排序列表或檢查列表搜尋
- 同義詞:
\has-code
- 依筆記內容中是否含有程式碼片段搜尋
- 同義詞:
\has-quote
- 依筆記內容中是否含有引用搜尋
- 同義詞:
專案與類別
\category
- 依含有該筆記的類別搜尋
- 同義詞:
\project
- 依含有該筆記的專案搜尋
- 同義詞:
\archived
- 依筆記是否屬於已封存的專案搜尋
- 同義詞:
預設集
\recently-edited
- 搜尋最近編輯過的筆記
- 同義詞:
\now
- 搜尋目前進行中的筆記
- 同義詞:
\upcoming
- 搜尋即將到來的筆記
- 同義詞:
\earlier
- 搜尋剛剛結束的筆記
- 同義詞:
\on-this-day
- 搜尋過去被指定到先前某一年同一天的筆記。
- 同義詞:
\random
- 傳回指定數量的隨機選取筆記
- 同義詞:
運算子
AND
- 兩個詞都必須出現
- 同義詞:
&&
OR
- 其中一個詞必須出現
- 同義詞:
||
NOT
- 該詞不得出現
- 同義詞:
!
完全相符
() 和 ""
分組
在地化
請注意,所有動作和參數都應依應用程式的語言適當在地化。在這種情況下,你可以使用上述的英文形式,或翻譯後的形式。請注意,雖然這些動作可能含有重音符號及/或大寫字母,但你不需要輸入這些,舉例來說,在法文版的 Agenda 中,你可以輸入以下任何一種來取得編號列表:
\numérotée\numerotee\Numérotée\numbered