> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/creer-du-contenu/blocks/insert-files.md).

# Fichiers

Gérez et ajoutez des fichiers à votre site, comme des PDF, des vidéos, des documents et plus encore

Vous pouvez téléverser des fichiers dans votre section GitBook et les ajouter à votre page pour que les utilisateurs puissent les consulter ou les télécharger.

Vous pouvez afficher certains fichiers, comme des images et des fichiers OpenAPI, directement sur la page pour que les gens puissent les voir sans rien cliquer. Pour d’autres, comme les PDF, les utilisateurs devront cliquer pour les afficher ou les télécharger.

Vous pouvez également ajouter facultativement une légende sous n’importe quel fichier que vous insérez dans votre page afin d’ajouter plus d’informations si nécessaire.

### Exemple d’un fichier <a href="#example-of-a-file" id="example-of-a-file"></a>

{% file src="/files/ffbbb093240997755b9ff712724a310946928eca" %}
Voici une légende d’un fichier.
{% endfile %}

### Téléverser un fichier

Vous pouvez gérer les fichiers importés dans l’onglet **Bibliothèque** de votre section de site. L’onglet **Bibliothèque** se trouve à côté de **Pages** en haut du menu de navigation à gauche.

Pour importer un fichier, faites-le glisser dans la section **Déposez votre fichier ou parcourez** ou sélectionnez-le et utilisez la fenêtre de sélection de fichiers de votre système pour choisir le fichier à importer.

{% hint style="warning" %}
GitBook vous permet de téléverser des fichiers jusqu’à 100 Mo par fichier.
{% endhint %}

Vous pouvez également ajouter des fichiers à une page en ajoutant un bloc Image ou un bloc OpenAPI. Lorsque vous créez l’un de ces blocs, l’onglet **Bibliothèque** s’ouvre. Vous pouvez alors sélectionner un fichier ou en importer un nouveau.

{% hint style="info" %}
**Conseil :** Vous pouvez aussi faire glisser des images depuis votre système de fichiers directement dans l’éditeur — ou coller une image copiée dans votre contenu. GitBook les ajoute automatiquement à l’onglet **Bibliothèque** de la section correspondante, afin que vous puissiez les consulter et les gérer plus tard.
{% endhint %}

### Renommer un fichier

Pour renommer un fichier, ouvrez le **menu Actions** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> associé au fichier, puis cliquez sur **Modifier**. Dans la boîte de dialogue, saisissez le nouveau nom du fichier.

### Supprimer un fichier

Pour supprimer un fichier, ouvrez le **menu Actions** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> associé au fichier, puis cliquez sur **Supprimer**. Après avoir confirmé dans la boîte de dialogue que vous souhaitez bien supprimer le fichier, celui-ci sera supprimé.

{% hint style="warning" %}
**Remarque :** Veillez à mettre à jour toutes les pages qui incluaient le fichier supprimé ! Les blocs de fichier faisant référence à un fichier supprimé afficheront un bloc vide ou une *Impossible de charger l’image* erreur.
{% endhint %}

### Remplacer un fichier

Si vous avez un fichier qui doit simplement être mis à jour vers une nouvelle version, vous pouvez le remplacer. Cela remplacera l’ancien fichier par le nouveau. Tous les blocs qui faisaient auparavant référence à l’ancien fichier feront alors référence au nouveau fichier.

Pour remplacer un fichier, ouvrez le **menu Actions** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> associé au fichier, puis cliquez sur **Remplacer**. Dans la boîte de dialogue de remplacement qui s’affiche, choisissez le nouveau fichier et attendez la fin de l’importation. Le fichier est automatiquement remplacé partout où il apparaissait dans votre section.

Cela peut être utile si, par exemple, votre produit a fait l’objet d’une refonte majeure et que vous devez mettre à jour des captures d’écran d’interface obsolètes qui apparaissent sur plusieurs pages. Le remplacement du fichier d’origine mettrait à jour la capture d’écran partout dans votre section, ce qui vous ferait gagner du temps et des efforts.

{% hint style="info" %}
**Conseil :** Une fois une image ou un fichier importé, vous pouvez l’utiliser n’importe où dans votre section en créant un bloc Image ou Fichier et en le sélectionnant dans l’onglet **Bibliothèque** .

Nous vous recommandons de faire cela plutôt que de téléverser l’image à nouveau à chaque fois que vous souhaitez l’inclure, afin de faciliter le remplacement des images par la suite et d’éviter d’avoir plusieurs fichiers portant le même nom.
{% endhint %}

### Représentation en Markdown

```markdown
{% file src="https://example.com/example.pdf" %}
    Voici une légende pour le fichier d’exemple.
{% endfile %}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/creer-du-contenu/blocks/insert-files.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
