imag - imag-pim.org

imag是一个命令行个人信息管理套件。

此应用程序处于早期开发阶段。有些功能是可用的，但我们目前不认为有任何东西是稳定或可用的。无论如何，请随意尝试。

使命宣言

我们的（长期）目标是

创建一个快速、可脚本化、以命令行为首、仅纯文本的工具套件，涵盖个人信息管理的各个方面。

是的，imag是一个相当雄心勃勃的项目，因为它试图重新实现几个“个人信息管理方面”的功能。我们尽可能使用标准，如vcard、icalendar等。

有关更多信息，请参阅文档。

构建/运行

以下是尝试imag的方法。

imag是一组工具（例如，就像git一样）的套件，并且您可以单独构建每个“模块”。

构建

使用cargo build --all构建所有crates，通过指定cargo的--manifest-path标志来构建单个crates。./bin中的crates是实际的命令行工具，./bin/core包含imag的核心命令集（在git中称为“管道”），./bin/domain包含特定领域的imag命令，例如待办事项工具或书签工具。

运行

构建您想要尝试的模块后，您可以使用--help标志调用二进制文件本身，以获取有关该模块能做什么的一些帮助。

如果您已安装该模块，您可以选择调用imag-<modulename>（如果安装目录在您的$PATH中），或将imag二进制文件安装以调用imag <modulename>（如果所有内容都在您的$PATH中）。调用imag --help以查看哪些模块被发现并可使用。调用imag --versions以打印所有模块的版本。

示例用法

由于imag是一个庞大且复杂的项目，我们无法在此展示套件中的所有工具。但为了给您一些概念，这里有一个示例

# Lets initialize imag
imag init

# Recursively import vcf files
imag contact import /home/user/contacts

# Create a contact (vcf) in the private collection
imag contact create --file /home/user/contacts/private

# Add a diary entry
imag diary -p private create

# Uh, I forgot something in a diary entry, select one (or multiple) and edit it
# use the `fzf` tool here (not a part of imag) to select from the IDs
imag diary -p private list | fzf -m | imag edit

# Link a contact to the diary entry
imag link diary/private/2018/01/01/00:00:00 contact/bc222298-casf-40a4-bda1-50aa980a68c9

# Annotate a contact with some notes
imag annotate add contact/bc222298-casf-40a4-bda1-50aa980a68c9 contact-notes

# Write down some notes named "pineapple"
imag notes create "pineapple"

# Where was that contact again?
imag grep Eva # also possible with `imag contact find Eva`

# Okay, we need to add some imag-internal notes to that contact
imag grep Eva -l | imag edit

# Now save our work
imag git add . # "imag-git" simply calls git in the imag store
imag git commit -m 'Commit message'

保持更新

我们有一个imag的官方网站，我在那里发布发布说明和每月（大致）更新，这些更新发生在源树中（RSS在这里）。

我们还拥有一个邮件列表，我在那里发布更新，并鼓励讨论和提问。

文档

我们在./doc子树中提供了一些文档，可以使用pandoc编译成PDF或网站。不过，可能不是最新的。最后一个发布的开发者文档可在docs.rs上找到。

请贡献！

我们在寻找贡献者！请随意通过邮件列表打开问题，提问、建议功能或其他事项！

也请查看CONTRIBUTING.md文件！

联系

请自由加入我们的新IRC频道freenode: #imag或我们的邮件列表。

许可

我们选择在GNU LGPLv2.1的条款下分发此软件。