Plain​Tasks

PlainTasks

为Sublime Text（2 & 3）编辑器提供显式待办事项列表插件

安装

要安装此插件，您有两种选择

1. 如果您已安装包控制，只需搜索 PlainTasks 进行安装。

2. 将源代码克隆到Sublime Text包件文件夹。

开始新的待办事项列表

打开命令面板（在OS X中为 ⌘ + shift + p，在Windows中为 ctrl + shift + p）并输入 task，然后选择 任务：新建文档 命令。

注意： 将您的待办文件保存为 todo、todolist、tasks 或 taskpaper 文件扩展名，或直接命名为无扩展名的 TODO。为了更便携，您可以使用 todolist.txt，既可以作为文件名，也可以作为任意文件名的后缀。

用法

注意： 在Windows或Linux中，使用 ctrl 代替 ⌘

☐ ⌘ + enter 或 ⌘ + i：新建任务

☐ ⌘ + d：切换任务为完成。

☐ ctrl + c：在Mac上切换任务为取消。在Windows/Linux上为 alt + c。

☐ ⌘ + shift + a 将完成的任务存档，通过从列表中删除它们并将它们附加到文件的底下的归档项目

☐ ⌘ + shift + o 以Org-Mode风格存档，删除光标后的整个子树并附加到原始文件旁边的新的文件中，例如，如果原始文件为 filename.TODO，则新文件为 filename_archive.TODO

☐ ⌘ + shift + u 在您的默认浏览器中打开光标下的URL，除了http(s)方案外，其他方案必须用 <> 包围，例如 <skype:nickname>

☐ 行尾带有冒号的任何内容都是项目标题，您还可以通过缩进来嵌套项目。

☐ 您可以在任何地方写入纯文本作为备注或描述。使用 _ 或 * 来表示斜体和加粗，就像在Markdown中使用一样。

☐ 您可以使用 @ 符号添加标签。
您可以将光标放在标签上，点击鼠标右键，然后 根据光标下的标签进行过滤：具有所选标签的待办事项将保持可见（以及它们的相关备注和所属项目），而其他所有内容都将隐藏/折叠；要展开所有内容，请按 ⌘+k、⌘+j 或 ⌘+k、⌘+0

☐ 您可以通过 ⌘+shift+r 在当前文档中导航标签。

☐ PlainTasks 随附一个简单的片段用于创建分隔符，如果您觉得待办事项列表太长，可以使用此片段将其拆分为几个部分（并折叠其中一些）。

-- 然后按 tab 键将给出这个：--- ✄ -----------------------

☐ 完成规则（通过 ctrl+space 或 alt+/ 来查看规则列表）

• 输入 t，然后按 tab — 它将变成 @today — 此标签与其他标签的突出显示方式不同；
• c，按 tab — @critical；
• h，按 tab — @high；
• l，按 tab — @low；
• s，按 tab — @started — 再次按 tab 将插入当前日期，当您完成或取消带有此类标签的任务时，您将知道已经过去了多少时间；如果必须更改完成/取消/开始的时间，则可以在光标置于标签上时按 tab 键来重新计算在任务上花费的时间；
• tg，按 tab，再按 tab，其工作方式与 s 相同，但插入 @toggle(当前日期) — 因此，您可以在完成/取消时暂停和恢复以获得更准确的结果；每个切换标签在其序列中的位置取决于它是有暂停还是继续；
• cr，按 tab，再按 tab — @created(当前日期) (⌘ + shift + enter 用此标签创建一个新的任务)；

• d，按 tab — @due( )
  如果您再次按 tab，它将插入当前日期，这同样适用于 @due( 0)。
  您可以输入简短日期（类似于 OrgMode的日期提示，但略有不同），然后按 tab键以展开为默认格式。
  简短日期应为 _@due(year-month-day hour:minute)__
  点可以用作连字符的替代，但应保持一致 _year.month.day

  • 年、月、分钟、小时都可以省略

    表示法	含义
    @due(1)	下一个月的第一天始终
    @due(--1)	当前月的第一天始终
    @due(5)	当前月或下一个月的第五天（如果当天已经是第五天或更早）
    @due(2-3)	当年或下年的2月3日
    @due(31 23:)	当前月或下月的最后一天，如果当前小时的分钟数等于当前时间
    @due(16.1.1 1:1)	2016年1月1日01:01 @due(16-01-01 01:01)

  • 相对于时间段的时间和长度从加号开始
    __+[+][number][DdWw][h:m]__ — 数字和字母 d（表示天）或字母 w（表示周）都是可选的。

    表示法	含义
    @due(+)	明天以及 @due( +1) 或 @due( +1d)
    @due(+w)	自当前日期起一周，即 @due( +7)
    @due(+3w)	自当前日期起三周，即 @due( +21d)
    @due(++)	自 @created(日期) 以来的一天，如果有的话，否则等于 @due(+)
    @due(+2:)	自当前日期起的两小时
    @due(+:555)	自当前日期起的555分钟
    @due(+2 12:)	自当前日期起2天12小时

☐ 您可以通过在文件名前加点和反斜杠来在您的项目内创建一个指向文件的链接，例如：.\filename\ 或 ./another filename/。
线号和列号可以通过冒号指定：.\filename:11:8。
在 SublimeText 3 中，您可以通过使用 > 字符来指定文件中的一个符号：.\filename>symbol。
在 SublimeText 2 中，您可以通过使用英寸字符来指定文件中的文本，例如：.\filename"任何文本"。
按下 ctrl + o （Windows/Linux上是 alt + o）将在 Sublime 中打开文件，如果有的话，会滚动到指定位置。
此外，在 SublimeText 3 中，链接也可以指向目录，打开此类链接将把目录添加到当前项目（侧边栏）中。
此外，还支持 Markdown 和“wiki”样式（Org-Mode、NV 等），示例

[](path)
[](path ":11:8")
[](path ">symbol")
[](path "any text")
[[path]]
[[path::11:8]]
[[path::*symbol]]
[[path::any text]]
[[path]] ":11:8"
[[path]] ">symbol"
[[path]] "any text"

☐ 将当前文档转换为 HTML，请打开命令面板 ⌘ + shift + p 并输入 Tasks: View as HTML —— 它将在默认的网页浏览器中打开，这样您就可以查看和保存它了。
Tasks: Save as HTML… 将询问您是否要保存，如果是，将允许您选择目录和文件名（但不会在网页浏览器中打开）。

编辑器有用工具

☐ 使用 ⌘ + control + 上/下 （Windows 上的 ctrl + shift + 上/下）来移动任务上移或下移。

☐ 使用 ⌘ + r 来查看项目列表并快速在这些项目之间切换

★ 更详细的信息请参阅 教程。

设置

PlainTasks 是一个具有偏见的插件，这意味着它已经高度配置，以便以特定方式显示，但这并不意味着您无法对其进行自定义。如果您觉得某些东西看起来不合适，并且想要更改它，您可以在用户设置文件中轻松地进行修改。

转到 偏好设置 → 插件设置 → PlainTasks 并打开 设置 - 用户，那里您可以覆盖所有默认设置，为了获得一些灵感，您可以查看 设置 - 默认。

以下是一个 PlainTasks 的特定设置列表

¹ Icon 值可以是 "dot"、"circle"、"bookmark"、"cross"、"" 或自定义相对路径到现有的 png 文件，例如 "Packages/User/my-icon.png"。

更改颜色方案

如果你不喜欢捆绑方案中使用的颜色，只需从 PlainTasks 复制任何 .hidden-tmTheme 到你的用户目录，更改颜色，然后在用户设置文件中粘贴下面的代码

{ "color_scheme": "Path to your custom color scheme file. e.g. Packages/User/custom_plaintasks.hidden-tmTheme" }

注意。有时你必须重启 Sublime Text 才能在 tmTheme 文件中应用更改。

注意。scope_past_due、scope_due_soon 和 scope_misformatted 设置可以分配 tmTheme 文件中定义的任何范围，例如，你可以设置 "scope_past_due": "my.own.super.expired.whatever"，然后在 tmTheme 中为此范围添加样式定义。

Taskpaper 兼容性

如果你需要保持文件与 Taskpaper 兼容，前往 首选项 → 软件包设置 → PlainTasks，并打开 设置 - 用户，然后将这些设置添加到 json 文件中

{
  "translate_tabs_to_spaces": false,
  "date_format": "(%y-%m-%d)",
  "taskpaper_compatible": true
}

拼写检查

这是 Sublime 内置的功能，你可以用 F6 切换拼写检查。
出于方便起见，你可以在 首选项 → 设置 - 用户 的忽略单词列表中添加项目符号，例如。

{
  "ignored_words": [ "☐", "✔", "✘", "✄" ]
}

[额外奖励] 自定义 todo 图标

PlainTasks 带有自定义的 todo 图标，你可以在 icons 文件夹中找到它。你可以将其分配给你的 todo 文件，以改善它们的观感并将其与其他纯文本文件区分开来。在操作系统中通过 Google 搜索如何将自定义图标分配给文件类型。

[额外奖励] 自定义统计

当前文件的统计结果显示在状态栏中，基于默认的 stats_format，即 "$n/$a done ($percent%) $progress Last task @done $last"——正如你所看到的，它只是一个包含特殊指令（见下表）和常规字符的字符串。

您可以按自己的喜好自定义，通过添加到设置 - 用户，例如：

{
    "stats_format": "☐$o ✔$d ✘$c",

    // if you want the statistics do not include the archived tasks:
    "stats_ignore_archive": true
}

复制统计信息

打开命令面板并输入任务: 复制统计信息。

进度条附加设置

{
    "bar_full": "■",   // any char
    "bar_empty": "☐", // any char

    // if you want to avoid Unicode when copy stats — you can define replacements
    // e.g. to convert ■■■■■■☐☐☐☐ to [======    ]
    "replace_stats_chars": [[" ■", " [="], ["■", "="], ["☐ ", " ] "], ["☐", " "]]
}

PlainTasks屏幕录制介绍

PlainTasks用于其他编辑器

注意：这些是独立的项目，由我们以外的其他出色开发者维护。 - Atom: 任务插件 - Vim: Plaintasks.vim - Visual Studio Code: To Do Tasks - Visual Studio Code: Todo+

贡献者

• @antonioriva
• @binaryannie
• 本·约翰逊
• 克雷格·坎贝尔
• 多米尼克·瓦利
• Germain M. Bravo
• Hindol Adhya
• Jesse Robertson
• 马克·施拉赫
• 迈克尔·麦克法兰德
• 帕布洛·巴里奥斯
• 斯坦尼斯拉夫·帕夫洛尼乌克
• 沃瓦·科尔博克

您可以在github上做出贡献

灵感和来源

• 感谢Chagel提供的iTodo插件。
  
• 感谢Taskmate for TextMate。
• 感谢来自hogbaysoftware.com的TaskPaper Mac应用程序

许可证

版权所有 2012-2013 艾伦·巴基。在MIT许可证下许可