> 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/creer-du-contenu/blocks/insert-images.md).
# Images
Vous pouvez insérer des images dans votre page, puis choisir leur taille et décider si elles sont alignées à gauche, au centre ou à droite. Vous pouvez également inclure, en option, un texte alternatif et/ou une légende sur votre bloc d’image.
{% hint style="info" %}
**Astuce :** Pour des raisons d’accessibilité, nous recommandons de définir un texte alternatif pour vos images.
{% endhint %}
### Exemple d’un bloc d’image
Exemple d’un bloc d’image avec une légende
### Téléverser une image
Il existe deux façons d’ajouter des images à votre contenu :
1. Faites glisser l’image depuis votre système de gestion de fichiers directement dans un bloc vide de votre page.
2. [Ajoutez un bloc d’image](/docs/documentation/fr/creer-du-contenu/blocks.md#inserting-a-new-content-block) à votre page et utilisez le **Sélectionner des images** panneau latéral qui apparaît à droite de la fenêtre.
Si vous suivez la deuxième méthode, vous pouvez choisir de téléverser un fichier, de sélectionner un fichier téléversé précédemment, de coller l’URL d’une image ou d’ajouter une image depuis [Unsplash](https://unsplash.com/) en utilisant la recherche intégrée.
{% hint style="warning" %}
GitBook vous permet de téléverser des images jusqu’à 100 Mo par fichier.
{% endhint %}
Il n’existe pas de limite fixe au nombre total de ressources dans une section, bien que GitBook se réserve le droit de bloquer des comptes en cas d’abus. Pour les fichiers plus volumineux que la limite de téléversement, stockez-les dans un service comme Google Drive ou Dropbox et créez un lien vers eux depuis votre page.
Les GIF animés ont une limite de 200 images par fichier. Les fichiers volumineux — GIF compris — ralentissent le chargement de votre page, évitez donc autant que possible de téléverser directement des fichiers volumineux.
#### Créer une galerie d’images
Ajouter plus d’une image à un bloc d’image créera une galerie. Pour ce faire, ouvrez le bloc d’image **menu Options** et choisissez **Ajouter des images…** pour ouvrir le **Sélectionner des images** panneau latéral à nouveau.
Pour supprimer une image d’une galerie, ouvrez le **menu d’édition** sur l’image que vous voulez supprimer, puis appuyez sur la touche **Supprimer ⌫** .
### Ajouter des images pour le mode clair et le mode sombre
Vous pouvez définir des images différentes pour les versions en mode clair et sombre de votre site publié. GitBook affichera automatiquement l’image correcte selon le mode utilisé par votre visiteur.
Pour ajouter une image pour le mode sombre, survolez votre image et ouvrez le **menu d’édition** et cliquez sur **Remplacer l’image** .
Dans le menu déroulant, choisissez **Ajouter une image pour le mode sombre**. Une fois cela défini, vous pouvez remplacer l’une ou l’autre image depuis ce même menu.
{% hint style="warning" %}
**Remarque :** GitBook ne prend actuellement pas en charge les images en mode clair et sombre dans certains cas, notamment les couvertures de page ou les couvertures d’image sur [les cartes](/docs/documentation/fr/creer-du-contenu/blocks/cards.md).
{% endhint %}
### Images en mode clair et sombre via la synchronisation GitHub/GitLab
Vous pouvez également ajouter des images en mode clair et sombre dans Markdown via la syntaxe HTML (`` et ``).
Pour les blocs d’image, utilisez l’élément HTML `` avec un `` et `` à l’intérieur :
```html
Texte avant
Texte de la légende
Texte après
```
Pour les images en ligne (images qui s’affichent dans le flux du texte), utilisez l’élément HTML `` avec un `` à l’intérieur :
```html
Texte avant l’image
et le texte après l’image
```
{% hint style="warning" %}
**Remarque :** Nous ne prenons pas encore en charge [la syntaxe propre à GitHub](https://github.blog/changelog/2021-11-24-specify-theme-context-for-images-in-markdown/) via `#gh-dark-mode-only` ou `#gh-light-mode-only`.
{% endhint %}
### Redimensionnement
Pour redimensionner votre image, survolez-la et ouvrez le **menu d’édition** . Cliquez sur le **Taille** bouton pour modifier la taille de votre image parmi les options disponibles.
Redimensionner une image
* **Petit** – 25 % de la taille de l’image
* **Moyenne** – 50 % de la taille de l’image
* **Grande** – 75 % de la taille de l’image
* **Ajuster** – Supprime toutes les spécifications de taille et affiche l’image en taille réelle ou limitée à une largeur maximale de **735** **pixels** pour les images plus grandes.
Si votre image est plus large que l’éditeur, GitBook limitera plutôt la largeur de l’image à celle de l’éditeur, et le redimensionnement sera basé sur cette limite.
{% hint style="info" %}
**Remarque :** Lors du redimensionnement d’images dans une galerie d’images, le résultat peut différer de celui du redimensionnement d’une image individuelle.
{% endhint %}
### Redimensionner des images via Git Sync
Si vous souhaitez davantage de contrôle sur la taille de votre image, vous pouvez préciser la taille exacte à l’aide de Markdown dans GitHub ou GitLab.
Lorsque nous exportons une image, nous utilisons la balise HTML ``. Selon les spécifications, nous pouvons définir les dimensions de l’image à l’aide des attributs `width` et `height` attributs, qui n’acceptent que des valeurs en pixels ou une combinaison d’un nombre et d’un `%` signe.\n\nLes variantes valides pour définir les dimensions de l’image sont :\
\
`` Définit l’image à une largeur de 100 pixels\
`` Définit l’image à sa taille maximale (bien que cela soit limité par l’éditeur)
### Aligner les images
Par défaut, les blocs d’image affichent votre image à sa taille maximale, alignée au centre.
Pour modifier l’alignement d’une image, ouvrez le **menu Options** et choisissez l’alignement souhaité. Cela n’affectera que les images plus étroites que l’éditeur, ou les images que vous avez [redimensionnées](#resizing).
### Encadrer les images
Vous pouvez ajouter un cadre aux blocs d’image afin de donner à vos images un aspect cohérent et de les séparer visuellement du contenu environnant.
Les images encadrées peuvent avoir des légendes et affichent une grille discrète derrière la légende.
Pour ajouter un cadre à une image, survolez-la et ouvrez le **menu Options** et activez le **Avec cadre** interrupteur.
{% hint style="info" %}
**Bon à savoir :** Vous pouvez encadrer uniquement des images individuelles dans un bloc. Les blocs d’image contenant plusieurs images et les images en ligne ne peuvent pas avoir de cadre.
{% endhint %}
### Représentation en Markdown
```markdown
//Bloc simple
//Bloc avec légende
//Bloc avec texte alternatif
//Bloc avec légende et texte alternatif
Logo GitBook
// Bloc avec image encadrée
//Bloc avec image différente pour le mode sombre et le mode clair, avec légende
Texte de la légende
```
### Pourquoi mon image ne se charge-t-elle pas ?
L’erreur « impossible de charger l’image » signifie que l’image a été modifiée ou supprimée à sa source. Si vous avez intégré une image via une URL plutôt qu’en la téléversant, GitBook dépend de cette URL — si l’image est déplacée ou disparaît de la source, elle cesse d’apparaître sur votre page.
Pour résoudre le problème, téléversez l’image directement dans GitBook ou mettez à jour l’URL si l’emplacement de l’image a changé. L’erreur peut également apparaître lorsque vous copiez une image d’une section à une autre, car chaque section possède son propre répertoire de fichiers — téléversez de nouveau l’image dans la nouvelle section.
Vous pouvez consulter tous les fichiers téléversés dans une section dans l’ **Bibliothèque** onglet, à côté de **Pages** en haut de la table des matières.
---
# 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/creer-du-contenu/blocks/insert-images.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.
