Fichiers

Gérez et ajoutez des fichiers à votre espace tels que PDF, vidéos, documents et plus

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 des images et des fichiers OpenAPI, directement sur la page afin que les gens puissent les voir sans cliquer. Pour d'autres, comme les PDF, les utilisateurs devront cliquer pour les visualiser 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 davantage d’informations si nécessaire.

Exemple de fichier

2MB

example.pdf

PDF

Ouvrir

Ceci est une légende sur un fichier.

Téléverser 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 le 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 à votre espace lorsque vous ajoutez un bloc image ou un bloc 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 en téléverser un nouveau.

Conseil : Vous pouvez aussi 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 au panneau latéral Fichiers de l’espace concerné, afin que vous puissiez les consulter et les gérer ultérieurement.

Renommer un fichier

Pour renommer un fichier, ouvrez le menu Actions pour le fichier, et 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 pour le 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, votre fichier sera supprimé.

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

Remplacer un fichier

Si vous avez un fichier qui a simplement besoin d’être mis à jour par une nouvelle version, vous pouvez le remplacer. Cela échangera l’ancien fichier et mettra le nouveau à sa place. Tous les blocs qui faisaient référence à l’ancien fichier référeront alors le nouveau fichier.

Pour remplacer un fichier, ouvrez le menu Actions 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 à jour automatiquement partout où il apparaissait dans votre espace.

Cela peut être utile si, par exemple, vous avez effectué une refonte majeure du produit et devez mettre à jour des captures d’écran de l’interface utilisateur 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.

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 image ou un bloc fichier et en le sélectionnant depuis le Fichiers panneau latéral.

Nous vous recommandons de procéder ainsi plutôt que de téléverser l’image à nouveau chaque fois que vous souhaitez l’inclure, afin de faciliter le remplacement des images ultérieurement et d’éviter d’avoir plusieurs fichiers portant le même nom.

Représentation en Markdown

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