refined-bitbucket

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

📷 原文此处有图片，请前往 GitHub 仓库查看完整内容。

-

📷 原文此处有图片，请前往 GitHub 仓库查看完整内容。

-

📷 原文此处有图片，请前往 GitHub 仓库查看完整内容。
我们都知道 BitBucket 缺少一些我们在其他平台（如 GitHub、GitLab 等）中拥有的功能。最初受 Sindre Sorhus 的 Refined Github 扩展启发，refined-bitbucket 作为一个协作项目诞生，由少数开发者共同开发，以改进这些不足，甚至增加一些额外功能，从而提升整体用户体验。

订阅此问题以便您在更新时收到电子邮件通知。

当前功能

• 为拉取请求和提交添加语法高亮。完整的启用语言列表请参见这里，然后这里。在这里测试它们。缺少某种语言？告诉我或提交一个拉取请求！

• 从新 PR 界面的文件树菜单中移除空白（默认关闭，可在扩展选项中启用）

• 双击一个单词以高亮显示所有出现的地方。

• 阻止拉取请求在未达到最少审批数时合并（默认最低审批数为 2） 已移除。由 Bitbucket 通过“合并检查”原生实现

• 键位绑定功能，允许更快地在拉取请求中导航。

• 折叠拉取请求描述的按钮。

• 在拉取请求和提交视图中折叠差异的按钮。

• 自动折叠：

  • 在选项页面中添加您希望扩展在加载拉取请求或提交时自动折叠的文件名模式。
  • 删除的文件将自动折叠。

• 差异忽略。在选项页面中添加您希望扩展在加载拉取请求或提交时完全移除的文件名模式。

• 在侧边导航菜单中为打开或活跃的分支和拉取请求添加计数器。

• 在拉取请求和提交视图中加载所有失败差异的按钮。

• 在“比较分支和标签”页面添加“创建拉取请求”链接。

• 为您的拉取请求选择默认的合并策略。Bitbucket 也可以按项目原生实现

• 在创建或编辑拉取请求时，默认勾选“关闭锚定分支”复选框。

• 在拉取请求列表的每行中添加与拉取请求互动的最后一个人（提交、评论或批准）。

• 复制差异内容时不要将加号和减号带到剪贴板。

• 在“Commits”标签旁显示当前拉取请求的提交数量徽章。

• 在查看提交/拉取请求时设置代码的自定义制表符缩进大小（Bitbucket 默认值为 8 个空格）。

• 显示行长度限制标尺，默认为显示在第 80 列。

• 在差异头部插入“Comments”复选框以切换评论。

• 在差异头部插入“将文件名复制到剪贴板”按钮。

• 定义自定义 CSS 样式以应用于 Bitbucket。

• 差异中的 URL 和电子邮件会自动变为可点击的真实链接。

• 在仓库默认分支中包含一个 PULL_REQUEST_TEMPLATE.md 文件，在以下位置之一，该文件模板的内容将替换 Bitbucket 创建新拉取请求时插入的默认拉取请求正文。

  /PULL_REQUEST_TEMPLATE.md
  /docs/PULL_REQUEST_TEMPLATE.md
  /.github/PULL_REQUEST_TEMPLATE.md
  /.bitbucket/PULL_REQUEST_TEMPLATE.md

  请注意，文件名是区分大小写的（必须全部大写），并且必须使用 .md 文件扩展名。其他文件扩展名将不被识别。要使用的文件将是从这些位置中（从上到下）找到的第一个文件。

  也可以在选项页面中为包含模板内容的原始 Gist 指定一个 URL，以防你不想将文件包含在你的仓库中，例如：https://gist.githubusercontent.com/anonymous/8054a3ee32f7cf1a5975e3fd52b3c5f3/raw/f6897720e8b6b93becd246187dac36038291c3a4/PULL_REQUEST_TEMPLATE.md。

  注意：目前，Firefox 插件不支持在 BitBucket 域之外托管的外部拉取请求模板。

• 类似于拉取请求模板功能，现在可以配置扩展，将拉取请求的默认合并提交消息替换为一个模板，该模板可以访问动态注入的变量，例如拉取请求标题、描述、源分支和目标分支等。
  点击这里了解更详细的说明

• Diff 的粘性标题。在查看大型 diff 时向下滚动，diff 的标题，包括文件名和操作，将保持可见。

一些图片

        语法高亮

        拉取请求列表（注意源分支名称和创建日期）

        选项页面。

        忽略差异和加载所有差异

        忽略差异

        加载所有差异

        折叠差异

        出现高亮

        侧边栏计数器

        展开

        折叠

        粘性标题

        Line length limit ruler

        紧凑型 PR 文件树

        Show total lines added and removed for a pull request

安装

refined-bitbucket 可在 Google Chrome 网上应用店 和 Firefox 附加组件 上获取。安装后，请检查扩展的选项以根据您的需求进行自定义。

有时浏览器在安装扩展后不会立即识别它。如果发生这种情况，请退出 Bitbucket 然后重新登录，或清除缓存。

默认按键映射

以下是默认的按键映射

标签选择

页面导航与滚动

大写字母表示需要按住 shift 键再按该字母

我可以在 Bitbucket Server 上使用这个吗？

可惜不行 :(。虽然 Bitbucket Server 和 Bitbucket Cloud 名称相似，但它们实际上是两个完全不同的产品。 阅读此评论以获取更详细的解释。

编译与贡献

非常感谢您的贡献！即使您无法通过拉取请求贡献，如果您遇到任何奇怪的行为或错误，也请通过 issue 告诉我们！

如果您想运行扩展的开发版本，请克隆仓库并运行以下命令：

npm install
npm run watch

这将监视 src 文件夹中的任何更改，并将它们编译到 extension 文件夹中。

Chrome 开发

要在 Chrome 中测试，请在 chrome://extensions 启用开发者模式，点击“加载已解压的扩展程序...”，然后浏览到该文件夹。
如果您是 Chrome 扩展开发新手，请花些时间阅读 Google 的 扩展文档。

Firefox 开发

要在 Firefox 中测试，请在新标签页中打开 about:debugging，点击“加载临时附加组件”。导航到扩展文件夹并加载 manifest.json。有关更多 Firefox 附加组件开发和调试帮助，请参考 Mozilla 的 文档。

集成

包含了测试套件。在发送拉取请求之前，请通过运行以下命令确保所有测试都已通过：

npm test

许可证

MIT © refined-bitbucket