發布文章到 GitHub

連接一次 GitHub，你就可以將任何 Clevera 文章以 Markdown 檔案形式發布到儲存庫中，隨時可用於文件網站、Wiki 風格的 docs/ 資料夾或 README 集合。本文涵蓋了連接方式、選擇儲存庫與資料夾、檔案外觀以及更新運作方式。

開始之前#

• 方案： 發布到 GitHub 是 Pro 和 Custom 方案的一部分。在 Free 和 Starter 方案中，發布標籤頁會顯示「發布到你的工具包含在 Pro 方案中」。請參閱 選擇方案。
• 在 Clevera 中的角色： 只有工作區擁有者或管理員可以連接或中斷連接 GitHub。一旦連接，任何可以編輯文章的人都可以發布它。
• GitHub 中的存取權限： 進行連接的人員需要對你想要發布到的儲存庫擁有寫入權限，並有權在該個人帳戶或組織上安裝 GitHub App（或由組織擁有者批准）。
• 文章： 你可以發布屬於影片或錄製內容的文章。請先生成它；請參閱 將錄製內容轉為文章。

發布不會消耗點數。

連接 GitHub#

1. 開啟整合#

   在側邊欄中，開啟工作區選單並選擇整合。在可用整合（或開發標籤頁）下找到 GitHub，然後點擊連接。當你將游標指向該卡片時，按鈕就會出現。

   

2. 在 GitHub 上授權 Clevera#

   GitHub 會要求你授權 Clevera AI 應用程式。它會請求讀取你組織成員資格的權限，以便 Clevera 列出你所屬的帳戶。點擊授權。

3. 在你的儲存庫上安裝應用程式#

   接著 GitHub 會開啟 Clevera AI 應用程式安裝頁面。選擇你的個人帳戶或組織，然後選擇所有儲存庫或僅選擇儲存庫。該應用程式會要求以下權限：

   GitHub 權限	原因
   內容：讀取與寫入	用於建立和更新 Markdown 檔案及其圖片
   中繼資料：唯讀	GitHub 要求每個應用程式皆需此權限；讓 Clevera 可以列出儲存庫

   點擊安裝。對每個你想要發布到的組織重複此步驟。

4. 檢查連接#

   回到整合頁面，GitHub 會移至已連接列表，並顯示你的 GitHub 帳戶或組織名稱以及已連接徽章。在發布任何內容之前，它會顯示「尚未發布任何內容」。

   

稍後新增或移除儲存庫#

Clevera 僅能看到已安裝應用程式的儲存庫。若要更改此設定，請開啟整合，點擊 GitHub，並在存取權限下點擊儲存庫存取權。在 GitHub 上，開啟該帳戶，點擊設定並更改儲存庫列表。新的儲存庫會在下次開啟發布標籤頁時顯示。

發布文章#

1. 開啟發布標籤頁#

   在編輯器中，點擊分享並開啟發布標籤頁。在發佈文章下方，點擊準備發布下的 GitHub 圖塊。

   文章將以你在編輯器中開啟的語言進行發布。若要發布翻譯版本，請先在頂部列切換語言。

2. 選擇帳戶、儲存庫和資料夾#

   在發布位置下方，選擇：

   欄位	選擇內容	備註
   帳戶	你的個人帳戶或組織	僅在你的儲存庫屬於多個帳戶時顯示
   儲存庫	檔案所在的儲存庫	按最近更新排序。第一個會預設為你選定
   資料夾	路徑，例如 docs 或 articles/guides	「Markdown 檔案將在此處建立。留空則位於儲存庫根目錄。」預設為 docs。尚未存在的資料夾將會被建立

   Clevera 會記住你下次的選擇。

   

3. 發布#

   點擊發布到 GitHub。你會看到「正在 GitHub 中尋找現有副本」，然後是正在寫入頁面。完成後，你會看到「已發布到 GitHub」。點擊在 GitHub 中開啟以查看檔案。

   你可以在執行時關閉分享視窗；完成後會有通知提醒你。

檔案去向#

• 分支： 儲存庫的預設分支（通常為 main）。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>。
• 提交作者： 連接整合的 GitHub 帳戶。

檔案外觀#

Clevera 會編寫 GitHub 風格的 Markdown，並在頂部包含一個簡短的前言區塊：

---
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 連結；請再次發布以更新它。

與文件網站搭配使用#

大多數從儲存庫建置的靜態網站產生器（如 Docusaurus、MkDocs、Jekyll 或 Hugo）會讀取前言中的 title 並忽略它們不認識的欄位。常見的設定方式：

1. 將資料夾指向你的文件網站讀取的資料夾，例如 docs 或 content/guides。
2. 將每篇文章發布到該處；你網站的正常建置程序會抓取新的提交。
3. 檢查你的產生器是否渲染 GitHub 警示、數學公式和 <details>；有些產生器會將警示顯示為純引號。

更新已發布的文章#

發布是單向的。你在 Clevera 中所做的編輯會保留在 Clevera 中，直到你再次發布；而在 GitHub 上對檔案所做的更改永遠不會回傳到 Clevera。

當你發布到同一個儲存庫和資料夾時，Clevera 會找到同名的檔案並顯示「此文章已存在於 GitHub」。點擊查看以開啟現有檔案，然後選擇：

如果標題在 Clevera 中有所變更，檔案名稱也會隨之改變，因此發佈時會產生一個與舊檔案並存的新檔案。請自行在 GitHub 上刪除或重新命名舊檔案。

Clevera 中的任何操作都不會刪除您儲存庫中的檔案。

中斷 GitHub 連線#

1. 開啟 整合，點擊 GitHub 列上的 ⋯ 選單並選擇 中斷連線（或點擊 GitHub，然後點擊 中斷連線）。
2. 確認。系統會顯示：「您將無法再從編輯器發佈至此。您已發佈的內容將保留在 GitHub 中。」

中斷連線會刪除 Clevera 的存取權杖。若要同時移除 Clevera 在 GitHub 上的存取權，請解除安裝 Clevera AI 應用程式（前往 GitHub 設定 → 應用程式 → 已安裝的 GitHub 應用程式 → 設定 → 解除安裝），並在 已授權的 GitHub 應用程式 下撤銷授權。

疑難排解#

相關內容#