imag - imag-pim.org

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

此应用程序处于早期开发阶段。有些功能是可行的，但我们目前不考虑任何稳定或可用的功能。无论如何，您可以自由地尝试。

使命宣言

我们的（长期）目标是

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

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

请参阅 文档 了解更多关于此的信息。

构建/运行

以下是如何尝试 imag 的方法。

imag 是一个 套件/集合 工具（例如 git），您可以单独构建每个 "模块"。

构建

使用 cargo build --all 构建所有 crate，通过指定 cargo 的 --manifest-path 标志来构建单个 crate。./bin 目录中的 crate 是实际的命令行工具，./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 文件！

联系方式

欢迎加入我们在 freenode 上的新 IRC 频道：#imag 或我们的 邮件列表。

许可证

我们选择根据 GNU LGPLv2.1 条款分发此软件。