Fichiers

Gérez et ajoutez des fichiers à votre site, tels que 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 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 afin 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, de manière facultative, 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 de fichier

example.pdf

PDF · 2MB

Ouvrir

Voici une légende sur un fichier.

Téléverser un fichier

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

Pour téléverser un fichier, faites-le glisser et déposez-le dans la Déposez votre fichier ou parcourez 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.

GitBook vous permet de téléverser des fichiers jusqu’à 100 Mo par fichier.

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, afin que vous puissiez soit sélectionner un fichier, soit téléverser un nouveau fichier.

Astuce : Vous pouvez également faire glisser et 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.

Renommer un fichier

Pour renommer un fichier, ouvrez le Menu d’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 d’actions du fichier et cliquez sur Supprimer. Après avoir confirmé dans la boîte de dialogue que vous êtes sûr de vouloir supprimer le fichier, celui-ci sera supprimé.

Remarque : Assurez-vous de mettre à jour toutes les pages qui incluaient votre fichier supprimé ! Les blocs de fichiers qui font référence à un fichier supprimé afficheront un bloc vide, ou Impossible de charger l’image erreur.

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 et cliquez sur Remplacer. Dans la boîte de dialogue de remplacement de fichier qui apparaît, choisissez le nouveau fichier et attendez la fin de l’indicateur de téléversement. Votre fichier se met automatiquement à jour partout où il apparaissait dans votre section.

Cela peut être utile si, par exemple, vous avez subi 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 d’origine mettrait à jour la capture d’écran partout dans votre section, ce qui vous ferait gagner du temps et des efforts.

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 faire cela plutôt que de téléverser à nouveau l’image chaque fois que vous souhaitez l’inclure, afin de faciliter son remplacement ultérieur et d’éviter d’avoir plusieurs fichiers portant le même nom.

Représentation en Markdown

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