介绍 org-ql 常用命令
文章目录
【注意】最后更新于 May 20, 2023,文中内容可能已过时,请谨慎使用。
org-ql-find
使用 emacs 的内置补全工具和一个 org-ql 查询选择的标题实现跳转:
org-ql-find在当前缓冲区中搜索。org-ql-find-in-agendasearches in(org-agenda-files).org-ql-find-in-org-directorysearches inorg-directory.

org-ql-refile
此命令将当前的 org 条目重新归档到通过使用 org-ql 补全进行搜索所选择的条目中。它搜索 org-refile-targets 中列出的文件以及当前缓冲区。
org-ql-search
读 QUERY 和用 org-ql 搜索 。以交互方式提示输入这些变量:
BUFFERS-FILES: A 搜索 一个 buffer 列表/文件列表。互动,也支持是:
buffer: 搜索当前缓冲区all: 搜索所有组织缓冲区agenda: 搜索函数org-agenda-files返回的缓冲区列表- 是一个用空格分隔的文件或缓冲区名称的列表.
GROUPS: 设置一个 org-super-agenda 分组 . 参见 org-super-agenda-groups.
NARROW: 当非nil时,在搜索之前不要展开缓冲区。交互式的,带前缀,留窄。
SORT:一个或一组 org-ql 排序函数,如 date 或 priority 。
快捷键: 键绑定在结果缓冲区中
r: 刷新结果。带前缀,提示调整搜索参数。v: 展示transientview dispatcher(像 magit 的弹出窗口)。C-x C-s: 将查询保存到变量org-ql-views(可通过命令org-ql-view访问)。
Note: 视图缓冲区当前处于 org-agenda-mode ,这意味着 some Org Agenda 命令可以工作,例如跳转到 entry 和更改 item 优先级(不必更新视图)。此功能是实验性的,不能保证对所有命令都能正确工作。(它之所以有效,是因为在每个项目上放置了适当的文本属性,模仿议程缓冲区。)
helm-org-ql
该命令显示与helm的匹配。
- 在helm会话中按
C-x C-s将结果保存到org-ql-search缓冲区中。
org-ql-view
选择并显示存储在 org-ql-views 中的视图。
Bindings: buffer 已绑定的快捷键说明
g,r: Refresh results. With prefix, prompt to adjust search parameters.v: Showtransientview dispatcher (like Magit’s popups).C-x C-s: 将查询保存到变量org-ql-views(可通过命令org-ql-view访问)。
org-ql-view-sidebar
显示一个侧边栏窗口,列出存储在 org-ql-views 中的视图,以便于访问。在侧边栏中,按 RET 或 mouse-1 显示该点的视图,并按 c 自定义该点的视图。
org-ql-view-recent-items
显示 FILES 中最近 DAYS 天的项目,时间戳为 TYPE 。
TYPE 支持这些类型: ts, ts-active, ts-inactive, clocked, closed, deadline, planning, or scheduled.
FILES 默认为函数 org-agenda-files 返回的文件。
org-ql-sparse-tree
参数: (query &key keep-previous (buffer (current-buffer)))
在 BUFFER 中显示 QUERY 的稀疏树,并返回结果的个数。该树将显示查询匹配的行,以及在 org-show-context-detail 中定义的任何其他上下文,如所示。
QUERY 是一个 org-ql 查询 sexp(引号,因为这是一个函数)。 BUFFER 默认为当前缓冲区。当 KEEP-PREVIOUS 为 non-nil 时(在查找匹配项之前),大纲不会重置为概述状态,这允许对该命令进行嵌套调用。在生成稀疏树后运行 org-occur-hook 。
文章作者 iTBoyer
上次更新 2023-05-20