*制定议程

属性: :CUSTOM_ID: building-the-agenda :CUSTOM_ID building-the-agenda

结束:

I very briefly introduced the agenda in my previous post, 我在之前的文章中简要介绍了议程， Dig into Org Mode. The “agenda” is a time-aware, filtered view of all [[/ 2016/01/30 / dig-into-org-mode。[深入到组织模式]]。“日程”是所有内容的时间感知、过滤视图 of the entries in some set of Org files, which you can specify. To make proper 可以指定的一组Org文件中的项。做出适当的 use of the agenda, you must first tell Org which files to read by configuring 使用议程时，您必须首先通过配置告诉Org要读取哪些文件 the org-agenda-files variable. = org-agenda-files =变量。

As I noted in Dig into Org Mode, I build my agenda from all of the Org 正如我在[[/2016/01/30/ digi -into-org-mode]中提到的。[深入到组织模式]]，我建立我的议程从所有的组织 files in my “org” directory in Dropbox. Specifying a single directory is the 文件在我的“org”目录下的Dropbox。方法指定单个目录 easiest thing you can do: 你能做的最简单的事情:

(setq org-agenda-files '("~/Dropbox/org/"))

You can also select individual files or specify a file that contains a list of 您还可以选择单独的文件，或指定包含列表的文件 files to read. See the variable's documentation for specifics. 阅读文件。有关详细信息，请参阅变量的文档。

Once Org knows where to look to build up the agenda view, you can populate it 一旦Org知道在何处查找以构建日程视图，您就可以填充它 with your tasks. I'm assuming that you already use Org for note-taking or task 你的任务。我假设你已经使用Org做笔记或做任务了 management in some way, but if you don't, here is the bare minimum you should 从某种程度上说，这是一种管理，但如果你不这样做，你至少应该这么做 place into a file to see how this works: 放入一个文件，看看这是如何工作:

#+BEGIN_EXAMPLE

#+END_EXAMPLE

With a file like this saved as something like todo.org in the directory 在目录中保存类似于=todo.org=这样的文件 specified in org-agenda-files, you can now press M-x org-agenda RET to 在=org-agenda-files=中指定，现在可以按=M-x org-agenda RET= to display the “agenda dispatch” menu. The first option, “a,” is the most common as 显示“日程调度”菜单。第一个选项“a”是最常见的as it will display a weekly view with entries sorted into their respective dates. 它将显示一个按日期排序的每周视图。

You may have noticed that the “agenda dispatch” menu contains options for 您可能已经注意到，“日程调度”菜单包含以下选项 displaying views based on dates, views of pure TODO items, and even views 显示基于日期的视图、纯TODO项的视图，甚至视图 filtered by search criteria. These are extremely useful features that I use all 根据搜索条件过滤。这些都是我使用的非常有用的特性 the time, but it's hard to face a busy day with all of your activities sorted 时间，但很难面对一个忙碌的一天，你的所有活动排序 into separate lists with separate commands, so let's combine them. 用不同的命令把它们分成不同的列表，让我们把它们组合起来。

To do this, we will use an “agenda custom command.” 为此，我们将使用“日程自定义命令”。

*议程自定义命令

属性: :CUSTOM_ID: agenda-custom-commands :CUSTOM_ID agenda-custom-commands

结束:

An “agenda custom command” allows you to add your own entries to the dispatch “日程自定义命令”允许您将自己的条目添加到调度中 menu and, in effect, define your own agenda view that you can trigger easily. To 菜单，实际上，定义您可以轻松触发的自己的议程视图。自 define custom agenda commands, you customize the variable 定义自定义议程命令，自定义变量 org-agenda-custom-commands. = org-agenda-custom-commands =。

In its simplest form, an agenda command looks like this: 在其最简单的形式，一个议程命令看起来像这样:

(setq org-agenda-custom-commands
'(("c" "Simple agenda view" agenda ""))

Note that org-agenda-custom-commands is itself a list, so its value here is a 注意=org-agenda-custom-commands=本身就是一个列表，所以它的值是a list with one element, which is also a list. That inner list is our custom 带有一个元素的列表，它也是一个列表。内部列表是我们的习惯 command; it has a single letter key that will appear in the menu (“c”), a 命令;它有一个字母键，将出现在菜单(“c”)，a description that will also appear, and then a type. 描述也将出现，然后是类型。

There are many types available and some can accept arguments. Types and their 有许多可用的类型，有些可以接受参数。类型和他们的 arguments are given one after another. In this case, the “agenda” type takes no 参数一个接一个地给出。在这种情况下，“日程”类型接受no arguments and the documentation specifies that the empty string must be given. 参数和文档指定必须提供空字符串。

OK, so this is great and all, but all we've actually done is recreate the “a” 好的，这很好，但是我们实际上所做的就是重新创建了" a " option with the letter “c” instead. That isn't very helpful. 用字母“c”代替选项。这没什么用。

The goal is to be able to see our scheduled items and our unscheduled items 目标是能够看到我们的计划项目*和*我们的计划外项目 in the same view. Fortunately, there is a feature for this (of course), and it 同样的观点。幸运的是，它有一个特性(当然) is called a “composite agenda” or “agenda block view.” 称为“组合议程”或“议程块视图”。

Essentially, by supplying a list of types, the agenda view will generate each 本质上，通过提供类型列表，agenda视图将生成每种类型 one in turn and display them in the same buffer together! This is one of the 一个依次显示在同一个缓冲区中!这是其中一个 greatest things I've ever discovered. I lived for months scheduling things to 我所发现的最伟大的事情。我花了几个月的时间来安排事情 start “today” just so they would show up in the agenda, even though dates were 从“今天”开始，这样他们就会出现在议程上，即使日期是 irrelevant. Since discovering this view, I now have a much more nuanced 无关紧要的。自从发现了这个观点，我现在有了一个更微妙的观点 perspective on my priorities. 我优先考虑的事情。

属性: :CUSTOM_ID: finally-habits :CUSTOM_ID finally-habits

结束:

You may already know that Org Mode supports TODO items that repeat. There are a 您可能已经知道Org模式支持重复的TODO项。有 few ways that repeating schedules can be specified, so I recommend 可以指定重复调度的方法很少，因此我建议您这样做 reading the full documentation. 阅读完整文档。

One of the most powerful ways of tracking repeated tasks is by using 跟踪重复任务的最强大的方法之一是使用 habits. A habit is something that you want to do on a regular basis, but

where you have flexibility in how regular the schedule is. 你可以灵活安排时间。

Here, again, you may want to review the 在这里，你可能想复习一下 full habits documentation. The example used in the documentation 完整的习惯文档。文档中使用的示例 is remembering to shave. It is not critical that you shave on any single, exact 就是记得刮胡子。你刮任何一种胡子都是可以的 day, but it may be important to you to shave within a loose cadence with a 但它可能是重要的，你刮在一个松散的节奏与一个 couple of days of leeway. 有几天的时间。

I use habits to track scheduling appointments like one-on-ones with my direct 我以一对一的方式来跟踪日程安排 reports. While it is very important that one-on-ones happen regularly, it is not 报告。一对一的会面很重要，但事实并非如此 critical that they take place at exactly X days apart, and this gives me 关键是它们恰好在X天内发生，这给了我 flexibility to schedule more frequently with people who need more attention and 灵活安排时间，与需要更多关注的人在一起 to work around my other appointments. 避开我的其他约会

To create a habit, you need two things: 要养成习惯，你需要两样东西:

1. A SCHEDULED tag with a repeat specification (like .+ or ++), and
2. 带有重复规范(like )的调度=标记。+=或=++)，和
3. A STYLE property set to the value habit.
4. 将A STYLE property设置为value =habit=。

Here is the example from the documentation: 下面是文档中的例子:

#+BEGIN_EXAMPLE

属性: :CUSTOM_ID: filtering-habits :CUSTOM_ID filtering-habits

结束:

Again I was really optimistic that Org provided some built-in function for 我还是很乐观Org提供了一些内置功能 filtering by style or property... But it doesn't. So here's my implementation of 根据样式或属性过滤…但它不是。这是我的实现 a habit-skipping function: habit-skipping函数:

(defun air-org-skip-subtree-if-habit ()
"Skip an agenda entry if it has a STYLE property equal to "habit"."
(let ((subtree-end (save-excursion (org-end-of-subtree t))))
(if (string= (org-entry-get nil "STYLE") "habit")
subtree-end
nil)))

Org does provide helper functions for extracting property values and finding Org确实为提取属性值和查找提供了帮助函数 locations relative to entries, so it was straightforward to write this. It would 相对于项的位置，所以很简单。它将 be easy enough to parameterize the property value if you wanted to skip 如果想要跳过，参数化属性值非常简单 different types of properties, but I don't have that use case (yet). 不同类型的属性，但我还没有那个用例。

*最后议程

属性: :CUSTOM_ID: the-final-agenda :CUSTOM_ID the-final-agenda

结束:

I've covered almost everything, so finally here is the complete agenda composite 我几乎涵盖了所有内容，所以最后这里是完整的议程组合 view command: 查看命令:

(setq org-agenda-custom-commands
'(("d" "Daily agenda and all TODOs"
((tags "PRIORITY="A""
((org-agenda-skip-function '(org-agenda-skip-entry-if 'todo 'done))
(org-agenda-overriding-header "High-priority unfinished tasks:")))
(agenda "" ((org-agenda-ndays 1)))
(alltodo ""
((org-agenda-skip-function '(or (air-org-skip-subtree-if-habit)
(air-org-skip-subtree-if-priority ?A)
(org-agenda-skip-if nil '(scheduled deadline))))
(org-agenda-overriding-header "ALL normal priority tasks:"))))
((org-agenda-compact-blocks t)))))

There are just a couple of things in here that I haven't mentioned specifically, 这里有几件事我没有特别提到， so let me do that. 我来做一下。

1. Both TODO sections use org-agenda-overriding-header, which I previously
2. 两个TODO部分都使用=org-agenda-overriding-header=，这是我前面介绍过的

described. 描述。

1. The “agenda” section in the middle also specifies org-agenda-ndays with a
2. 中间的“agenda”部分还指定=org-agenda-ndays= with a

value of 1, because I only want to see one day at a time. If you have been 值为1，因为我想一次只看一天。如果你曾经 coding along with this you might have wondered how to get rid of all the 与此同时，您可能想知道如何去掉所有的 other days of the week... This is how. 一周中的其他几天……这是如何。

1. There is a final settings list at the end containing

3.最后有一个最终的设置列表 org-agenda-compact-blocks. Settings in this list apply to the entire = org-agenda-compact-blocks =。此列表中的设置适用于整个列表 composite view, and this setting removes the equal sign dividers between the 属性之间的等号分隔符 sections, because I think they're a waste of space. 部分，因为我认为它们是对空间的浪费。

Congratulations, you now probably know more about building Org Mode agenda 祝贺您，您现在可能对构建Org模式日程有了更多的了解 commands and composite views than most people. I hope that these tools give you 命令和复合视图。我希望这些工具能给你 the ability to confidently tackle the tasks in your life and give you a sense of 自信地处理你生活中的任务的能力，给你一种感觉 peace. 和平。

*浏览议程

属性: :CUSTOM_ID: navigating-your-agenda :CUSTOM_ID navigating-your-agenda

结束:

The agenda view is pretty amazing, and it's very useful as a read-only overview 日程视图非常棒，作为只读概览非常有用 of what you need to get done, but the journey doesn't stop there because the 你需要做的事情，但是你的旅程不会就此结束 agenda is also completely interactive. 议程也是完全交互式的。

I've tweaked my configuration to make the agenda view easy to navigate and 我已经调整了我的配置，使议程视图易于导航和 interact with, optimized for my common use cases, and I'm going to get into that 交互，针对我的常用用例进行了优化，我将会讲到这个 in depth in my next post, so stay tuned! 在我的下一篇文章中有详细的介绍，请继续关注!