將文章發布至 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 會直接提交至該分支；它不會開啟提取請求 (pull request)，且您無法選擇其他分支。
• 檔案名稱： 小寫標題，空格改為連字號，並以 .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 不會渲染 HTML。

---
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。

疑難排解#

相關內容#