# Variables et expressions

Avec les variables, vous pouvez créer du texte réutilisable qui peut être référencé conditionnellement dans [expressions](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/formatting/inline#expressions) et [des conditions pour le contenu adaptatif](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/adaptive-content/adapting-your-content#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 un **variable** pour aider à garder 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 mal saisies.

Vous pouvez créer des variables à portée d’une seule page ou d’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 un [demande de modification](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/collaboration/change-requests). Puis, cliquez sur **Variables**.

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

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

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

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FQwfTEGjsxDThqQFvgOm8%2FAdd%20variable%402x.png?alt=media&#x26;token=955216f0-67df-4c96-aece-490cfbbf0271" 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 de 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 un [expression](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/formatting/inline#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.

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` objet.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FaRWyFWMI24Cy2nVZmSzE%2FUsing%20variable%402x.png?alt=media&#x26;token=a1999774-f0da-4232-8533-b7e806ddd87c" 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 le cadre d’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.