Lazy Time Tracker 测试版 v0.5.0

为所有懒惰的我们提供的Sublime Text时间跟踪器

注意： 这是一个测试版。我对跟踪您的时间丢失不承担责任。我现在正在使用它，所以我非常希望使其成为最佳的。

注意： 我目前正在ST3上测试它，并在ST2上最小限度地测试过。我还在OSX上测试过它。如果有慷慨的人愿意为我测试，我将非常感激。

工作原理

这个时间跟踪器基于保存项目中的一个文件。我不会解释Sublime项目。如果您正确设置了以下描述的Sublime项目设置，那么每当您在那个项目中保存文件时，跟踪器都会“记录”它。跟踪器将持续累加时间直到以下三种情况之一发生。1) 您在此打开的项目外保存文件。2) 使用super+ctrl+w关闭项目。3) 退出Sublime。

设置

首先，您需要设置插件设置。一开始您真正需要关心的是"log_folder"设置。这是您想要保存日志文件的文件夹。选择一个位置，它会出现在那里。并确保它是完整路径并且以/结尾。其他的设置如下所述。如果您不更改这个设置会发生什么。它会将文件添加到您的家目录中。您只需要将它们移动到您最终添加到此设置的文件夹，一切都将正常。

您需要在您所有项目的 .sublime-project 文件中设置至少一项。在项目文件的设置部分，您可以添加 "项目标题" 项。项目标题是您想要保存时间的名称。跟踪器还将所有保存的操作组合到项目名称下，因此如果您想在多个文件保存之间跟踪，它可以做到这一点。如果您没有设置项目标题会发生什么？它将分别记录您所有的文件，并且每次保存不同的文件时，它都会在日志中添加一行。

简而言之

• 在此扩展包的 .sublime-settings 文件中设置要保存日志的文件夹。
• 在每个项目的 .sublime-project 文件夹中设置项目名称。

输出

此跟踪器将日志保存到文件中。无需注册任何服务或连接到互联网。它可以保存到 .txt 文件或 .json 文件中。如果您选择，它可以同时保存两种格式。

txt 文件的输出如下

Project: Awesome Project - Time: 6:38:40 - Date: 07/20/1969
  * FirstSave: 1969-7-10 16:17:40
  * LastSave: 1969-7-10 22:56:20
    - awesomeProject/land.md
    - awesomeProject/step.md

json 文件的输出如下（格式化过的）

{
    "LastSave": "1969-7-10 22:56:20",
    "ProjectName": "Awesome Project",
    "FirstSave": "1969-7-10 16:17:40",
    "FilesSaved": [
      "awesomeProject/land.md",
      "awesomeProject/step.md"
    ],
    "Time": "6:38:40",
    "Date": "07/20/1969"
  },

查看输出

显然，您可以打开这些文件并像阅读任何其他文件一样阅读日志。但为了方便，有一个内置的方式可以查看日志文件。

默认情况下，super+ctrl+t 被设置为显示日志。但是，如果您想更改它，您可以使用这个来设置其他快捷键

{"keys": ["super+ctrl+t"], "command": "display_lazy_time_tracker"},

当您使用 txt 输出选项时，它将打开日志文件。

当您使用 json 输出选项时，它将加载 json 并创建一个临时视图以美好地显示 json。

所有设置

在上述初始设置之后，还有一些更多可以配置以获得更好体验的设置。就像上面一样，有两个设置区域，插件设置和项目设置。

插件设置

目前只有三个插件设置：log_folder、log_file_name 和 log_file_format。

• log_folder：我们上面讨论过，但这是要将日志文件放进去的文件夹。这可以是您电脑上的任何现有文件夹。
• log_file_name：如果您不想使用默认的文件名，可以更改它。不要添加扩展名，它会根据下一个设置自动确定。
• log_file_format：目前只有两种文件格式可用：JSON 和 txt。您可以使用其中一个或两个。对于两者，您需要将它们以数组的形式列出，如默认设置所示。

以下是一个示例配置

{
    "log_folder": "/Users/username/Dropbox/LazyTimeTracker/",
    "log_file_name": "timetracker",
    "log_file_format": "json", // can be "json", "txt", or ["json", "txt"]
}

项目设置

目前只有两个项目设置：ProjectTitle 和 ProjectPath。

• ProjectTitle：如上所述，此设置将文件分组并标注存放在单个时间块下的文件。
• ProjectPath：此跟踪器通过文件的完整路径跟踪您保存的哪些文件。如果您不需要完整路径设置，将此设置为文件的路径的一部分将截断匹配的部分，以便不必记录全部信息。这只是一个方便的功能。

以下是一个完整的 sublime 项目文件的示例。

{
    "folders":
    [
        {
            "follow_symlinks": true,
            "path": "."
        }
    ],
    "settings":
    {
        "ProjectPath": "/Users/username/Dropbox/projects/",
        "ProjectTitle": "Awesome Project"
    }
}