> For the complete documentation index, see [llms.txt](https://smedai.aivd.ch/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smedai.aivd.ch/applications/gitbook/creer/blocs/fichiers.md).

# Fichiers

{% hint style="info" %}
Cette page vise des **contributeurs invités**.

Vous pouvez éditer le contenu d’un ou plusieurs espaces.

Vous n’avez généralement pas accès aux réglages d’**organisation**, de **site publié** ou de **mise en ligne**.

Pour ces sujets, contactez les responsables de l’espace ou l’équipe SIC.
{% endhint %}

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

Vous pouvez afficher certains fichiers, tels que 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 visualiser ou les télécharger.

Vous pouvez également ajouter facultativement une légende sous tout fichier que vous insérez dans votre page pour fournir plus d'informations si nécessaire.

### Exemple

#### Téléversement d'un fichier

Vous pouvez gérer les fichiers téléversés dans le panneau latéral Fichiers de votre espace. Vous pouvez trouver le panneau Fichiers en haut de la table des matières de votre espace.

Pour téléverser un fichier, faites-le glisser et déposez-le dans la section **Déposez votre fichier ou parcourez**, 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 aussi ajouter des fichiers à votre espace lorsque vous ajoutez un [bloc d'image](/applications/gitbook/creer/blocs/images.md) ou un bloc OpenAPI. Lorsque vous créez l'un de ces blocs, le panneau Fichiers s'ouvrira, vous permettant soit de sélectionner un fichier, soit d'en téléverser un nouveau.

{% hint style="info" %}
**Conseil :** 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 au panneau latéral Fichiers de l'espace concerné, afin que vous puissiez les consulter et les gérer plus tard.
{% endhint %}

***

#### Renommer un fichier

Pour renommer un fichier, ouvrez le **menu Actions** ![The Actions menu icon in GitBook](https://gitbook.com/docs/~gitbook/image?url=https%3A%2F%2F3903131528-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNkEGS7hzeqa35sMXQZ4X%252Fuploads%252F89MTSo5XRpPMVr1T0rxS%252Factions.svg%3Falt%3Dmedia%26token%3D2b5d001e-560a-4f29-8d22-de8163725ca1\&width=300\&dpr=3\&quality=100\&sign=76dd3e27\&sv=2) pour le fichier, et cliquez sur **Modifier**. Dans la fenêtre de dialogue, saisissez le nouveau nom de votre fichier.

***

#### Supprimer un fichier

Pour supprimer un fichier, ouvrez le **menu Actions** ![The Actions menu icon in GitBook](https://gitbook.com/docs/~gitbook/image?url=https%3A%2F%2F3903131528-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNkEGS7hzeqa35sMXQZ4X%252Fuploads%252F89MTSo5XRpPMVr1T0rxS%252Factions.svg%3Falt%3Dmedia%26token%3D2b5d001e-560a-4f29-8d22-de8163725ca1\&width=300\&dpr=3\&quality=100\&sign=76dd3e27\&sv=2) pour le fichier et cliquez sur **Supprimer**. Après avoir confirmé dans la boîte de dialogue que vous êtes certain de vouloir supprimer le fichier, votre fichier sera supprimé.

{% hint style="warning" %}
**Remarque :** Assurez-vous de mettre à jour toutes les pages qui contenaient votre fichier supprimé ! Les blocs de fichier qui référencent 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 référence à l'ancien fichier feront alors référence au nouveau fichier.

Pour remplacer un fichier, ouvrez le **menu Actions** ![The Actions menu icon in GitBook](https://gitbook.com/docs/~gitbook/image?url=https%3A%2F%2F3903131528-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FNkEGS7hzeqa35sMXQZ4X%252Fuploads%252F89MTSo5XRpPMVr1T0rxS%252Factions.svg%3Falt%3Dmedia%26token%3D2b5d001e-560a-4f29-8d22-de8163725ca1\&width=300\&dpr=3\&quality=100\&sign=76dd3e27\&sv=2) pour le fichier et cliquez sur **Remplacer**. Dans la boîte de dialogue de remplacement de fichier qui apparaît, sélectionnez le nouveau fichier et attendez que l'indicateur de téléchargement soit terminé. Votre fichier se mettra automatiquement à jour partout où il apparaissait dans votre espace.

Cela peut être utile si, par exemple, vous avez procédé à une refonte majeure de votre produit et devez mettre à jour des captures d'écran d'interface obsolètes qui apparaissent sur plusieurs pages. Remplacer le fichier original mettrait à jour la capture d'écran partout dans votre espace, vous faisant gagner du temps et des efforts.

{% hint style="info" %}
**Conseil :** 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 espace en créant un bloc d'image ou un bloc de fichier et en le sélectionnant depuis le panneau **Fichiers**. 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 ultérieur des images et d'éviter d'avoir plusieurs fichiers portant le même nom.
{% endhint %}

***

#### Représentation en Markdown

{% code title="Exemple Markdown" %}

```liquid
{% file src="https://example.com/example.pdf" %}
    Ceci est une légende pour le fichier d'exemple.
{% endfile %}
```

{% endcode %}


---

# 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://smedai.aivd.ch/applications/gitbook/creer/blocs/fichiers.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.
