搜索语法速查表
Agenda 中的搜索既简单又快速,你只需输入几个搜索词,就能立即搜索所有笔记。位于当前所选概览或项目中的匹配结果会显示在结果列表的顶部,而位于已归档项目或废纸篓中的结果则显示在末尾。
不过,你也可以创建复杂得多的查询:既可以点按搜索栏中按下空格键或回车键后生成的搜索标记,也可以借助与文本操作非常相似的机制(参见文本操作速查表一章),并配合强大的自动补全功能。
搜索属性以反斜杠字符(\)作为前缀,它会唤出一个自动补全菜单,显示可供搜索的属性;你还可以通过输入所需操作的前几个字符来进一步筛选。
提示: 在没有硬件键盘的 iPhone 和 iPad 上,输入反斜杠字符可能有些麻烦。你可以改为直接点按搜索栏中的放大镜图标。很方便!
同样,在某些键盘上(例如中文或日文键盘)很难输入反斜杠字符,因此凡是显示反斜杠字符的地方,你也可以使用两个反引号(``)或两个中点字符(
··)。
其中许多属性可以在圆括号内接受所谓的参数(类似于你可以为标签添加值参数的方式,参见标签、人物、文本操作和链接一章),以进一步细化这些操作的行为。例如,\title(starts-with: yak) 会搜索标题以单词 yak 开头的笔记。
标记为 Default 的参数在未提供参数名时被视为默认参数。例如,\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- 标签的名称 - Default, Requiredcolor- 标签颜色的名称或十六进制值 - 高级版value、text、string- 可选的文本值 - Second Defaultday、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- 人物的名称 - Default, Required
示例
\person(name: Tom G)- 创建人物@(Tom G),等同于\person(Tom G)
\reminder
- 搜索笔记内容中的提醒事项
- 同义词:
\remind,
参数
none- 插入一个未安排时间的占位提醒事项due-date- 表示未来某个日期的自然语言字符串 - Defaulttitle- 要安排的提醒事项的标题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
- 搜索笔记内容中的表格
- 同义词:
\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
- 该词不应存在
- 同义词:
!
精确匹配
() 和 ""
分组
本地化
请注意,所有操作和参数都应根据 App 的语言进行相应的本地化。在这种情况下,你既可以使用上面的英文形式,也可以使用翻译后的形式。另外请注意,虽然这些操作名称可能包含重音符号和/或大写字母,但输入时并不需要照搬,例如在法语版 Agenda 中,输入以下任意一种都可以得到编号列表:
\numérotée\numerotee\Numérotée\numbered