# GitBook への移行

インポートツールを使用して、GitBook 内の既存ドキュメントを移行し、統合できます。

組み込みのインポートツールを使って単一ページまたは複数ページをインポートできます。あるいは [Git Sync を使用して Git リポジトリ全体をインポートできます](#import-using-git-sync).

## インポートパネルの使用

インポートパネルを使うと、別のドキュメントサイトや既存ファイルからコンテンツを GitBook 組織へ簡単に移行できます。

他のオンラインドキュメントサイトからインポートする場合は、サイトの URL を追加するだけで、あとは GitBook が処理します。

デフォルトでは、GitBook は AI を使用してインポート処理を効率化します。これにより、GitBook の形式に完全には一致しないインポート済みコンテンツが賢く調整・整理され、より洗練された出力となり、GitBook のブロックをより効果的に使用できるようになります。これはメニューから無効にできます。

### 対応しているインポート形式

GitBook は、次の形式のドキュメントサイトまたはファイルからのインポートをサポートしています:

* Markdown（`.md` または `.markdown`)
* HTML（`.html`)
* Microsoft Word（`.docx`)

GitBook は次からのインポートもサポートしています:

* Confluence
* Notion
* GitHub Wiki
* Quip
* Dropbox Paper
* Google ドキュメント

もし **複数ページをインポートしたい場合**、HTML または Markdown ファイルを含む ZIP ファイルをアップロードするか、 **オンラインドキュメント** のインポートオプションを使用できます。

{% hint style="info" %}
GitBook は Markdown ベースなので、Markdown 形式でコンテンツをインポートすると最良の結果が得られます。現在お使いのツールで Markdown へのエクスポートが可能な場合は、よりスムーズなインポートのためにその形式の使用をおすすめします。
{% endhint %}

### インポートパネル

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F8omDHqTDwNkvdG6Hv81q%2FImport%402x%20(1).png?alt=media&#x26;token=a5c0993c-f49a-4911-8297-6e76f0435bcb" alt="A GitBook screenshot showing the import panel"><figcaption><p>GitBook のインポートパネル。</p></figcaption></figure>

新しいスペースを作成すると、表示されるモーダルでコンテンツをインポートするオプションがあります。空のスペースを作成した場合は、 **クイックスタート** をクリックしたときに表示される新しい空白ページ下部のセクションからもインポートできます。 **編集**.

または、 **新規追加** > **ページをインポート** を [目次](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/rissu/gitbook-ui#table-of-contents)の下部で選択するか、ページの **アクションメニュー** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> を開いて **サブページをインポート**.

を選ぶことで、いつでもページまたはサブページをインポートできます。

{% hint style="warning" %}
入力元を選択した後、インポートしたいファイルを選択できます。
{% endhint %}

### 制限事項

GitBook には現在、インポートされたコンテンツに対して次の制限があります:

* 1 回のインポートでアップロードできる最大ページ数は **20**.
* 1 回のインポートでアップロードできる最大ファイル数（画像など）は **20**.

***

## Git Sync を使用して GitHub または GitLab のリポジトリからインポートする <a href="#import-using-git-sync" id="import-using-git-sync"></a>

大量のコンテンツを GitBook にインポートする場合は、 [Git 同期](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/git-sync)の使用をおすすめします。組み込みの移行ツールでほとんどのインポートは処理できますが、Git Sync の方が大規模な移行をより効率的に扱うのに適しています。

{% hint style="info" %}
コンテンツをインポートするための基本手順は以下のとおりです。より詳しい手順と動画デモについては、専用ガイドの [Git Sync を使用して GitBook にコンテンツをインポートする](https://app.gitbook.com/s/LBGJKQic7BQYBXmVSjy0/editing-and-publishing-documentation/import-or-migrate-your-content-to-gitbook-with-git-sync).
{% endhint %}

{% stepper %}
{% step %}
**コンテンツを Markdown に変換する**

GitBook は Markdown ベースなので、Markdown 形式でコンテンツをインポートすると最良の結果が得られます。現在お使いのツールで Markdown へのエクスポートが可能な場合は、よりスムーズなインポートのためにその形式の使用をおすすめします。

コンテンツがまだ Markdown ファイルでない場合は、 [Markitdown](https://github.com/microsoft/markitdown)のようなスクリプトやオンラインツールを使ってコンテンツを変換することをおすすめします。
{% endstep %}

{% step %}
**GitHub または GitLab でコンテンツを整理する**

GitBook サイトを設定する際は、GitHub または GitLab のリポジトリ内でコンテンツを効率よく整理することが重要です。Git Sync はスペース単位で行われるため、コンテンツのまとめ方を慎重に計画してください。必要な Markdown ファイルが正しい場所にあることを確認しつつ、複数のリポジトリやフォルダを作成します。
{% endstep %}

{% step %}
**スペースを設定し、Git Sync を構成する**

コンテンツを整理するには、必要に応じて GitBook で 1 つ以上のスペースを作成します。 [GitHub Sync](https://www.gitbook.com/integrations/github-sync) または [GitLab Sync](https://www.gitbook.com/integrations/gitlab-sync) 統合を組織にインストールし、それらのスペース用に設定します。前の手順で設定したフォルダまたはリポジトリと、スペースを同期する必要があります。
{% endstep %}

{% step %}
**Git Sync を GitHub → GitBook の方向で実行する**

設定プロセスを進める際は、GitHub → GitBook の方向を選択していることを確認してください。これにより、フォルダまたはリポジトリの内容が GitHub または GitLab から GitBook に取り込まれます。
{% endstep %}
{% endstepper %}
