发布文章到 Bitbucket

连接一次 Bitbucket，你就可以将任何 Clevera 文章作为 Markdown 文件发布到 Bitbucket 存储库中，随时可用于文档站点或代码旁边的 docs/ 文件夹。本文介绍了如何连接、选择存储库和文件夹、文件外观以及更新的工作方式。

开始之前#

• 计划： 发布到 Bitbucket 是 Pro 和 Custom 计划的一部分。在 Free 和 Starter 计划中，发布选项卡会显示“发布到你的工具中已包含在 Pro 计划内”。请参阅 选择计划。
• 在 Clevera 中的角色： 只有工作区所有者或管理员可以连接或断开 Bitbucket。连接后，任何可以编辑文章的人都可以发布它。
• 仅限 Bitbucket Cloud： Clevera 连接到 bitbucket.org。不支持 Bitbucket Data Center 和 Server。
• Bitbucket 中的访问权限： 连接的账户必须能够向你想要发布的存储库贡献内容，并拥有主要分支的写入权限。
• 文章： 你发布的是属于视频或录制内容的文章。请先生成它；请参阅 将录制内容转换为文章。

发布不消耗积分。

连接 Bitbucket#

1. 打开集成#

   在侧边栏中，打开工作区菜单并选择集成。在可用集成（或开发选项卡）下找到 Bitbucket，然后点击连接。

2. 在 Bitbucket 中授予访问权限#

   如果尚未登录，请登录 Bitbucket。Bitbucket 会要求你授予 Clevera 访问权限：

   Bitbucket 权限	原因
   账户：读取	以便在 Clevera 中显示你的 Bitbucket 名称
   存储库：读取	以列出存储库并检查文件是否已存在
   存储库：写入	以提交 Markdown 文件及其图片

   点击授予访问权限。

3. 检查连接#

   你将返回到集成页面，并看到“Bitbucket 已成功连接到”以及你的 Bitbucket 名称。Bitbucket 会移动到已连接列表，并带有已连接徽章。在你发布任何内容之前，它会显示“尚未发布任何内容”。

发布文章#

1. 打开发布选项卡#

   在编辑器中，点击分享并打开发布选项卡。在发布文章下，点击准备发布下方的 Bitbucket 图块。

   文章将以你在编辑器中打开的语言发布。若要发布翻译版本，请先在顶部栏切换语言。

2. 选择存储库和文件夹#

   在发布位置下，选择：

   字段	选择内容	说明
   存储库	文件的 Bitbucket 存储库	你可以贡献内容的存储库，跨越你的 Bitbucket 工作区，按最近更新排序。第一个存储库会被自动选中
   文件夹	路径，例如 docs 或 articles/guides	“Markdown 文件在此处创建。留空则表示存储库根目录。” 默认为 docs。尚不存在的文件夹会被自动创建

   Clevera 会记住你下次的选择。

   

3. 发布#

   点击发布到 Bitbucket。你将看到“正在 Bitbucket 中查找现有副本”，然后是正在写入页面。完成后，你将看到“已发布到 Bitbucket”。点击在 Bitbucket 中打开以查看文件。

   你可以在发布过程中关闭分享窗口；完成后会有通知提醒你。

文件去向#

• 分支： 存储库的主要分支（通常为 main 或 master）。Clevera 直接提交到该分支；它不会打开拉取请求，你也不能选择其他分支。
• 文件名： 标题的小写形式，空格转换为连字符，以 .md 结尾。“Create your first invoice” 将变为 create-your-first-invoice.md。其他脚本或带有重音符号的标题会先拼写为拉丁字母（“Créer une facture” 变为 creer-une-facture.md）。如果标题无法拼写（例如仅由表情符号组成），则会获得一个简短的固定代码（article- 加 8 个字符）。名称会被截断为 80 个字符。
• 图片： 文章的截图会放入同一文件夹内的 assets/<file name>/ 中，并在同一次提交中完成。
• 提交信息： Add article: <title>，或在更新现有文件时为 Update article: <title>。
• 提交作者： 连接该集成的 Bitbucket 账户。

分支限制#

如果存储库对其主要分支有分支限制（例如，更改只能通过拉取请求，或写入仅限于特定人员），Clevera 的提交将被拒绝，例如显示“你需要写入权限才能提交到此 Bitbucket 存储库”。请在存储库设置 → 分支限制下将已连接的账户添加到可以写入该分支的人员列表中，或者发布到没有该规则的存储库中。

文件外观#

Clevera 编写的是 Bitbucket 文件视图可以显示的纯 Markdown，顶部带有一个简短的 front matter 块。它不包含原始 HTML，因为 Bitbucket 不会渲染它。

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

文章来源的视频不会添加到文件中。放置在文章内的 Clevera 视频仅在开启视频分享链接时才会成为指向其播放器的链接。请参阅 在文章中显示视频。

图片#

截图会与文件一起提交到你的存储库中，Markdown 通过相对路径 (assets/<file name>/…) 链接到它们。即使没有 Clevera，它们也能正常工作；在私有存储库中，它们会像其他内容一样保持私密。

你上传到文章中的视频文件不会被提交。它仍然是一个指向 Clevera 的链接，一段时间后会过期；再次发布以更新它。

与文档站点配合使用#

如果静态站点生成器（如 MkDocs、Docusaurus 或 Hugo）从存储库构建你的文档，请将文件夹指向它读取的文件夹。每次发布都是一次正常的提交，因此 Bitbucket Pipelines 或你的其他构建运行如常。大多数生成器会从 front matter 中读取 title 并忽略它们不知道的字段。

更新已发布的文章#

发布是单向的。你在 Clevera 中所做的编辑会保留在 Clevera 中，直到你再次发布；而在 Bitbucket 中对文件所做的更改永远不会同步回 Clevera。

当你发布到同一个存储库和文件夹时，Clevera 会找到同名文件并显示“此文章已在 Bitbucket 中”。点击查看它以打开现有文件，然后选择：

如果标题在 Clevera 中发生了更改，文件名也会更改，因此发布会创建一个旧文件旁边的新文件。请自行删除或重命名 Bitbucket 中的旧文件。Clevera 不会删除你存储库中的任何文件。

断开 Bitbucket 连接#

1. 打开集成，点击 Bitbucket 行上的 ⋯ 菜单并选择断开连接（或点击 Bitbucket 然后点击断开连接）。
2. 确认。“你将无法再从编辑器发布到该工具。你已经发布的内容将保留在 Bitbucket 中。”

断开连接会删除 Clevera 的令牌。若要同时撤销 Clevera 在 Bitbucket 上的访问权限，请打开你的 Bitbucket 个人设置，前往应用授权并撤销 Clevera。

故障排查#

相关内容#