jrnl

jrnl是一个个人日记管理应用程序。

用法

设置

通过打印配置文件设置您的日记，如下所示

jrnl --setup

并填写日记根目录的路径。

使用jrnl

使用以下命令打开今天的日记条目

jrnl

这将使用您喜欢的文本编辑器打开今天的日记条目。

使用jrnl grep

jrnl还附带了一个grep包装器，您可以按照以下方式调用它

jrnl grep [OPTIONS] PATTERN

其中 OPTIONS 是正常的 grep选项。

高级用法

时间戳

您可以通过使用 -t 标志在打开条目之前生成时间戳

jrnl -t

或者您可以在配置文件中指定以始终写入时间戳。

负日期偏移量

您可以通过指定一个日期作为参数来打开另一个日期的日记条目。一种方法是通过负日期偏移量：例如，要打开昨天的日记，请运行

jrnl -1

模糊日期

另一种将日期传递给jrnl的方法是使用日期字符串（如果包含空格则用引号括起来）。jrnl使用 dateutil 的模糊日期解析器来解析您传递的字符串，这使得您可以指定如 "Nov 7 2017" 之类的日期

jrnl "Nov 7 2017"

dateutil可以做更多：例如，使用以下命令指定当前月份的第四天

jrnl 4

访问最新现有条目

您可以使用 HEAD 打开最新的现有日记条目，如下所示

jrnl HEAD

HEAD 的别名有 LAST 和 LATEST — 所有这些都不区分大小写。

访问现有条目的祖先

您可以使用后缀 ^ 或 ~N（N 表示第 N 个祖先）来访问现有条目的祖先。这些后缀几乎与 git 中的相同后缀相同。例如，要找到第五个最后存在的日志条目，您可以这样做

jrnl HEAD~5

这些后缀可以以您喜欢的任何方式进行堆叠和组合。

访问给定日期最近的现有条目

要访问给定日期最近的日志条目，请将 @ 后缀添加到日期。例如，要找到与 2017-01-01 最近的条目，您将这样做

jrnl @2017-01-01

打开多个条目

要打开多个条目，只需传递多个日期参数。例如

jrnl -7 "Jan 01 2016" 20180504

将打开一周前、2018-01-01 和 2018-05-04 的条目。

将日期延长到午夜之后

如果您的配置文件中包含

hours_past_midnight_included_in_date: N

其中 N 是某个正整数；那么对于给定日期，在 0N:00 或更早的时间，jrnl 将打开前一天的新闻条目。

:confused: 什么？以下是动机

当时间是 02:00 时，我们可能会将这个时间称为夜晚，而不是早晨。同样，您可能希望 02:00 写入的日志块（缺乏更好的术语）与（技术上）前一天的数据块在同一条目中。如果您确实想要这样的东西，您可以在配置文件中指定一个时间：在指定时间之前（包括）的任何时间，jrnl 都将打开前一天的日志条目。

日志结构

目前，您必须有一个类似这样的日志结构

journal_root/
journal_root/2017/
journal_root/2017/2017-07-05.txt
journal_root/2017/2017-09-01.txt

如果您想使用所有功能，您将需要接受基于 ISO 8601 的时间戳

2017-09-01
21:06

You'd write stuff here.

22:30

And more stuff here.

我如何安装它？

sudo pip3 install jrnl-mw

或直接运行 run_jrnl.py 脚本。