Sublime Trello

这是一个为Sublime Text 3提供的包，它提供了一系列与Trello交互（通过Trello API）的命令。

用法

此包允许您使用Teambition API浏览Teambition提供的数据。它灵感主要来自于文件导航器包。

有关如何自定义插件的信息，请查看设置。

导航

如果您运行 Teambition: 导航命令，您将看到您的版块，然后您可以从那里进入Teambition元素结构（版块 -> 列表 -> 卡片 -> 操作）。

您可以在默认设置中找到 { "keep_navigate_open_after_action": true }。如果您愿意，您可以将其设置为false在您的用户设置中，这样面板在每次操作后都会关闭。

卡片创建

“快速创建卡片”和“带描述的创建卡片”

它试图在最后激活的列表中创建卡片。这里的《激活的`列表是指使用`Teambition: 导航`命令查看的最后列表。

如果您尚未使用`导航`，则该包将显示一个面板解释情况。

通知

运行`Teambition: 通知`您将获得两个选项：`未读`和`全部读取`。

未读通知

当您运行 `Teambition: 未读通知`时，您将看到当前用户拥有的未读通知数量，以及发生的情况的简短描述，例如

Total unread: 1

1) Nofitication type: commentCard
Card: Some Card
Board: Some Board

这可以大幅改进，但我认为它是可以理解的（稍微分析一下就能理解），我更愿意在让它更漂亮之前添加一些其他的东西（欢迎提交拉取请求！）。

全部读取通知

此命令将尝试读取您当前的所有未读通知。这可能会导致错误，因为需要更多权限。软件包将在一个面板中说明如何修复它（如果需要的话）。

缓存

默认情况下，大多数请求将进行缓存，以提高性能。当您执行需要重新加载元素的专项行动时，例如在列表中创建一张新卡片，软件包将尝试仅删除那个缓存，保留其余部分。

但是，如果您在网页版中进行了更改或偶然保留了缓存元素，更改将不会反映出来。

为了避免这种情况，您有两个选项：运行 “Trello: 删除缓存” 命令，该命令将清除缓存并重新请求所有内容；或者，您可以将 用户设置 中的 use_cache（默认为真）选项切换为 false，如下所示

{ "use_cache": false }

这不是一个好建议，因为软件包将请求每个请求的所有内容，但这是备用选项。

生成您的密钥

默认情况下，软件包使用仅用于此处的 Trello 应用生成的密钥。如果 token 不存在，软件包将弹出一个消息，说明如何获得它。

基本来说，由于 Trello 身份验证的方式，您需要将一个 URL 复制到浏览器中，并将结果粘贴到 用户设置 中的 token 属性，例如

URL

https://trello.com/1/connect?key={KEY}&name=sublime_app&response_type=token&scope=read,write

选项

{
    "key"   : "",
    "secret": "",
    "token" : "{token_goes_here}"
}

如果您不想使用默认应用，可以通过在 用户设置 中添加您自己的密钥和密钥（查看 默认设置 了解详情）来自定义它。您可以从 这里 获取它们。

另外，如果您希望只对您的账户中的一些内容进行访问，您可以在将 URL 粘贴到浏览器之前修改其作用域，例如从 &scope=read,write 更改为 &scope=read

所有设置

{
    // Key and secret to identify the app. If not present the default is used
    "key"   : "",
    "secret": "",

    // Access token to interact with the API (required)
    "token" : "",

    // Cache unchanged responses for better performance
    "use_cache": true,

    // After creating elements or performing an action on them the panel reopens (until exit is selected)
    "keep_navigate_open_after_action": true,

    // Use a new tab when showing the results. If it's false it'll use a panel (like the ST console)
    "results_in_new_tab": true,

    // Syntax to use when showing the text from a trello element
    "syntax_file": "Packages/Markdown/Markdown.tmLanguage",

    // Set the delemiter used to create more than one card at once in 'Create card with description'.
    // By default, if you place "<end>" after the card description placeholder you can create another card (as many as you want)
    "card_delimiter": "<end>"
}

快捷键

Windows 和 Linux

• 导航：ctrl+alt+t
• 未读通知：ctrl+alt+n

OSX

• 导航：super+alt+t
• 未读通知：super+alt+n

删除缓存和通知没有快捷键，但您可以在偏好设置 -> 键盘快捷键 - 用户中设置，通过添加以下内容来设置

{
    "keys": ["alt+d"], "command": "trello_delete_cache", 
    "keys": ["alt+n"], "command": "trello_notifications"
}

设置位置

偏好设置 -> 软件包设置 -> Trello -> 设置 - 用户

安装

PackageControl

如果您已安装 PackageControl，则可以使用它来安装此软件包。

只需输入 cmd-shift-p/ctrl-shift-p 来显示命令面板，然后从下拉菜单中选择 Package Control: Install Package。

然后输入 Trello 并从下拉菜单中选择此软件包。就是这样！

手动

您可以将仓库克隆到您的 /Packages （在选择偏好设置 -> 浏览软件包…）文件夹中，并开始使用/修改它。

cd ~/path/to/Packages
git clone git://github.com/NicoSantangelo/sublime-text-trello.git Trello

已知问题

Linux 用户需要 Curl（它应该在以下位置： /usr/local/sbin，/sbin，/usr/sbin，/usr/local/bin，/usr/bin，或 /bin）。

路线图

• 检查表
• 移植到 ST2？
• Trello API 的其余部分？
• 标签
• 不缓存请求
• 返回选项
• 卡片描述
• 从列表创建卡片
• 从董事会创建列表
• 创建董事会
• 当它在卡片评论列表中选择时，将其打印在某处（输出面板）

有什么建议吗？

• 非常欢迎拉取请求，您可以运行 AAAPT 软件包 或在终端（例如： cd path/to/Trello && python3 -m tests.test_output）中运行测试。

• 另一种方式是在 问题 中添加您的功能请求。

感谢

• Trollop Python 库
• 用于处理 httplib 的绝佳替换方案的Sublime Github 包

版权

版权所有 © 2013+ Nicolás Santángelo。

有关详细信息，请参阅LICENSE。