# GitBookへの移行

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

組み込みのインポートツールを使って単一ページまたは複数ページをインポートするオプションがあります — または [Git Sync を使ってリポジトリ全体を](#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" %}
GitBook はさまざまなソースからコンテンツをインポートしますが、製品機能やドキュメント形式の違いにより、インポート後のコンテンツが元のソースと異なる場合があります。
{% endhint %}

### 制限事項

現在、GitBook のインポートコンテンツに関する制限は次の通りです：

* 単一インポートでアップロードできる最大ページ数は **20**.
* 単一インポートでアップロードできるファイル数（画像など）の最大は **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 同期](https://www.gitbook.com/integrations/github-sync) または [GitLab Sync](https://www.gitbook.com/integrations/gitlab-sync) の統合をインストールし、それらのスペース向けに設定します。前のステップで設定したフォルダやリポジトリとスペースを同期する必要があります。
{% endstep %}

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

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