Agenda 用户指南
本页内容
下载 PDF

搜索语法速查表

Agenda 中的搜索既简单又快速,你只需输入几个搜索词,就能立即搜索所有笔记。位于当前所选概览或项目中的匹配结果会显示在结果列表的顶部,而位于已归档项目或废纸篓中的结果则显示在末尾。

不过,你也可以创建复杂得多的查询:既可以点按搜索栏中按下空格键或回车键后生成的搜索标记,也可以借助与文本操作非常相似的机制(参见文本操作速查表一章),并配合强大的自动补全功能。

搜索属性以反斜杠字符(\)作为前缀,它会唤出一个自动补全菜单,显示可供搜索的属性;你还可以通过输入所需操作的前几个字符来进一步筛选。

提示: 在没有硬件键盘的 iPhone 和 iPad 上,输入反斜杠字符可能有些麻烦。你可以改为直接点按搜索栏中的放大镜图标。很方便!

同样,在某些键盘上(例如中文或日文键盘)很难输入反斜杠字符,因此凡是显示反斜杠字符的地方,你也可以使用两个反引号(``)或两个中点字符(··)。

其中许多属性可以在圆括号内接受所谓的参数(类似于你可以为标签添加值参数的方式,参见标签、人物、文本操作和链接一章),以进一步细化这些操作的行为。例如,\title(starts-with: yak) 会搜索标题以单词 yak 开头的笔记。

标记为 Default 的参数在未提供参数名时被视为默认参数。例如,\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 - 标签的名称 - Default, Required
  • color - 标签颜色的名称或十六进制值 - 高级版
  • valuetextstring - 可选的文本值 - Second Default
  • 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 - 人物的名称 - Default, Required

示例

  • \person(name: Tom G) - 创建人物 @(Tom G),等同于 \person(Tom G)

\reminder

  • 搜索笔记内容中的提醒事项
  • 同义词:\remind

参数

  • none - 插入一个未安排时间的占位提醒事项
  • due-date - 表示未来某个日期的自然语言字符串 - Default
  • title - 要安排的提醒事项的标题
  • list - 「提醒事项」App 中用于安排该提醒事项的列表
  • 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

  • 该词不应存在
  • 同义词:!

精确匹配

() 和 ""

分组

本地化

请注意,所有操作和参数都应根据 App 的语言进行相应的本地化。在这种情况下,你既可以使用上面的英文形式,也可以使用翻译后的形式。另外请注意,虽然这些操作名称可能包含重音符号和/或大写字母,但输入时并不需要照搬,例如在法语版 Agenda 中,输入以下任意一种都可以得到编号列表:

  • \numérotée
  • \numerotee
  • \Numérotée
  • \numbered