> 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/creating-content/blocks/insert-files.md).
# Fichiers
Vous pouvez téléverser des fichiers dans votre section GitBook et les ajouter à votre page pour que les gens 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 les voient sans cliquer. Pour d’autres, comme les PDF, les utilisateurs devront cliquer pour les consulter ou les télécharger.
Vous pouvez également, si vous le souhaitez, ajouter une légende sous n’importe quel fichier inséré dans votre page pour fournir plus d’informations si nécessaire.
### Exemple de fichier
{% file src="/files/ffbbb093240997755b9ff712724a310946928eca" %}
Ceci est une légende d’un fichier.
{% endfile %}
### Téléverser un fichier
Vous pouvez gérer les fichiers téléversés dans l’ **Bibliothèque** onglet de votre section du site. L’ **Bibliothèque** onglet se trouve à côté de **Pages** en haut de la navigation de gauche.
Pour téléverser un fichier, glissez-déposez-le dans la **Déposez votre fichier ou parcourez** cette section, ou sélectionnez-le et utilisez la boîte de dialogue de fichiers de votre système pour choisir le fichier que vous souhaitez téléverser.
{% 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 lorsque vous ajoutez un bloc d’image ou un bloc OpenAPI. Lorsque vous créez l’un de ces blocs, l’ **Bibliothèque** onglet s’ouvre, ce qui vous permet soit de sélectionner un fichier, soit d’en téléverser un nouveau.
{% hint style="info" %}
**Astuce :** Vous pouvez également glisser-déposer des images depuis votre système de fichiers directement dans l’éditeur — ou coller une image copiée dans votre contenu. GitBook les ajoutera automatiquement à l’ **Bibliothèque** onglet 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** du fichier, puis cliquez sur **Modifier**. Dans la boîte de dialogue, saisissez le nouveau nom de votre fichier.
### Supprimer un fichier
Pour supprimer un fichier, ouvrez le **menu Actions** du 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 :** Assurez-vous de mettre à jour toutes les pages qui incluaient votre fichier supprimé ! Les blocs de fichier qui font référence à un fichier supprimé afficheront un bloc vide, ou *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 et mettra le nouveau à sa place. 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 d’actions** du fichier, puis cliquez sur **Remplacer**. Dans la boîte de dialogue de remplacement du fichier qui apparaît, choisissez le nouveau fichier et attendez que l’indicateur de téléversement soit terminé. Votre fichier se met automatiquement à jour partout où il apparaissait dans votre section.
Cela peut être utile si, par exemple, vous avez procédé à une refonte majeure du produit et devez mettre à jour d’anciennes captures d’écran de l’interface utilisateur qui apparaissent sur plusieurs pages. Remplacer le 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" %}
**Astuce :** Une fois que vous avez téléversé une image ou un fichier, vous pouvez y faire référence n’importe où dans votre section en créant un bloc d’image ou de fichier et en le sélectionnant dans l’ **Bibliothèque** onglet.
Nous vous recommandons de procéder ainsi plutôt que de téléverser à nouveau l’image chaque fois que vous souhaitez l’inclure, afin de faciliter le remplacement ultérieur des images 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" %}
Ceci est 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/fr/creating-content/blocks/insert-files.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.