# Variables et expressions

Avec les variables, vous pouvez créer du texte réutilisable qui peut être référencé conditionnellement dans [des expressions](/docs/documentation/fr/creating-content/formatting/inline.md#expressions) et [des conditions pour le contenu adaptatif](/docs/documentation/fr/acces-au-site/adaptive-content/adapting-your-content.md#working-with-the-condition-editor).

Si vous répétez plusieurs fois le même nom, la même phrase ou le même numéro de version dans votre contenu, vous pouvez créer une **variable** pour aider à maintenir toutes ces occurrences synchronisées et exactes — ce qui est utile si vous devez un jour les mettre à jour, ou si elles sont complexes et souvent sujettes aux fautes de frappe.

Vous pouvez créer des variables limitées à une seule page, ou à un seul espace.

### Créer une nouvelle variable

Pour créer une nouvelle variable, cliquez sur le **Bibliothèque** dans votre table des matières lorsque vous modifiez une [demande de modification](/docs/documentation/fr/collaboration/change-requests.md). Puis, cliquez sur **Variables**.

Vous pouvez utiliser le bouton bascule en haut pour afficher et créer des variables limitées soit à la page actuelle sur laquelle vous vous trouvez, soit à toutes les pages du space actuel.

En cliquant sur **Créer une variable** s'ouvrira une fenêtre modale où vous pourrez donner un nom et une valeur à votre variable.

Cliquez sur **Ajouter une variable** pour enregistrer votre variable.

<figure><img src="/files/03353a5ea091c26a48a188d4b28f7fcc1c23d63d" alt="A GitBook screenshot showing the Add variables screen. The variable Name box has been filled with the text ‘latest_version’ and the Value box has been filled with the text ‘v3.04.1’"><figcaption><p>Vous pouvez ajouter des variables à une seule page ou à un espace entier. Lorsque vous mettez à jour la valeur d'une variable, chaque occurrence de celle-ci sera mise à jour.</p></figcaption></figure>

{% hint style="info" %}
Les noms des variables doivent commencer par une lettre et peuvent contenir des lettres, des chiffres et des traits de soulignement.
{% endhint %}

### Utiliser des variables dans votre contenu

Les variables peuvent être référencées et utilisées dans une [expression](/docs/documentation/fr/creating-content/formatting/inline.md#expressions) — que vous pouvez insérer en ligne dans votre contenu. Après avoir inséré une expression, double-cliquez dessus pour ouvrir l'éditeur d'expressions.

{% hint style="info" %}
Les expressions ne peuvent être utilisées que dans le contenu de page d'un document. Elles ne fonctionnent pas dans les titres de page ni dans les métadonnées de page.
{% endhint %}

Les variables définies sous votre page sont accessibles sous l'objet `page.vars` . De même, les variables définies dans l'ensemble de votre espace sont accessibles sous l'objet `space.vars` .

<figure><img src="/files/bd2d204e2ba90549f9a9c9898f6c5eb99a92cba5" alt="A GitBook screenshot showing an expression block within the editor. The expression editor is open below it and the ‘space.vars.latest_version’ variable has been selected"><figcaption><p>Vous pouvez ajouter des variables à votre contenu dans des expressions. L'éditeur d'expressions propose des विकल्प d'autocomplétion pour vous aider à trouver la variable dont vous avez besoin.</p></figcaption></figure>

### Mettre à jour une variable

Vous pouvez mettre à jour une variable à tout moment dans une demande de modification. La mise à jour de sa valeur mettra à jour la valeur dans tous les blocs d'expression qui la référencent. La variable modifiée sera mise en ligne sur tout site publié une fois la demande de modification fusionnée.


---

# 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/variables-and-expressions.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.