# Variables du document

Une variable est un moyen simple de permettre à &kword; de modifier le document d'une manière très spécifique pour refléter la nature des changements de ce document.

Une variable peut être un nombre (par exemple un numéro de page, le nombre total de pages dans un document, etc.), un ensemble de mots (nom de client, de produit, de fichier, etc.), une date, une heure ou quasiment ce que vous voulez.

Une fois la variable définie, un mot clef est inséré dans le document. &kword; remplacera ce mot clef par la valeur de la variable à chaque fois que le mot clef sera utilisé.

Les variables peuvent être fixes (ce qui signifie qu'une fois insérées leur valeur ne change plus), ou bien variables (le mot-clef est alors mis à jour par &kword; pour refléter la valeur actuelle de la variable).

Ce chapitre commence avec quelques exemples de variables couramment utilisées (date, heure, et numéros de page), puis détaille les autres variables disponibles. Enfin, il sera expliqué comment créer des variables personnalisées.

## Date et heure

Beaucoup de lettres, rapports et documents contiennent des informations au sujet des dates. La date et l'heure peuvent indiquer la création du document (ce sont alors des constantes tant que le document existe) ou la dernière modification (ces valeurs changent à chaque fois que le document est modifié).

&kword; vous permet de définir des variables de date et heure fixes ou variables dans un document.

### Insérer la date

Pour insérer la date dans un document, placez simplement le curseur sur la zone de texte où la date doit être insérée et sélectionnez Insertion VariableDate dans la barre de menus. Ceci vous proposera deux choix : Date courante (fixe) et Date courante (variable) .

Date courante (fixe)

  Sélectionner cette option va insérer la date courante à la position actuelle du curseur. Cette date est déterminée en consultant l'horloge de l'ordinateur. Une fois saisie, cette valeur ne changera pas, même si vous demandez à &kword; de mettre à jour les variables du document.

  Ce choix est idéal pour les dates de création des documents ou quand vous devez insérer des dates dans des rapports d'activité. Comparez cette option à Date courante (variable).

Date courante (variable)

  Sélectionner cette option va insérer la date courante à la position actuelle du curseur. Cette date est déterminée en consultant l'horloge de l'ordinateur. Cette valeur changera si vous demandez à &kword; de mettre à jour les variables du document.

  Cette option est un bon choix pour tout endroit de votre document qui doit indiquer la date actuelle. Comparez cette option à Date courante (fixe).

Une fois la date sélectionnée, une boîte de dialogue apparaît.

La boîte déroulante précise le format de la variable. Les possibilités sont :

Locale

  Ceci insère la date au format défini dans le Centre de configuration de KDE.

  Pour sélectionner cette option, vérifiez simplement que la boîte déroulante du haut indique Locale. Une prévisualisation du format de la date apparaît sous la case à cocher Personnalisée. Si vous êtes satisfait de ce choix, cliquez sur le bouton OK.

Dates préformatées

  &kword; propose 12 dates préformatées. Ces formats prédéfinis sont ceux nécessaires dans la plupart des cas. Sélectionnez simplement le format prédéfini dans la boîte déroulante du haut. Une prévisualisation du format de la date apparaît sous la case à cocher Personnalisée. Si vous êtes satisfait par ce choix, cliquez sur le bouton OK.

Date personnalisée

  Si le format approprié de date ne peut être trouvé, il est possible de créer des formats de date personnalisés.

  Un format de date consiste en une liste de lettres et de nombres qui suivent des règles spécifiques (qui sont détaillées plus loin) pour créer une date complète.

  Le format de date est constitué de mots-clefs et de séparateurs. Les mots-clefs sont définis dans les trois tables suivantes.

  Jours

  Mots-clefs des jours | d | dd | ddd | dddd
  Exemple | 6 | 06 | Jeu | Jeudi

  Mois

  Mots-clefs des mois | M | MM | MMM | MMMM
  Exemple | 3 | 03 | Mar | Mars

  Année

  Mots-clefs des années | yy | yyyy
  Exemple | 02 | 2002

  Combinez simplement les mots clefs avec du texte normal (séparateurs) pour créer un format de date.

  Par exemple :

  MM/dd/yyyy est traduit en 03/06/2002

  et

  MMMM d, yyyy devient Mars 6, 2002

  Remarquez que seuls les mots-clefs sont changés. Les espaces, virgules, slash et autres textes restent inchangés.

  Il est important de se souvenir que les mots-clefs sont sensibles à la casse. DD n'est pas un mot-clef, mais dd l'est.

  Pour créer un format de date personnalisé, cochez la case Personnalisé.

  Maintenant, saisissez les mots clefs et les séparateurs dans la boîte déroulante du haut. Vous pouvez aussi sélectionner le format depuis la boîte déroulante Insérer et le mot clef sera inséré dans le format de date où se trouve le curseur.

Une prévisualisation du format de date est visible sous la case Personnalisé. Cliquez sur le bouton OK quand le format de date est correct pour être inséré dans votre document.

Une fois que la date a été insérée dans votre document, elle peut être reformatée d'une manière différente et passer de l'état fixe à variable et vice versa. Cliquez simplement avec le &BDS; sur la date. Un menu contextuel apparaît. Sélectionnez Changer la variable en..., un sous-menu apparaît. Sélectionnez la nouvelle variable ou le nouveau format depuis ce menu. La variable sera mise à jour instantanément.

### Insérer l'heure

Pour insérer l'heure dans un document, placez simplement le curseur sur la zone de texte ou l'heure doit être insérée et sélectionnez Insertion VariableHeure dans la barre de menus. Ceci vous proposera deux choix : Heure courante (fixe) et Heure courante (variable) .

Heure courante (fixe)

  Sélectionner cette option va insérer l'heure courante à la position actuelle du curseur. Cette heure est déterminée en consultant l'horloge de l'ordinateur. Une fois saisie, cette valeur ne changera pas même si vous demandez à &kword; de mettre à jour les variables du document.

  C'est la variable idéale pour faire des horodatages. Comparez ce choix avec Heure courante (variable).

Heure courante (variable)

  Sélectionner cette option va insérer l'heure courante à la position actuelle du curseur. Cette heure est déterminée en consultant l'horloge de l'ordinateur. Cette valeur changera si vous demandez à &kword; de mettre à jour les variables du document.

  Cette option est un bon choix pour tout endroit de votre document qui doit indiquer l'heure actuelle. Comparez cette option à Heure courante (fixe).

Ceci fait apparaître une boîte de dialogue.

La boîte déroulante précise le format de la variable. Les possibilités sont :

Locale

  Ceci insère l'heure au format défini dans le Centre de configuration de KDE.

  Pour sélectionner cette option, vérifiez simplement que la boîte déroulante du haut indique Locale. Une prévisualisation du format de l'heure apparaît sous la case à cocher Personnalisée. Si vous êtes satisfait par ce choix, cliquez sur le bouton OK.

Heures préformatées

  &kword; propose 5 heures préformatées. Ces formats prédéfinis sont ceux nécessaires dans la plupart des cas. Sélectionnez simplement le format prédéfini dans la boîte déroulante du haut. Une prévisualisation du format de l'heure apparaît sous la case à cocher Personnalisée. Si vous êtes satisfait par ce choix, cliquez sur le bouton OK.

Date personnalisée

  Si le format approprié d'heure ne peut être trouvé, il est possible de créer des formats d'heure personnalisés.

  Un format d'heure consiste en une liste de lettres et de nombres qui suivent des règles spécifiques (qui sont détaillées plus loin) pour créer une heure complète.

  Le format d'heure est constitué de mots-clefs et de séparateurs. Les mots-clefs sont définis dans les cinq tables suivantes.

  Heures

  Mots-clefs des heures | h | hh
  Exemple | 6 | 06

  Minutes

  Mots-clefs des minutes | m | mm
  Exemple | 3 | 03

  Secondes

  Mots-clefs des secondes | s | ss
  Exemple | 2 | 02

  Millisecondes

  Mots clefs des millisecondes | zzz
  Exemple | 022

  Secondes

  Mots clefs AM/PM | ap | AP
  Exemple | am | AM

  Combinez simplement les mots-clefs avec du texte normal (séparateurs) pour créer un format d'heure.

  Par exemple :

  hh:mm:ss devient 06:23:13

  et

  h:mm ap devient 6:23 am

  Remarquez que seuls les mots-clefs sont changés. Les espaces, virgules, slash et autres textes restent inchangés.

  Il est important de se souvenir que les mots clefs sont sensibles à la casse. HH n'est pas un mot-clef, mais hh l'est.

  Pour créer un format d'heure personnalisé, cochez la case Personnalisé.

  Maintenant, saisissez les mots clefs et les séparateurs dans la boîte déroulante du haut. Vous pouvez aussi sélectionner le format depuis la boîte déroulante Insérer et le mot clef sera inséré dans le format d'heure où se trouve le curseur.

  Une prévisualisation du format d'heure est visible sous la case Personnalisée. Cliquez sur le bouton OK quand le format d'heure est correct pour être inséré dans votre document.

Une prévisualisation du format d'heure est visible sous la case Personnalisée. Cliquez sur le bouton OK quand le format d'heure est correct pour être inséré dans votre document.

Une fois que l'heure a été insérée dans votre document, elle peut être reformatée d'une manière différente et passer de l'état fixe à variable et vice versa. Cliquez simplement avec le &BDS; sur l'heure. Un menu contextuel apparaît. Sélectionnez Changer la variable en..., un sous-menu apparaît. Sélectionnez la nouvelle variable ou le nouveau format depuis ce menu. La variable sera mise à jour instantanément.

## Numérotation de page

Insérer le numéro de page est chose fort simple avec &kword;.

Il y a deux variables relatives à la numérotation des pages : la page courante et le nombre de pages.

Pour insérer le numéro de la page courante, placez simplement le curseur sur la zone de texte où le numéro doit être inséré et sélectionnez Insertion VariablePage Numéros de page dans la barre de menus. Le numéro de la page courante sera inséré à la position actuelle du curseur.

Pour insérer le nombre total de pages, placez simplement le curseur sur la zone de texte où le numéro doit être inséré et sélectionnez Insertion VariablePage Nombre de pages dans la barre de menus. Le nombre total de pages sera inséré à la position actuelle du curseur.

Les numéros de pages sont mis à jour dynamiquement quand le document est modifié.

Les numéros de pages sont généralement utilisés dans les en têtes et pieds de page. Cela permet d'être certain que chaque page est numérotée au bon endroit.

## Titre de section

Vous pouvez insérer un titre de section où vous voulez dans le document en sélectionnant Insérer VariablePage Titre de section dans la barre de menus.

&kword; détermine le titre de section en commençant une recherche depuis le haut de la page. Le premier paragraphe avec le style Titre 1 sera le titre de section. S'il n'y a pas un tel paragraphe sur cette page, &kword; continuera sa recherche sur les précédentes pages jusqu'à ce qu'il en trouve un.

## Autres variables

&kword; propose d'autres variables couramment utilisées que vous pourrez trouver utiles. Cet ensemble de variables est spécifique à votre document. Vous pouvez insérer ces variables en sélectionnant Insérer VariableInformations sur le document dans la barre de menus. Une liste de variables vous sera proposée. Ces variables sont détaillées ci-dessous.

Variable | Exemple | Détails
--- | --- | ---
Nom du fichier | Resume.kwd | Insère le nom du fichier dans le document.
Nom de l'auteur | Joseph | Le nom de l'auteur comme précisé dans les Informations sur le document
Ville | Paris | La ville est précisée dans les Informations sur le document
Société | KDE | Le nom de la société est précisé dans les Informations sur le document.
Pays | France | Le nom du pays est précisé dans les Informations sur le document.
Nom du dossier | /home/juser/kword | C'est le nom du dossier qui contient le document. Le nom du fichier n'est pas précisé dans cette variable.
Dossier et nom de fichier | /home/juser/kword/Resume.kwd | Le chemin complet du fichier.
Résumé du document | C'est le résumé actuel du document. | Le résumé est précisé dans les Informations sur le document
Titre du document | CV | Le nom du document est précisé dans les Informations sur le document
Adresse électronique | joeuser@kde.org | L'adresse électronique de l'auteur est précisée dans les Informations sur le document.
Fax | N'importe quel numéro de fax valable | Le numéro de fax est précisé dans les Informations sur le document.
Nom de fichier | Resume.kwd | Le nom complet du fichier
Nom de fichier sans extension | Resume | Le suffixe du nom de fichier est enlevé (d'habitude .kwd).
Code postal | N'importe quel code postal valable. | Le code postal est précisé dans les Informations sur le document.
Rue | 1 avenue des Champs-Élysées. | La rue est précisée dans les Informations sur le document.
Téléphone | N'importe quel numéro de téléphone valable. | Le numéro de téléphone est précisé dans les Informations sur le document.
Titre | Directeur des systèmes d'informations | Le titre est précisé dans les Informations sur le document.

Les variables non initialisées apparaîtront comme <none> tant que leur valeur ne sera pas définie dans les Informations sur le document.

## Variables personnalisées

&kword; propose beaucoup de variables prédéfinies. Vous pouvez trouver néanmoins qu'il serait agréable de définir vos propres variables pour un document.

En utilisant Variables personnalisées, vous pouvez créer un nombre illimité de variables pour chaque document.

### Créer une variable personnalisée

Pour créer une variable personnalisée, placez le curseur à l'endroit où vous voulez insérer votre variable.

Sélectionnez Insérer Variable PersonnaliséeNouvelle dans la barre de menus. Ceci ouvrira une boîte de dialogue.

Entrez le nom de la variable et sa valeur dans la boîte de dialogue proposée.

Cliquez sur OK pour créer la nouvelle variable et insérer sa valeur à la position du curseur. Cliquez sur Annuler pour annuler la création de la nouvelle variable.

Il est maintenant possible d'insérer cette nouvelle variable n'importe où dans le document.

### Modifier la valeur d'une variable personnalisée

Afin d'être utiles, les variables doivent avoir une valeur et être capable d'en changer facilement. Pour changer la valeur d'une variable :

Sélectionnez Outils Variables personnalisée... dans la barre de menus. Ceci ouvrira une boîte de dialogue.

Chaque variable personnalisée possède une ligne dans cette table. La première colonne contient le nom de la variable et la seconde sa valeur.

Pour changer la valeur des variables, cliquez simplement sur la zone de texte à droite de la valeur. Saisissez la valeur voulue.

Quand tous les changements sont faits, cliquez sur le bouton OK et toutes les variables seront mises à jour.

### Insérer une variable personnalisée

Pour insérer une nouvelle variable personnalisée, sélectionnez Insérer VariablePersonnalisée dans la barre de menus. Cliquez sur le nom de la variable voulue et &kword; insérera cette variable, avec sa valeur actuelle, à l'emplacement du curseur.

## Mettre à jour toutes les valeurs des variables

Vous pouvez demander à &kword; de mettre à jour toutes les valeurs des variables (pour être certain que toutes les variables sont positionnées sur leur valeur actuelle). Ceci est particulièrement important pour les dates et les heures.

Sélectionnez simplement Insérer VariableActualiser toutes les variables dans la barre de menus.

## Mettre à jour une seule date ou heure

Vous pouvez demander à &kword; de ne mettre à jour qu'une seule variable de date ou heure et laisser les autres inchangées.

Placez la souris sur la variable que vous désirez mettre à jour et cliquez avec le &BDS;. Un menu contextuel apparaît et vous propose plusieurs options pour formater la date ou l'heure et changer l'état de fixe à variable. Sélectionnez l'option désirée et la variable sera mise à jour immédiatement.