# Cartes

Vous pouvez utiliser des cartes pour créer une mise en page visuellement agréable, en combinant texte et images dans une grille. Elles sont idéales pour créer des pages d’atterrissage ou afficher tout autre contenu de manière non linéaire.

Vous pouvez ajuster [basculer entre des cartes de taille moyenne ou grande](#card-size) et les lier aux ressources pertinentes.

### Exemple d’une carte

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Image de couverture</th><th data-hidden data-type="image">Image de couverture (sombre)</th><th data-hidden data-type="image">Image de couverture (sombre)</th><th data-hidden data-card-cover-dark data-type="image">Image de couverture (sombre)</th></tr></thead><tbody><tr><td><strong>Page d’accueil GitBook</strong></td><td>Visitez notre site Web et découvrez-en plus sur GitBook.</td><td><a href="https://www.gitbook.com/">https://www.gitbook.com/</a></td><td><a href="/files/7b8a7a25697998c4206bc0c9c3c6f8211151cf78">/files/7b8a7a25697998c4206bc0c9c3c6f8211151cf78</a></td><td><a href="/files/88594006bcc083c7519f8e2490eda225de84bb8f">/files/88594006bcc083c7519f8e2490eda225de84bb8f</a></td><td></td><td><a href="/files/88594006bcc083c7519f8e2490eda225de84bb8f">/files/88594006bcc083c7519f8e2490eda225de84bb8f</a></td></tr><tr><td><strong>Documentation développeur</strong></td><td>Créez votre propre intégration GitBook !</td><td><a href="https://developer.gitbook.com/">https://developer.gitbook.com/</a></td><td><a href="/files/ae75df2b9632840e4ebd802e56aa11b5ea3d084b">/files/ae75df2b9632840e4ebd802e56aa11b5ea3d084b</a></td><td></td><td><a href="/files/815f45dae80dffc00e75506bbebbfa4876ec0487">/files/815f45dae80dffc00e75506bbebbfa4876ec0487</a></td><td><a href="/files/815f45dae80dffc00e75506bbebbfa4876ec0487">/files/815f45dae80dffc00e75506bbebbfa4876ec0487</a></td></tr><tr><td><strong>Inscrivez-vous à GitBook</strong></td><td>Cliquez ici pour commencer gratuitement.</td><td><a href="https://app.gitbook.com/join">https://app.gitbook.com/join</a></td><td><a href="/files/5a46a442f76839a4d625d60111c942ee9c22edc6">/files/5a46a442f76839a4d625d60111c942ee9c22edc6</a></td><td></td><td></td><td><a href="/files/510b606b8d6beb8be0db0884bbf7bd31d5dd17f4">/files/510b606b8d6beb8be0db0884bbf7bd31d5dd17f4</a></td></tr></tbody></table>

### Ajout de liens <a href="#adding-links-and-images-to-your-cards" id="adding-links-and-images-to-your-cards"></a>

Survolez une carte et ouvrez son **menu Options** <picture><source srcset="/files/QLUQj6waZRiK6FpSqrt6" media="(prefers-color-scheme: dark)"><img src="/files/a8fb7b2b9f8482b7286cc5fc535d675ecfc5a7d9" alt="The Options menu icon in GitBook"></picture>. Vous pouvez ici ajouter un lien cible, afin que les utilisateurs puissent accéder directement à un emplacement lorsqu’ils cliquent sur la carte.

{% hint style="success" %}
Lors de la création de cartes, nous vous recommandons d’utiliser **des liens cibles plutôt que des hyperliens**. Avec un lien cible, vos lecteurs peuvent cliquer n’importe où sur la carte pour accéder à l’URL liée.
{% endhint %}

### Ajout d’images

Survolez une carte et ouvrez son **menu Options** <picture><source srcset="/files/QLUQj6waZRiK6FpSqrt6" media="(prefers-color-scheme: dark)"><img src="/files/a8fb7b2b9f8482b7286cc5fc535d675ecfc5a7d9" alt="The Options menu icon in GitBook"></picture>. Vous pouvez ici ajouter une image de couverture à votre carte. Vous pouvez aussi simplement cliquer sur l’option **Ajouter une image de couverture** de la carte elle-même.

Cela ouvrira la fenêtre modale **Sélectionner un fichier** . Vous pouvez y glisser-déposer une nouvelle image, ou utiliser un fichier image que vous avez déjà téléversé dans votre espace.

#### Ajout d’images pour le mode sombre

Vous pouvez également ajouter des images de couverture qui n’apparaîtront qu’en mode sombre.

Pour ce faire, ouvrez le **menu Options** <picture><source srcset="/files/QLUQj6waZRiK6FpSqrt6" media="(prefers-color-scheme: dark)"><img src="/files/a8fb7b2b9f8482b7286cc5fc535d675ecfc5a7d9" alt=""></picture> et choisissez **Couverture** > **Modifier la couverture** > **Ajouter une couverture pour le mode sombre**. Cela ouvrira la fenêtre modale **Sélectionner un fichier** , où vous pouvez glisser-déposer une nouvelle image ou sélectionner une image téléversée précédemment.

#### Choisir la bonne taille d’image

GitBook recadrera automatiquement les images en paysage au format 16:9 sur ordinateur et mobile. Si les images que vous téléversez sont au format portrait ou 1:1, elles seront recadrées en 16:9 sur ordinateur et s’afficheront en carré ou en portrait sur mobile.

<figure><img src="/files/733d7fd196ffca509fa26422e4fa48748e476d94" alt="A GitBook screenshot showing card images on desktop"><figcaption><p>Sur ordinateur, toutes les images des cartes s’afficheront au format paysage 16:9, quelles que soient leurs dimensions. Nous recommandons d’utiliser les mêmes dimensions pour plus de cohérence.</p></figcaption></figure>

<figure><img src="/files/fe634fe2fa705b59834b8dbdb509f621988f05dd" alt="A GitBook screenshot showing card images on mobile"><figcaption><p>Sur mobile, les images carrées ou portrait s’afficheront comme à gauche. Les images en paysage s’afficheront comme à droite.</p></figcaption></figure>

Pour conserver une cohérence entre l’ordinateur et le mobile, nous recommandons de téléverser toutes les images de vos cartes au format 16:9 (par ex. 1920 px x 1080 px).

Si vous souhaitez que vos cartes adaptent leur mise en page en fonction de la taille de l’écran, nous vous recommandons de téléverser des images au format 1:1, avec le contenu de l’image centré.

### Changer la taille des cartes

Vous pouvez sélectionner la taille de la carte en ouvrant le **menu Options** <picture><source srcset="/files/QLUQj6waZRiK6FpSqrt6" media="(prefers-color-scheme: dark)"><img src="/files/a8fb7b2b9f8482b7286cc5fc535d675ecfc5a7d9" alt="The Options menu icon in GitBook"></picture> à gauche de votre bloc de cartes. L’ **Moyen** option crée trois cartes sur une ligne horizontale, tandis que l’ **Grand** option affiche deux cartes plus grandes sur chaque ligne.

### Représentation en Markdown

```markdown
<table data-view="cards">
  <thead>
    <tr>
      <th></th>
      <th></th>
      <th data-hidden data-card-target data-type="content-ref"></th>
      <th data-hidden data-card-cover data-type="files"></th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>Titre d’exemple 1</strong></td>
      <td>Description d’exemple 1.</td>
      <td><a href="https://example.com">https://example.com</a></td>
      <td><a href="https://example.com/image1.svg">exemple_image1.svg</a></td>
    </tr>
    <tr>
      <td><strong>Titre d’exemple 2</strong></td>
      <td>Description d’exemple 2.</td>
      <td><a href="https://example.com">https://example.com</a></td>
      <td><a href="https://example.com/image2.svg">exemple_image2.svg</a></td>
    </tr>
    <tr>
      <td><strong>Titre d’exemple 3</strong></td>
      <td>Description d’exemple 3.</td>
      <td><a href="https://example.com">https://example.com</a></td>
      <td><a href="https://example.com/image3.svg">exemple_image3.svg</a></td>
    </tr>
  </tbody>
</table>
```


---

# Agent Instructions: 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:

```
GET https://gitbook.com/docs/documentation/fr/creating-content/blocks/cards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.