# GitHub 同期

デバイスコードまたはトークンで GitHub に接続し、プロジェクトを新規または既存のリポジトリとして公開し、マシン間でプッシュとプルを行います。トークンの保護の仕組みも説明します。

GitHub 同期は、マシンの外へのバックアップや、複数のコンピュータ間での作業の引き継ぎのための、任意の機能です。各プロジェクトがすでに持っている[本物の Git リポジトリ](/docs/git-history/)の上に作られています。ローカルのコミットは GitHub がなくても使えます。接続しても、Oleafly のアカウントは登場しません。必要なのはあなたの GitHub だけです。

## アカウントを接続する

**設定 → 連携 → GitHub** を開き、次のどちらかの方法を使います。

- **GitHub に接続**: デバイスコードによる方法で、おすすめです。Oleafly が短いコードを表示し、ブラウザで `github.com/login/device` が開きます（コードの **コピー** ボタン付き）。承認すると、アプリは数秒以内にそれを検出します。接続が要求するスコープは `repo` と `read:user` だけです。
- **パーソナルアクセストークン**: 自分で認証情報を発行したい場合は、「詳細設定: パーソナルアクセストークンを使う」を展開して、PAT を貼り付けます。

接続すると、アバターとユーザー名が設定と、上部ツールバーの GitHub メニューに表示されます。 **接続を解除** を押すと、トークンが破棄されます。

### トークンの保護の仕組み

トークンは、AES-256-GCM で暗号化された、所有者だけがアクセスできるローカルファイルに保存され、アプリの UI 層には渡されません。インターフェースが知るのは「@you として接続中」ということだけです。Git が認証を必要とするときは、メモリ上の credential helper を通じてトークンが渡されるので、コマンドライン、`.git/config`、シェルの履歴にトークンが現れることはありません。トークンをリモートの URL に埋め込んでいた古いビルドの痕跡は、起動時に自動で消去されます。

## プロジェクトを公開する

ソース管理パネルで **GitHub に公開** をクリックします。

- **新しいリポジトリを作成**: リポジトリ名を選びます（プロジェクトから自動入力されます）。おすすめは **非公開** のチェックを残すことですが、外すこともできます。そのうえで **作成してプッシュ** を押します。Oleafly はリポジトリを作成し、プロジェクトのファイルをコミットし、`origin` を設定して、プッシュします。
- **既存のリポジトリにリンク**: 検索できるリポジトリの一覧から選びます（非公開のものには鍵のアイコンが付きます）。そのうえで **リンクしてプッシュ** を押します。

公開後は、ツールバーの GitHub メニューに **GitHub で開く** と **リポジトリのリンクをコピー** が表示されます。

### 秘密情報に見えるファイルはローカルに残る

公開時に、キーやパスワードが入っていることの多いファイルがコミットされることはありません。たとえば `.env`、`*.pem`、SSH の秘密鍵、`credentials.json` です。これらはステージされないままプロジェクトのフォルダに残り、ダイアログにそのファイル名が表示されます。それでも公開したい場合は、ソース管理で自分でステージしてコミットします。`.env.example` のようなテンプレート、公開鍵、Keynote の `.key` ファイルは、通常どおり公開されます。

プッシュすると、履歴全体がアップロードされます。これらの名前のファイルが過去にコミットされたことがある場合、Oleafly はそれを一覧で示し、GitHub 上に何かを作成する前に **キャンセル** か **それでも公開** が押されるのを待ちます。

## 日々の同期

ソース管理パネルの **プッシュ** と **プル** のボタンは、その名前のとおり、現在のブランチの `origin` に対して動作します。 **フェッチ** と **同期** は **ソース管理のその他の操作** メニューにあります。 **コミットしてプッシュ** と **コミットして同期** は **コミット** の横のメニューにあります。ブランチ名の横にある **先行/遅れ** の表示（↑ ↓）が、プッシュまたはプルすべきものがあることを知らせます。

### 2 台のコンピュータ

1. マシン A で: プロジェクトを公開し、作業して、最後に **プッシュ** します。
2. マシン B で: 同じ GitHub アカウントを接続して **プロジェクトを読み込む → GitHub** を選び、リポジトリを指定します。[読み込みガイド](/docs/import-project/#import-from-github)を参照してください。以降は **プル** してから作業し、最後に **プッシュ** します。
3. マシン A に戻ったら、作業を始める前に **プル** します。表示がそれを知らせてくれます。

カバーの色、メイン文書の選択、履歴はすべて一緒に移ります。これらはプロジェクトのフォルダ自体に保存されているからです。

## 考えが変わったとき

リモートを設定すると **ソース管理のその他の操作** メニューに項目が 2 つ増えます。

- **リポジトリを変更** は、公開ダイアログを開き直して、`origin` の向き先を別の場所に変えます。
- **リンクを解除** は、リモートを取り除きます。ローカルのプロジェクトと履歴には影響しません。

## 衝突とブランチ

プルでマージの衝突が起きると、ソース管理に衝突したファイルが一覧で表示されます。それぞれについて **現在のものを使う** か **取り込むものを使う** を選ぶか、ファイルを編集して **解決済みにする** を選び、最後に **マージを完了** を選びます。 **マージを中止** を選ぶと、ファイルは元の状態に戻ります。プッシュとプルは、チェックアウトしているブランチに対して動作し、パネルの上部にあるブランチメニューで、ブランチの切り替えや作成ができます。[Git とソース管理](/docs/git-history/#branches-and-stashes)を参照してください。

## 制限事項

Oleafly が認証できるのは HTTPS のリモートです。公開の操作で、正しい設定が自動で行われます。

## うまくいかないとき

- 「No remote 'origin'」と表示される: 先に公開してください。プッシュとプルにはリモートが必要です。
- リモートにコミットがあるためプッシュが拒否された: 先にプルしてから、プッシュしてください。
- 「No GitHub token set」と表示される: 設定の「連携」→「GitHub」で接続してください。

詳しくは [FAQ](/docs/faq/#history-and-collaboration) を参照してください。
