iconsVariables et expressions

Créez des variables réutilisables qui peuvent être référencées dans les pages et les espaces

Avec les variables, vous pouvez créer du texte réutilisable qui peut être référencé conditionnellement dans expressions et les conditions du contenu adaptatif.

Si vous répétez plusieurs fois le même nom, la même expression ou le même numéro de version dans votre contenu, vous pouvez créer une 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 qui sont 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 page ouverte demande de modification. 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 de l’espace actuel.

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

Cliquez sur Ajouter la variable pour enregistrer votre variable.

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’
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.
circle-info

Les noms des variables doivent commencer par une lettre et peuvent contenir des lettres, des chiffres et des underscores.

Utiliser des variables dans votre contenu

Les variables peuvent être référencées et utilisées dans un expression — 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’expression.

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

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
Vous pouvez ajouter des variables à votre contenu au sein d’expressions. L’éditeur d’expressions propose des options de saisie semi-automatique pour vous aider à trouver la variable dont vous avez besoin.

Mettre à jour une variable

Vous pouvez mettre à jour une variable à tout moment au cours 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 que la demande de modification aura été fusionnée.

Mis à jour

Ce contenu vous a-t-il été utile ?