# 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 temporelles. 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 modification du document).

&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 Variable Date dans la barre de menus. Deux choix vous seront proposés : 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 dans 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 liste 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 liste 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 liste 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 pour les jours | j | jj | jjj | jjjj
  Exemple | 6 | 06 | Jeu | Jeudi

  Mois

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

  Année

  Mots-clefs pour l'année | aa | aaaa
  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, barres obliques 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 en est un.

  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 à l'endroit 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 l'insérer dans votre document.

Une fois la date 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 où l'heure doit être insérée et sélectionnez Insertion Variable Heure dans la barre de menus. Deux choix vous seront proposés : 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.

  C'est la bonne option pour indiquer l'heure à tout endroit de votre document où l'heure doit être actuaisée. Comparez cette option à Heure courante (fixe).

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

La liste déroulante du haut précise le format de la variable. Les diverses 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 liste déroulante du haut indique Locale. Une prévisualisation du format de l'heure apparaît sous la case à cocher Personnalisée. Si ce choix vous satisfait, 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 aucun format d'heure approprié 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 pour l'heure | h | hh
  Exemple | 6 | 06

  Minutes

  Mots-clefs pour les minutes | m | mm
  Exemple | 3 | 03

  Secondes

  Mots-clefs pour les secondes | s | ss
  Exemple | 2 | 02

  Millisecondes

  Mots-clefs pour les millisecondes | zzz
  Exemple | 022

  Secondes

  Mots-clefs pour 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, barres obliques 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 en est un.

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

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

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

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

Une fois l'heure 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, là où le numéro doit être inséré et sélectionnez Insertion Variable Page Numéro 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 Variable Page 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 Variable Page 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; fournit d'autres variables couramment utilisées qui peuvent vous être utiles. Ce jeu de variables est spécifique au document. Vous pourrez les insérer en choisissant Insertion Variable Informations sur le document dans la barre de menus. Ceci ouvrira une liste de variables. Les variables sont détaillées plus bas.

Variable | Exemple | Détails
--- | --- | ---
Nom du fichier | Resume.kwd | Insère le nom de fichier du document.
Nom de l'auteur | Joseph Dupont | Le nom de l'auteur comme spécifié dans les Informations sur le document.
Ville | Paris | Le code postal spécifié dans la boîte d'Informations sur le document.
Nom de la société | KDE | Le nom de la société spécifié dans la boîte d'Informations sur le document.
Pays | France | Le nom de pays spécifié dans la boîte d'Informations sur le document.
Nom du dossier | /home/jdupont/kword | C'est le nom du dossier du document. Le nom de fichier n'est pas compris dans la variable de nom de dossier.
Dossier et nom de fichier | /home/jdupont/kword/Resume.kwd | Le dossier et le nom du fichier courant.
Résumé du document | C'est le résumé du document courant. | Le résumé du document spécifié dans la boîte d'Informations sur le document.
Titre du document | Mon résumé | Le titre du document spécifié dans la boîte d'Informations sur le document.
Adresse électronique | jdupont@kde.org | L'adresse électronique spécifiée dans la boîte d'Informations sur le document.
Fax | Tout numéro de téléphone valable | Le numéro de fax spécifié dans la boîte d'Informations sur le document.
Nom du fichier | Resume.kwd | Le nom complet du fichier.
Nom du fichier sans extension | Abrégé | Ceci supprime le suffixe (habituellement .kwd) du nom du fichier.
Code postal | Tout code postal valable | Le code postal spécifié dans la boîte d'Informations sur le document.
Rue | 123 Grand Rue | La rue de l'adresse spécifiée dans la boîte d'Informations sur le document.
Téléphone | Tout numéro de téléphone valable | Le numéro de téléphone spécifié dans la boîte d'Informations sur le document.
Titre | Directeur des systèmes d'information | Le titre spécifié dans la section des auteurs de la boîte d'Informations sur le document.

Les variables non initialisées apparaîtront comme <Aucun> 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 rencontrer des documents où il peut être agréable de définir vos propres variables.

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ée Nouvelle dans la barre de menus. Ceci ouvrira une boîte de dialogue.

Saisissez 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 Variable Personnalisé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 Variable Actualiser 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 d'heure et de laisser les autres inchangées.

Placez le curseur de 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 immédiatement mise à jour.