# ファイル

GitBookスペースにファイルをアップロードし、ページに追加して、閲覧またはダウンロードできるようにできます。

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

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

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

{% file src="/files/e500a7aceefad0dd77e8d5ca7887aeb4aa0d0a30" %}
これはファイルのキャプションです。
{% endfile %}

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

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

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

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

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

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

### ファイル名の変更

ファイル名を変更するには、そのファイルの **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture> を開いて、 **編集**をクリックします。ダイアログの入力欄で、新しいファイル名を入力してください。

### ファイルの削除

ファイルを削除するには、そのファイルの **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture> を開いて、 **削除**をクリックします。ダイアログで、そのファイルを本当に削除することを確認すると、ファイルは削除されます。

{% hint style="warning" %}
**注：** 削除したファイルを含んでいたページは必ず更新してください。削除されたファイルを参照しているファイルブロックは、空のブロックとして表示されるか、 *画像を読み込めませんでした* エラーが表示されます。
{% endhint %}

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

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

ファイルを置き換えるには、そのファイルの **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture> を開いて、 **置き換え**を開きます。表示されるファイル置き換えダイアログで新しいファイルを選択し、アップロードの進行表示が完了するまで待ちます。ファイルは、スペース内で表示されていたすべての場所で自動的に更新されます。

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

{% hint style="info" %}
**ヒント:** 画像やファイルをアップロードしたら、その画像ブロックまたはファイルブロックを作成し、 **ファイル** サイドパネル

から選択することで、スペース内のどこでも参照できます。後で画像を置き換えやすくし、同じ名前のファイルが複数できるのを避けるためにも、毎回再アップロードするのではなく、この方法をおすすめします。
{% endhint %}

### Markdown での表現

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/creating-content/blocks/insert-files.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
