Org-Super-Agenda 项目使用教程

Org-Super-Agenda 项目使用教程

org-super-agenda Supercharge your Org daily/weekly agenda by grouping items 项目地址: https://gitcode.com/gh_mirrors/or/org-super-agenda

1. 项目目录结构及介绍

Org-Super-Agenda 是一个用于增强 Emacs Org 模式下的日常/周程表的功能包。项目目录结构如下：

• .gitignore: 指定 Git 忽略的文件和目录。
• LICENSE: 项目使用的开源许可证文件，本项目采用 GPL-3.0 许可。
• Makefile: 构建脚本，用于自动化一些项目相关的任务。
• NOTES: 项目笔记文件。
• README.org: 项目的主要说明文件，采用 Org 模式编写。
• examples.org: 包含项目使用示例的 Org 文件。
• org-super-agenda.el: 项目的主要 Emacs Lisp 文件，包含 Org-Super-Agenda 的实现。
• org-super-agenda.info: 项目信息文件。
• test: 包含项目测试文件的目录。
• screenshots: 包含项目屏幕截图的目录。

每个文件和目录都有其特定的用途，是项目整体功能的一部分。

2. 项目的启动文件介绍

项目的启动主要是通过加载 org-super-agenda.el 文件来实现。你需要在 Emacs 的初始化文件（通常是 ~/.emacs 或 ~/.emacs.d/init.el）中添加以下代码来加载 Org-Super-Agenda：

(add-to-list 'load-path "/path/to/org-super-agenda") ; 将路径替换为实际的文件路径
(require 'org-super-agenda)

加载后，你可以通过调用 org-super-agenda-mode 来启用 Org-Super-Agenda 模式。此外，你还需要配置 org-super-agenda-groups 变量来定义你的日程分组。

3. 项目的配置文件介绍

Org-Super-Agenda 的配置主要是通过修改 org-super-agenda-groups 变量来实现的。这个变量定义了日程分组的方式，可以根据不同的条件（如标签、TODO 关键字、优先级等）来分组你的日程项。

以下是一个 org-super-agenda-groups 的配置示例：

(setq org-super-agenda-groups
      '(
        (:name "今天" :time-grid t :todo "TODAY")
        (:name "重要" :tag "bills" :priority "A")
        (:name "购物" :and (:tag "shopping" :tag "@town"))
        (:name "食物相关" :tag ("food" "dinner"))
        (:name "个人" :habit t :tag "personal")
        (:name "太空相关" :and (:regexp ("space" "NASA") :not (:regexp "moon" :tag "planet")))
        (:todo "WAITING" :order 8)
        (:todo ("SOMEDAY" "TO-READ" "CHECK" "TO-WATCH" "WATCHING") :order 9)
        (:priority<= "B" :order 1)
      ))

在这个配置中，每个分组都有一个名称和一组选择器，用于决定哪些日程项应该分到该组。通过调整 :order 参数，你可以改变分组在日程视图中的显示顺序。

org-super-agenda Supercharge your Org daily/weekly agenda by grouping items 项目地址: https://gitcode.com/gh_mirrors/or/org-super-agenda