記事をGitHubに公開する

GitHubを一度接続すれば、Cleveraの記事をMarkdownファイルとしてリポジトリに公開できます。ドキュメントサイトやWiki形式の docs/ フォルダー、READMEコレクションなどに最適です。この記事では、接続方法、リポジトリとフォルダーの選択、ファイルの形式、更新の仕組みについて説明します。

始める前に#

• プラン: GitHubへの公開はProプランおよびカスタムプランに含まれています。FreeプランやStarterプランでは、公開タブに「ツールへの公開はProプランに含まれています」と表示されます。プランを選択するを参照してください。
• Cleveraでの役割: GitHubの接続や接続解除ができるのは、ワークスペースのオーナーまたは管理者のみです。一度接続が完了すれば、記事を編集できるユーザーであれば誰でも公開可能です。
• GitHubでのアクセス権: 接続を行うユーザーには、公開先リポジトリへの書き込み権限が必要です。また、個人アカウントまたは組織にGitHubアプリをインストールする権限（または組織オーナーによる承認）が必要です。
• 記事: 動画や録画から作成された記事を公開します。まずは記事を生成してください。録画を記事にするを参照してください。

公開にクレジットは消費されません。

GitHubを接続する#

1. 連携を開く#

   サイドバーでワークスペースメニューを開き、連携を選択します。利用可能な連携（または開発タブ）の下にあるGitHubを見つけ、接続をクリックします。カードにポインターを合わせるとボタンが表示されます。

   

2. GitHubでCleveraを承認する#

   GitHub上で Clevera AI アプリの承認を求められます。Cleveraが所属アカウントの一覧を取得できるよう、組織メンバーシップへの読み取りアクセス権が要求されます。Authorize（承認）をクリックしてください。

3. リポジトリにアプリをインストールする#

   次にGitHubで Clevera AI アプリのインストールページが開きます。個人アカウントまたは組織を選択し、すべてのリポジトリまたは選択したリポジトリのみを選びます。アプリは以下の権限を要求します。

   GitHub権限	理由
   コンテンツ: 読み取りと書き込み	Markdownファイルとその画像を生成・更新するため
   メタデータ: 読み取り専用	すべてのアプリにGitHubが要求する権限。Cleveraがリポジトリを一覧表示するために必要

   インストールをクリックします。公開先とする組織ごとに繰り返してください。

4. 接続を確認する#

   連携ページに戻ると、GitHubが接続済みリストに移動し、GitHubアカウントまたは組織名と接続済みバッジが表示されます。何も公開していない状態では「まだ公開されていません」と表示されます。

   

後からリポジトリを追加・削除する#

Cleveraはアプリがインストールされているリポジトリのみを認識します。設定を変更するには、連携を開いてGitHubをクリックし、アクセスの下にあるリポジトリへのアクセスをクリックします。GitHub上でアカウントを開き、Configure（設定）をクリックしてリポジトリリストを変更してください。新しいリポジトリは、次に公開タブを開いたときに表示されます。

記事を公開する#

1. 公開タブを開く#

   エディターで共有をクリックし、公開タブを開きます。記事を公開の下にある公開の準備ができましたから、GitHubタイルをクリックします。

   記事はエディターで開いている言語で公開されます。翻訳を公開するには、先に上部のバーで言語を切り替えてください。

2. アカウント、リポジトリ、フォルダーを選択する#

   公開先の下で以下を選択します。

   フィールド	選択内容	備考
   アカウント	個人アカウントまたは組織	リポジトリが複数のアカウントに属している場合のみ表示
   リポジトリ	ファイルを保存するリポジトリ	最近更新された順に表示。最初のリポジトリが自動選択されます
   フォルダー	docs や articles/guides などのパス	「Markdownファイルがここに作成されます。空欄にするとリポジトリのルートに作成されます」。初期値は docs です。存在しないフォルダーは自動作成されます

   Cleveraは選択した内容を次回のために記憶します。

   

3. 公開する#

   GitHubに公開をクリックします。「GitHub内の既存のコピーを確認中」と表示された後、「ページを書き込み中」と表示されます。完了すると「GitHubに公開されました」と表示されます。GitHubで開くをクリックしてファイルを確認してください。

   処理中に共有ウィンドウを閉じても問題ありません。完了すると通知が届きます。

ファイルの保存先#

• ブランチ: リポジトリのデフォルトブランチ（通常は main）。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> となります。
• コミット作成者: 連携を接続した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のアクセストークンが削除されます。GitHub側でもCleveraのアクセス権を削除するには、Clevera AIアプリをアンインストールし（GitHubの設定 → アプリケーション → インストール済みのGitHubアプリ → 設定 → アンインストール）、承認済みGitHubアプリから認証を取り消してください。

トラブルシューティング#

関連情報#