# ファイル

ファイルをGitBookスペースにアップロードして、ページに追加すれば、閲覧またはダウンロードしてもらえます。

画像やOpenAPIファイルなど一部のファイルは、何もクリックしなくてもページ上でそのまま表示して、見てもらえます。PDFなど他のファイルは、ユーザーがクリックして表示またはダウンロードする必要があります。

必要に応じて、ページに挿入した任意のファイルの下にキャプションを追加して、補足情報を付けることもできます。

### ファイルの例 <a href="#example-of-a-file" id="example-of-a-file"></a>

{% file src="<https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-9ff1c1eef1d9ee1744295e274d3ee01fae848a20%2Fexample.pdf?alt=media>" %}
これはファイルのキャプションです。
{% endfile %}

### ファイルのアップロード

アップロードしたファイルは、スペースのFilesサイドパネルで管理できます。Filesパネルは、スペースの目次の上部にあります。

ファイルをアップロードするには、次の場所にドラッグ＆ドロップします **ファイルをドロップするか、参照してください** セクション。あるいは、選択してシステムのファイルダイアログを使い、アップロードしたいファイルを選択します。

{% hint style="warning" %}
GitBookでは、1ファイルあたり最大100MBまでアップロードできます。
{% endhint %}

また、次のものを追加するときにスペースへファイルを追加することもできます [画像ブロック](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/creating-content/blocks/insert-images) または [OpenAPIブロック](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/api-references/openapi)。これらのブロックのいずれかを作成するとFilesパネルが開くので、ファイルを選択するか、新しいファイルをアップロードできます。

{% hint style="info" %}
**ヒント:** ファイルシステムから画像を直接エディタにドラッグ＆ドロップすることも、コピーした画像をコンテンツに貼り付けることもできます。GitBookはそれらを自動的に、それぞれのスペースのFilesサイドパネルに追加するので、後で表示したり管理したりできます。
{% endhint %}

### ファイル名の変更

ファイル名を変更するには、ファイルの **アクションメニュー** <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> を開き、 **編集**をクリックします。表示されるダイアログで、ファイルの新しい名前を入力してください。

### ファイルの削除

ファイルを削除するには、ファイルの **アクションメニュー** <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 %}

### ファイルの置き換え

新しいバージョンに更新する必要があるファイルがある場合は、置き換えることができます。これにより古いファイルが差し替えられ、新しいファイルがその場所に配置されます。以前に古いファイルを参照していたブロックは、新しいファイルを参照するようになります。

ファイルを置き換えるには、 **アクションメニュー** <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> を開き、 **置き換え**を開きます。表示されるファイル置換ダイアログで新しいファイルを選択し、アップロードの進行表示が完了するのを待ちます。ファイルは、スペース内の表示箇所すべてで自動的に更新されます。

これは、たとえば大規模な製品リデザインがあり、複数のページに表示される古いUIスクリーンショットを更新する必要がある場合に便利です。元のファイルを置き換えれば、スペース内のすべての場所のスクリーンショットが更新され、時間と手間を節約できます。

{% hint style="info" %}
**ヒント:** 画像またはファイルをアップロードしたら、画像ブロックまたはファイルブロックを作成して、次の場所から選択することで、スペース内のどこでも参照できます **ファイル** サイドパネル

。画像を含めたいたびに毎回再アップロードするのではなく、こうすることをおすすめします。こうすると、後で画像を置き換えやすくなり、同じ名前のファイルが複数できるのを避けられます。
{% endhint %}

### Markdownでの表現

```markdown
{% file src="https://example.com/example.pdf" %}
    これは例のファイルのキャプションです。
{% endfile %}
```
