Sublime Commandbox

一个用于在 Sublime Text 3 中运行 Commandbox 命令的插件，包括服务器管理和脚手架。

快速入门

1. 通过 Package Control 安装 Commandbox

安装

使用 PackageControl

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

只需键入 cmd-shift-p/ctrl-shift-p 来打开命令面板，然后从下拉菜单中选择 Package Control: Install Package，在那里搜索并选择 CommandBox 包，然后完成安装。

手动

您可以将仓库克隆到您的 /Packages（首选项 -> 浏览包...）文件夹中，并开始使用/修改它。

cd ~/path/to/Packages
git clone git://github.com/Ortus-Solutions/sublime-commandbox.git Commandbox

故障排除

如果您在 Mac OSX 上运行插件时遇到问题，可能是您的路径没有被您的 shell 报告。在这种情况下，尝试使用插件 SublimeFixMacPath。它可能会解决我们的问题。

如果您仍然无法正确运行，请首先确保您的 Commandbox 任务从终端运行（即，在 sublime 之外），如果是这样，请提交一个 问题。

用法

运行 Commandbox 命令

您可以从 菜单 -> Commandbox 选择预配置的命令，包括输入自定义命令的能力。

键盘快捷键

• Ctrl+Shift+B - 运行 Commandbox 命令：将打开一个提示，您可以在此处输入您的命令
• Ctrl+Shift+T - 启动嵌入式服务器：您的 Commandbox cwd 总是您的 Sublime 项目的根目录，因此将尊重任何 box.json 配置
• Ctrl+Shift+P - 停止嵌入式服务器
• Alt+P - 显示 Commandbox 输出面板（在 查看 -> Commandbox 菜单中也可用）
• Alt+[Command|Windows]+P - 隐藏命令框输出面板（也可在 查看 -> 命令框 菜单中找到）

设置

文件 Commandbox.sublime-settings 用于配置，您可以在 首选项 -> 包设置 -> 命令框 -> 设置 -> 用户 中更改您的用户设置。

默认设置：

{
    "exec_args": {},
    "results_in_new_tab": false,
    "results_autoclose_timeout_in_milliseconds": 0,
    "show_silent_errors": true,
    "log_errors": true,
    "syntax": "Packages/Commandbox/syntax/CommandboxResults.tmLanguage",
    "nonblocking": true,
    "check_for_boxjson": true,
}

exec_args

您可以如下覆盖您的 PATH 环境变量：

{
    "exec_args": {
        "path": "/bin:/usr/bin:/usr/local/bin"
    }
}

箱安装本地

如果箱在项目中本地安装，您需要指定箱可执行文件的位置。因此，请调整路径到 /bin:/usr/bin:/usr/local/bin:node_modules/.bin

results_in_new_tab

如果设置为 true，则将使用新标签页而不是面板来输出结果。

results_autoclose_timeout_in_milliseconds

定义自动关闭包含 Commandbox 结果的面板或标签页的延迟。

show_silent_errors

如果为 true，则只有在运行 Commandbox (silent) 任务失败时才会打开输出面板。

log_errors

如果发生错误，将切换 sublime-commandbox.log 的创建。

syntax

用于突出显示箱结果的语法文件。您可以从命令面板中选择，如 设置语法：Commandbox 结果。

如果您不想使用颜色（如果您正在移除语法，可能需要重新启动 Sublime），请将设置设置为 false。

nonblocking

当启用时，该包将使用两个线程从任务进程读取流，一个用于 stdout，另一个用于 stderr。这允许所有输出都在无需等待任务完成的情况下实时通过 Sublime 管道。

如果设置为 false，它将首先从 stdout 读取，然后从 stderr 读取。

绑定您自己的键盘快捷键

您可以使用快捷键来运行特定任务，如下所示：

{ "keys": ["KEYS"], "command": "commandbox", "args": { "task_name": "watch" } }

LICENSE

Sublime-CommandBox 是开源的，并且自 2014 年以来绑定到 LGPL v3 GNU LESSER GENERAL PUBLIC LICENSE 版权和商标，由 Ortus Solutions, Corp 管理。

本程序是免费软件：您可以在自由软件基金发布的 GNU 通用公共许可证（GPL）的条款和条件下重新分发和/或修改它，无论是许可证的第 3 版，还是（根据您的选择）任何更高版本。

本程序按“希望有用”的原则分发，但不提供任何保证；甚至不包括对适销性或特定目的适宜性的暗示保证。有关详细信息，请参阅 GNU 通用公共许可证。