# Fichiers

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, comme les images et les fichiers OpenAPI, directement sur la page pour que les gens puissent les voir 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 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="<https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-9ff1c1eef1d9ee1744295e274d3ee01fae848a20%2Fexample.pdf?alt=media>" %}
Voici une légende pour un fichier.
{% endfile %}

### 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 trouverez le panneau Fichiers en haut de la table des matières de votre espace.

Pour téléverser un fichier, glissez-déposez-le dans la **Déposez votre fichier ou parcourez** section, ou sélectionnez-la 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 à votre espace lorsque vous ajoutez un [bloc d’image](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/creating-content/blocks/insert-images) ou un [bloc OpenAPI](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/api-references/openapi). Lorsque vous créez l’un de ces blocs, le panneau Fichiers s’ouvrira, afin que vous puissiez soit sélectionner un fichier, soit téléverser un nouveau fichier.

{% 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 correspondant, afin que vous puissiez les consulter et les gérer plus tard.
{% endhint %}

### Renommer un fichier

Pour renommer un fichier, ouvrez le **menu d’actions** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-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> 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 d’actions** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-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> du fichier et 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 précédemment référence à l’ancien fichier feront alors référence au nouveau.

Pour remplacer un fichier, ouvrez le **menu d’actions** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-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> du fichier et cliquez sur **Remplacer**. Dans la boîte de dialogue de remplacement de fichier qui s’affiche, sélectionnez le nouveau fichier et attendez la fin de l’indicateur de téléversement. Votre fichier sera automatiquement mis à jour partout où il apparaissait dans votre espace.

Cela peut être utile si, par exemple, vous avez procédé à une refonte majeure du produit et devez mettre à jour des captures d’écran d’interface obsolètes qui apparaissent sur plusieurs pages. Remplacer le fichier d’origine mettra à jour la capture d’écran partout dans votre espace, ce qui vous fera 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 de fichier et en le sélectionnant dans le **Fichiers** panneau latéral.

Nous vous recommandons de faire cela plutôt que de téléverser à nouveau l’image à chaque fois que vous souhaitez l’inclure, afin de faciliter le remplacement des images plus tard 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 %}
```