taskwiki

在 vim 中进行正确的项目管理。站在 vimwiki 和 Taskwarrior 的肩膀上

一个 |_ | _ | | \ \ / () | () 一个 ~ 命令行 | |/ ` / __| |/ /\ \ /\ / /| | |/ / | 个人 wiki ~ 待办事项列表 | | (| _ \ < \ V V / | | <| | 适用于 vim ~ ||_,|/|_\ _/_/ ||_|__| ~

安装

确保满足以下要求

Vim 7.4 或更新版本，支持 +python 或 +python3（也支持 NeoVim）
Vimwiki（dev 分支）

git clone https://github.com/vimwiki/vimwiki ~/.vim/bundle/ --branch dev

Taskwarrior（2.4.0 或更新版本），可以从源代码安装或使用你的包管理器

sudo dnf install task

tasklib（2.4.3 或更新版本）， Taskwarrior 的 Python 库。

sudo pip3 install tasklib

对于 neovim 用户： 请注意，如果你使用 neovim，pynvim 是必需的 python 3 提供程序

sudo pip3 install pynvim

Python2 支持

Taskwiki 正在逐步淘汰 Python 2 支持。未来的功能不再考虑 Python2 的兼容性。

安装 taskwiki

使用 pathogen（或类似的 vim 插件管理器），taskwiki 的安装简单如下：

git clone https://github.com/tools-life/taskwiki ~/.vim/bundle/taskwiki

但是，请确保你的系统满足上述要求。

要访问文档，运行 :helptags taskwiki 然后 :help taskwiki。

可选增强功能

以下可选插件可以增强并与 TaskWiki 集成。我至少推荐 AnsiEsc 插件 - 当 Taskwarrior 图表变得五彩缤纷时会更有趣！

vim-plugin-AnsiEsc 在图表中添加颜色支持。

git clone https://github.com/powerman/vim-plugin-AnsiEsc ~/.vim/bundle/

tagbar 提供 taskwiki 文件导航。

git clone https://github.com/majutsushi/tagbar ~/.vim/bundle/

vim-taskwarrior 启用网格视图。

git clone https://github.com/farseer90718/vim-taskwarrior ~/.vim/bundle/

工作原理

Taskwiki 通过在 Taskwarrior 中存储任务元数据来增强简单的 vimwiki 任务列表。Taskwarrior 使用纯文本数据文件作为后端，而 taskwiki 使用 Taskwarrior 作为后端。这使得 taskwiki 能够利用其强大的功能，如过滤、重复任务、用户定义的属性或钩子。

注意： Taskwiki 只处理使用星号 * 的检查列表。所有其他列表，即使用连字符 - 或井号 # 以及有序列表的列表，都不会被处理。这允许你定义与 Taskwarrior 无关的普通列表，甚至是 vimwiki 检查列表。

功能

单个任务

安装 Taskwiki

这样的任务在文件保存时会同步到 TaskWarrior。额外的元数据，如项目、标签、优先级，可以与此任务一起存储。

其中一些元数据会在 vim 中以可视化方式呈现，并在 vim 中表示发生变化时更新。

安装 Taskwiki !!! (2015-08-23 19:00)

任务列表

任务可以被分组 - 简单地写在一个块中。这有一个优点，即任何子任务都会被标记为父任务的依赖项。

结婚
找到女朋友
买戒指
求婚

视图端口

视图端口是一个带有嵌入任务查询（过滤器）的标题，生成相应的任务列表。这些任务可以被修改，更改将同步回任务数据。一个简单的视图端口可能如下所示：

== 家庭任务 | project:Home ==

或者如果你使用 markdown 语法，它将是

家庭任务 | project:Home

离开插入模式时，过滤器查询将自动隐藏。

保存时，这将生成匹配任务的列表，以树状方式呈现（尊重依赖关系）。

== 家庭任务 | project:Home ==

喂狗 (2015-08-08)
整理房子 !!
洗碗
向蜘蛛网宣战

添加（写入）到视图端口下的任务列表中的任务会继承其过滤器的默认值。

== 家庭任务 | project:Home ==

喂狗
整理房子 !!
洗碗
向蜘蛛网宣战
打电话给房东讨论租金支付问题 (2015-08-23) ^ 上面的任务将自动设置 project:Home

对于一些更复杂的过滤器，无法自动推导默认值。在这种情况下，你可以明确指定默认值：

== 紧急任务 | +OVERDUE or +urgent | +urgent == ^ 默认值定义

可以通过在视图端口上方按 [CR] 来检查视图端口。

预设标题

预设标题的语法类似于视图端口：

== 家庭任务 || project:Home ==

与视图端口相比，它不会生成相关任务的列表。相反，它为相应部分中的所有视图端口设置过滤器，并为所有新任务设置默认属性。

与视图端口一样，对于复杂的过滤器，可以手动给出默认属性。

== 家庭任务 || project:house or project:garden || project:house ==

多个级别的预设标题是链接的。所以你可以这样做：

== Taskwiki 开发 || project:Taskwiki ==

非任务注释 === 错误 || +bugs ===
错误 #42 === 功能 || +features ===
某个功能

这里两个任务都被分配了 Taskwiki 项目，以及各自的标签。

报告分割

Taskwiki 可以为任务列表（选定的，或作为视图端口的一部分）和单个任务提供额外的信息报告。这些报告显示在动态临时分割中。

整理房子 !! (2015-08-23)

例如，在上述任务上按 [CR] 运行 :TaskWikiInfo 并显示：

名称值

ID 6 描述整理房子 2015-08-22 21:29:35 提示：使用扫地机器人进行真空清洁状态待处理项目 Home 录入时间 2015-08-22 21:27:26 (2 分钟) 截止日期 2015-08-23 00:00:00 最后修改 2015-08-22 21:30:21 (1 秒) 虚拟标签 ANNOTATED MONTH PENDING READY UNBLOCKED YEAR UUID 448c2fa9-6a06-454e-a2bc-b0c8ae91994f 紧急度 9.895 优先级 H

日期修改

2015-08-14 21:29:35 添加注释 '提示：使用扫地机器人进行真空清洁'。 2015-08-14 21:30:11 截止日期设置为 '2015-08-23 00:00:00'。

运行 :TaskWikiSummary 可以产生如下侧边分割：

项目剩余平均年龄完成 0% 100%

工作 18 4 周 74% ====================== 设计功能 X 3 4 周 89% ========================== 功能 Y 7 2 周 47% ========= 工单 5 3 周 79% ====================== 博客 1 4 个月 50% ===============

还有许多其他报告（燃尽图、日历、历史、项目、统计、摘要、标签等），但为了简洁起见，这里不会详细描述。它们的工作方式类似。