任务列表

任务列表插件添加了一个对话框，列出当前笔记本所有页面中的未完成项目。从某种意义上说，它是一个专门的搜索功能。未完成项目或任务由单行定义，可以有标签和优先级。

依赖： 此插件没有额外的依赖项。

另请参阅： 本手册页记录了插件的选项以及插件如何解释任务。有关如何以及何时使用它的更多背景信息，请参见：Usage:ToDo Lists #待办事项列表使用和 Usage:Getting Things Done #GTD工作法使用。此插件经常与Journal #日志插件一起使用。

首选项

在标题栏中显示任务列表按钮选项决定是否在窗口顶部的标题栏中显示打开任务列表对话框的按钮。

显示"GTD风格"的收件箱和下一步操作列表选项决定在选择窗格中显示哪些列表。详情见下文。

在侧边栏中显示任务列表和窗口中的位置选项允许您将任务列表嵌入到窗口的一个侧边栏中。在侧边栏中显示截止日期、在侧边栏中显示开始日期和在侧边栏中显示页面列决定在侧边栏中显示哪些列。

笔记本属性

如果启用了"将所有复选框视为任务"选项，任何找到的复选框都将出现在任务列表中。如果禁用，则只有具有任务标签（如"FIXME"或"TODO"）的复选框才会出现在列表中。

标记任务的标签选项提供了用于标记任务的标签的逗号分隔列表。默认情况下，这些是"TODO"和"FIXME"，但可以自定义。

"等待中"任务的标签选项为正在等待某事而因此不能立即执行的任务提供特定标签，典型用法是已经委派或已计划的任务。
"等待中"任务的标记选项具有相同的含义，但使用标记而不是标签来标记任务。

如果启用了使用日志页面中的日期，在属于Journal #日志插件的页面中找到的任务将获得该日历日期作为开始日期和/或截止日期。如果页面涵盖多天（例如每周页面），周期的最后一天将被视为截止日期，而开始日期则使用第一天。如果页面涵盖一周或一个月，并且任务出现在指定特定日期的标题下，则任务将被分配到该天。为了使此功能正常工作，标题必须包含一个显式锚点ID，该ID以标准日期格式给出日期（有关如何生成这些内容的示例，请参见默认日志模板）。

要索引的部分和要忽略的部分选项可用于限制为任务编制索引的命名空间。默认情况下，使用整个笔记本，但如果使用这些选项中的任何一个或两个，则只为指定的部分集合编制索引。多个命名空间可以用",""分隔给出。

如果启用了在选择窗格中显示页面名称选项，它将在选择窗格中添加找到任务的页面的页面名称元素。

如果启用了不将星期六和星期日计为工作日选项，任务到期前的剩余天数将基于5天工作周（星期一至星期五）计算。

选择

选择窗格有几个类别用于选择：列表、标签、标记和页面。

列表：默认列表在下面描述
标签：这些是像"TODO"或"FIXME"这样的标签，可以出现在任务描述的开头。确切的标签可以通过标记任务的标签首选项配置。如果您选择多个标签，将显示具有任何所选标签的任务（"或"选择）
标记：这些是任务描述中出现的"@名称"标记。如果您选择多个标记，将显示与所有所选标记匹配的任务（"与"选择）
页面：这些是页面名称的唯一部分，允许以类似标记的方式使用页面路径。如果您选择多个页面，将显示任何所选页面的任务（"或"选择）

列表

在选择窗格中有3个"列表"：所有任务、活动和等待中：

所有任务：这是所有任务的概览，它以父任务和子任务的树形结构表示
活动：此列表显示所有没有子项目、没有将来开始日期且不在等待中的未完成任务，它是所有可以被视为"可执行"的项目的平面列表
等待中：此列表显示所有已被标记为"等待中"的任务，使用"等待中"任务的标签属性配置的标签

当启用显示"GTD风格"的收件箱和下一步操作列表首选项时，活动列表分为3个子列表：

收件箱：此列表显示"未分类"的活动任务子集 - 这意味着它们不属于项目，也没有设置优先级或截止日期。它还隐藏了具有已关闭子任务的项目，这些将显示在"项目"列表中
下一步操作：类似于"活动"列表，但它只显示具有优先级或截止日期或是项目一部分的任务，这将这些项目与"收件箱"项目区分开来。它还隐藏了具有已关闭子任务的项目，这些将显示在"项目"列表中
项目：此列表显示所有具有子任务（未完成或已完成）的未完成任务

通过这3个列表，您可以使用"类GTD"方法工作。要创建收件箱项目，您只需在页面上的任何位置写下任务，而无需添加优先级或截止日期（允许使用标记）。当您处于审核模式时，您可以对这些任务进行分类、添加子任务等，它们会自动移动到"下一步操作"或"项目"列表。同样，在审核模式下，您可以检查项目并找出在哪里添加更多的子任务。

标记

选择任务集的另一种方法是使用标记。使用这些标记的典型方式是给任务提供上下文，说明什么时候或在哪里相关。例如，任务可以标记为@home或@work，或者您可以按需要交谈的人员标记任务 - 这样您就可以快速列出下次会议中要讨论的事项。

标记由子任务继承。因此，按标记选择也包括可能没有直接标记的任务。原因是子任务应该与其父任务具有相同的上下文。

页面选择

如果启用了在选择窗格中显示页面名称选项，则在选择页面中会显示页面名称的唯一部分。这允许以类似标记的方式使用页面路径。

它允许选择共享公共父页面的所有任务。例如，如果您有一个名为"Projects"的笔记本部分，在页面选择中选择"Projects"标签将显示"Projects"部分的子页面上的所有任务。同样，您可以选择"Journal"部分中的所有任务。

它还允许合并来自不同页面但具有公共名称的任务。例如，如果您按客户组织任务，并且有页面"Customer A:Brainstorm"和"Customer B:Brainstorm"，在页面选择中选择"Brainstorm"标签将显示两个页面上的所有任务的组合。

如果您只想显示特定页面的任务，页面选择可能不是您想要的。在这种情况下，您可以在过滤任务的输入框中输入完整的页面名称。这是有效的，因为过滤器也考虑任务视图的"页面"列。

使用方法

使用复选框

使用任务列表的第一种方法是通过复选框定义未完成项目。像这样的列表将被解释为任务列表，每一行将显示在任务列表对话框中。

☐ 购买大米 @购物
☐ 打电话给Susan邀请她共进晚餐 <2017-05-01 !
☐ 打印菜单 @办公桌

在这个例子中，第二项因为"!"将具有最高优先级，叹号越多，优先级越高。此外，带有"@"的词将被视为标记，因此对话框将显示"购物"和"办公桌"标记，可用于过滤任务列表。

截止日期以"<"为前缀：您必须在该日期之前完成任务。
开始日期以">"为前缀：您应该在该日期之后开始任务。

☐ 2017年3月27日到期的任务 <2017-03-27
☐ 几年后才开始的任务（截至撰写时） >2020-01
☐ 日期也可以通过周数给出 <17W13

支持以下日期格式：

按日期表示的日：yyyy-mm-dd，例如2017-02-16
月份表示：yyyy-mm，例如2017-02
周表示：(yy)yyWww或(yy)yy-Www，例如2017W07、17W07或17-W07
按周表示的日：使用周表示后跟-D，其中"D"是一周中的天数；例如17-W07-2表示星期二
周和日也可以使用Wkyyww(.D)表示，例如wk1707和wk1702.2

为避免mm/dd、dd/mm和yy-mm表示法之间的混淆，不支持这些表示法，日期的年份应始终以4位数字给出。对于周表示法，支持两位数年份；这些总是以"20"为前缀，因此"01W17"变为2001W17，"99W05"变为2099W05。对于以19开头的年份（或任何其他世纪），需要使用完整的四位数年份。

周数遵循iso日历。但是，根据区域设置，星期日可以是起始周的第一天，也可以是结束周的最后一天。在工作日表示法中，通过使用"0"表示周开始的星期日，使用"7"表示周结束的星期日，这一点很明确。因此，日期"W1707.7"和"W1708.0"是同一天。

为了向后兼容以前的版本，截止日期也可以在方括号内给出，如"[d: yyyy-mm-dd]"。此形式还支持更模糊的格式，例如"dd/mm"。不再建议使用此形式，最好使用上述明确的形式。

复选框列表中的任务也可以有子项。这有助于将复杂任务分解为一步一步的行动项目。例如：

☐ 组织派对 <2017-08-19 !
- ☐ 在月初发送邀请函 <2017-08 !!
- ☐ 清理客厅
  - ☐ 处理搬家箱 <2017-08-10
  - ☐ 购买吸尘器 <2017-08-15
- ☐ 购买食物和饮料

这些子项也将在任务列表中显示为主任务下的子项，以层次树的形式。请注意，没有明确截止日期或优先级的子项将从主任务继承这些属性。在此示例中，"清理客厅"和"购买食物和饮料"项目从主任务继承截止日期和优先级。"发送邀请函"将具有更早的截止日期和更高的优先级，因为它们是明确指定的。

在此示例中，"活动任务"列表将仅显示4个项目："发送邀请函"、"处理搬家箱"、"购买吸尘器"和"购买食物和饮料"。这4个代表可以采取行动的最低级别"下一步"。当您完成"处理搬家箱"和"购买吸尘器"任务时，"清理客厅"变为活动状态。这应该提示您要么执行并完成它，要么详细说明更多的子任务。

使用标签

使用任务列表的第二种方法是在笔记中使用"TODO"或"FIXME"等标签。标签可以出现在行的开头或直接在复选框之后。其余行的解析方式与复选框后的任务描述相同。因此，以下也将被视为任务：

FIXME: 完成前一段落

不同的标签可以类似于标记用于区分不同类别的任务。

作为特殊情况，标签可以用于标记整个列表是任务列表。在这种情况下，标签需要开始一个新段落，并且在第一个复选框之前单独占一行。当"将所有复选框视为任务"选项关闭时，这种用法特别有用。第一行上的任何标记都将应用于整个列表。但是，不应出现其他词，因为这会使第一行成为常规项目并导致列表被忽略。此用法的示例如下：

TODO: @家庭

☐ 打电话给Susan邀请她共进晚餐 <2017-05-01 !
☐ 打印菜单 @办公桌

现在两个项目都将附加"@家庭"标记。