Agenda 使用指南
本頁內容
下載 PDF

搜尋語法速查表

Agenda 中的搜尋既簡單又快速,你只要輸入幾個搜尋詞,就能立即搜遍你所有的筆記。位於目前所選概覽或專案中的搜尋結果會顯示在結果列表最上方,位於已封存專案或垃圾桶中的則顯示在最後。

不過,你也可以建立複雜得多的查詢,方式包括按一下/點一下在你按下空格鍵或 return 鍵時於搜尋欄位中建立的搜尋代符,也可以透過與文字動作非常類似的系統(請參閱 文字動作速查表 一章),並搭配強大的自動完成功能。

搜尋屬性以反斜線字元(\)作為前綴,它會叫出一個自動完成選單,顯示可用來搜尋的屬性,你還可以輸入想使用的動作的前幾個字元來進一步篩選。

提示: 在沒有實體鍵盤的 iPhone 和 iPad 上,輸入反斜線字元可能有點麻煩。你可以改為直接點一下搜尋欄位中的放大鏡圖像。很方便!

同樣地,在某些鍵盤上,例如中文或日文鍵盤,很難輸入反斜線字元,因此凡是顯示反斜線字元的地方,你也可以使用兩個反引號(``)或兩個間隔號字元(··)。

其中許多屬性可以在括號內帶入所謂的 參數(類似於你可以為標籤加上數值參數的做法,請參閱 標籤、人物、文字動作與連結 一章),以進一步調整這些動作的行為。舉例來說,\title(starts-with: yak) 會搜尋筆記標題開頭處的 yak 這個字。

標示為 預設 的參數,會在未提供任何參數時被視為預設參數。舉例來說,\tag(important)\tag(name: important) 被視為相同。

以下你會找到 Agenda 目前支援的搜尋屬性完整總覽。

筆記屬性

\all

  • 搜尋筆記的所有欄位(預設)
  • 同義詞:everything

\on-the-agenda

  • 依筆記的「在議程上」狀態搜尋
  • 同義詞:ontheagendaotaagenda

\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 功能
  • valuetextstring - 選用的文字值 - 第二預設
  • dayonafterbeforeuntilfromin - 選用的日子值
  • dateat - 選用的日期值
  • intintegernumberlevel - 選用的整數值
  • floatdouble - 選用的浮點數值

範例

  • \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

參數

  • namealiasnickname - 人物的姓名 - 預設、必須的

範例

  • \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

  • 依筆記內容中的表格搜尋
  • 同義詞:
  • 依筆記內容中的連結搜尋
  • 同義詞:

\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