# Manuel de l’éditeur de configuration

2004 Sun Microsystems
2006.Aymeric Nys (aymeric@nnx.com)
2006-2008.Claude Paroz (claude@2xlibre.net)
Projet de documentation GNOME

Permission vous est donnée de copier, distribuer et/ou modifier ce document selon les termes de la Licence GNU Free Documentation License, Version 1.1 ou ultérieure publiée par la Free Software Foundation sans section inaltérable, sans texte de première page de couverture ni texte de dernière page de couverture. Vous trouverez un exemplaire de cette licence en suivant ce lien ou dans le fichier COPYING-DOCS fourni avec le présent manuel.

Ce manuel fait partie de la collection de manuels GNOME distribués selon les termes de la licence de documentation libre GNU. Si vous souhaitez distribuer ce manuel indépendamment de la collection, vous devez joindre un exemplaire de la licence au document, comme indiqué dans la section 6 de celle-ci.

La plupart des noms utilisés par les entreprises pour distinguer leurs produits et services sont des marques déposées. Lorsque ces noms apparaissent dans la documentation GNOME et que les membres du projet de Documentation GNOME sont informés de l'existence de ces marques déposées, soit ces noms entiers, soit leur première lettre est en majuscule.

LE PRÉSENT DOCUMENT ET SES VERSIONS MODIFIÉES SONT FOURNIS SELON LES TERMES DE LA LICENCE DE DOCUMENTATION LIBRE GNU SACHANT QUE :

1. LE PRÉSENT DOCUMENT EST FOURNI « TEL QUEL », SANS AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, Y COMPRIS, ET SANS LIMITATION, LES GARANTIES DE MARCHANDABILITÉ, D'ADÉQUATION À UN OBJECTIF PARTICULIER OU DE NON INFRACTION DU DOCUMENT OU DE SA VERSION MODIFIÉE. L'UTILISATEUR ASSUME TOUT RISQUE RELATIF À LA QUALITÉ, À LA PERTINENCE ET À LA PERFORMANCE DU DOCUMENT OU DE SA VERSION DE MISE À JOUR. SI LE DOCUMENT OU SA VERSION MODIFIÉE S'AVÉRAIT DÉFECTUEUSE, L'UTILISATEUR (ET NON LE RÉDACTEUR INITIAL, L'AUTEUR, NI TOUT AUTRE PARTICIPANT) ENDOSSERA LES COÛTS DE TOUTE INTERVENTION, RÉPARATION OU CORRECTION NÉCESSAIRE. CETTE DÉNÉGATION DE RESPONSABILITÉ CONSTITUE UNE PARTIE ESSENTIELLE DE CETTE LICENCE. AUCUNE UTILISATION DE CE DOCUMENT OU DE SA VERSION MODIFIÉE N'EST AUTORISÉE AUX TERMES DU PRÉSENT ACCORD, EXCEPTÉ SOUS CETTE DÉNÉGATION DE RESPONSABILITÉ ;

2. EN AUCUNE CIRCONSTANCE ET SOUS AUCUNE INTERPRÉTATION DE LA LOI, QU'IL S'AGISSE D'UN DÉLIT CIVIL (Y COMPRIS LA NÉGLIGENCE), CONTRACTUEL OU AUTRE, L'AUTEUR, LE RÉDACTEUR INITIAL, TOUT PARTICIPANT OU TOUT DISTRIBUTEUR DE CE DOCUMENT OU DE SA VERSION MODIFIÉE, OU TOUT FOURNISSEUR DE L'UNE DE CES PARTIES NE POURRA ÊTRE TENU RESPONSABLE À L'ÉGARD DE QUICONQUE POUR TOUT DOMMAGE DIRECT, INDIRECT, PARTICULIER, OU ACCIDENTEL DE TOUT TYPE Y COMPRIS, SANS LIMITATION, LES DOMMAGES LIÉS À LA PERTE DE CLIENTÈLE, À UN ARRÊT DE TRAVAIL, À UNE DÉFAILLANCE OU UN MAUVAIS FONCTIONNEMENT INFORMATIQUE, OU À TOUT AUTRE DOMMAGE OU PERTE LIÉE À L'UTILISATION DU DOCUMENT ET DE SES VERSIONS MODIFIÉES, MÊME SI LADITE PARTIE A ÉTÉ INFORMÉE DE L'ÉVENTUALITÉ DE TELS DOMMAGES.

Sun Équipe de documentation GNOME
Sun Microsystems
Angela Boyle
Projet de documentation GNOME
Shaun McCance
Projet de documentation GNOME

L'éditeur de configuration permet de modifier certaines options de configuration inaccessibles depuis les préférences d'une application.

Version 2.8
Septembre 2004

Projet de documentation GNOME

Projet de documentation GNOME

non relu

Version 2.1
Août 2004

Équipe de documentation GNOME de Sun

Projet de documentation GNOME

Version 2.0.1
Janvier 2004

Équipe de documentation GNOME de Sun

Projet de documentation GNOME

Ce manuel documente la version 2.8 de l’Éditeur de configuration.

Votre avis

Pour signaler une anomalie ou émettre une suggestion concernant ce programme ou ce manuel, procédez comme indiqué à la Page de réactions sur GNOME.

## Introduction

Le bureau GNOME et d’autres applications utilisent GConf pour enregistrer les préférences des utilisateurs et les données de configuration du système. GConf fournit un lieu central pour l’enregistrement des préférences, simplifiant la gestion des configurations pour les utilisateurs et administrateurs système. Plus d’informations au sujet de GConf sont disponibles dans le Guide de l’administrateur système GNOME.

L’éditeur de configuration permet aux utilisateurs de modifier leurs préférences pour l’ensemble du bureau GNOME et pour n’importe quelle application utilisant GConf. De plus, les administrateurs système peuvent utiliser l’éditeur de configuration pour régler les valeurs par défaut et obligatoires des paramètres qui affecteront tous les utilisateurs.

Les valeurs des préférences sont enregistrées par GConf en une hiérarchie de clés. Chaque clé a une valeur associée qui définit un paramétrage pour cette préférence. Par exemple, la clé `/apps/glines/preferences/ball_theme` enregistre le thème utilisé par le jeu Cinq ou plus.

L’éditeur de configuration permet de modifier directement la source de votre configuration. Si vous n’êtes pas un utilisateur expérimenté, n’utilisez pas l’éditeur de configuration pour définir vos préférences du bureau GNOME. À la place, utilisez les outils fournis par le bureau GNOME pour gérer vos préférences. Pour plus d'informations sur la façon d’utiliser ces outils, consultez la dernière version du Guide d'utilisation du bureau GNOME de votre plate-forme.

## Premiers pas

### Démarrage de l’éditeur de configuration

Vous pouvez démarrer l’éditeur de configuration des façons suivantes :

Menu Applications

  Choisissez Outils système Éditeur de configuration.

  Certaines distributions masquent ce menu. Dans ce cas, utilisez la seconde méthode décrite ci-dessous.

Ligne de commande

  Exécutez la commande suivante : `gconf-editor`

### Au démarrage de l’éditeur de configuration

Au démarrage de l’éditeur de configuration, la fenêtre suivante est affichée.

Fenêtre de l'Éditeur de configuration

Montre la fenêtre de l’éditeur GConf. Légende : volet représentant l’arborescence des clés, volet de modification, volet de documentation.

La fenêtre de l’éditeur de configuration contient les volets suivants :

Arborescence des clés

  Permet de naviguer la hiérarchie de clés dans GConf. Utilisez ce volet pour afficher les clés à modifier dans le volet de modification. L’arborescence occupe la partie gauche de la fenêtre.

Volet de modification

  Affiche les clés de l’emplacement sélectionné dans l’arborescence. Utilisez ce volet pour sélectionner les clés à modifier et pour modifier leurs valeurs. Le volet de modification occupe la partie supérieure droite de la fenêtre.

  Dans le volet de modification, des icônes se trouvent à côté des clés. Ces icônes indiquent le type de valeur acceptable pour les clés. Par exemple, l’icône avec une coche à côté de la clé `/system/http_proxy/use_http_proxy` signale l’utilisation d’une valeur booléenne (Vrai ou Faux) pour cette clé. Consultez pour plus d’informations sur chaque icône.

Volet de documentation

  Ce volet affiche la documentation de la clé sélectionnée. Utilisez ce volet pour lire les informations au sujet des clés de préférence de GConf.

Volet de résultats (non montré)

  Ce volet permet de voir le résultat d’une recherche ou de rechercher à travers la liste des clés récemment vues. Le reste de la fenêtre montre les informations de la clé sélectionnée. Le volet de résultats apparaît au bas de la fenêtre lorsque vous listez les clés récentes ou effectuez une recherche.

## Utilisation des fenêtres

### Ouverture de nouvelles fenêtres

L’éditeur de configuration possède trois types de fenêtre : Paramètres, Paramètres par défaut, et Paramètres obligatoires. Les valeurs que l’éditeur de configuration va régler dépendent du type de fenêtre ouverte. Vous pouvez ouvrir chaque type de fenêtre avec le sous-menu approprié dans le menu Fichier.

Dans la mesure où les réglages dans les fenêtres Paramètres par défaut et Paramètres obligatoires affectent tous les utilisateurs de l’ordinateur, seul un administrateur système est autorisé à utiliser ces fenêtres. Pour changer vos préférences, vous devez utiliser la fenêtre Paramètres.

Paramètres

  La fenêtre Paramètres permet de régler vos préférences personnelles. Les changements effectués dans cette fenêtre n’affectent que votre bureau. Vous ne pouvez pas changer les réglages que l’administrateur système a rendus obligatoires.

Paramètres par défaut

  Si vous êtes un administrateur système, vous pouvez utiliser la fenêtre Paramètres par défaut pour éditer les réglages par défaut de tous les utilisateurs. Si un utilisateur ne règle pas explicitement la valeur d’une clé, la valeur employée proviendra des réglages par défaut. Les utilisateurs peuvent toujours redéfinir les réglages par défaut.

Paramètres obligatoires

  Si vous êtes un administrateur système, la fenêtre Paramètres obligatoires permet d'éditer les réglages obligatoires de tous les utilisateurs. Lorsqu’une valeur obligatoire est définie pour une clé, les utilisateurs n’ont pas la possibilité de changer cette valeur. Ceci peut être utilisé pour verrouiller certaines options.

### Fermer et quitter

Vous pouvez fermer une fenêtre de l’éditeur de configuration en sélectionnant Fichier Fermer la fenêtre. Pour fermer toutes les fenêtres de l’éditeur de configuration et quitter complètement l’application, sélectionnez Fichier Quitter dans n’importe quelle fenêtre de l’application.

## Utilisation des clés

Une clé est un moyen pour accéder à une valeur. Chaque préférence enregistrée dans GConf est associée à une clé. Les applications utilisant GConf accèdent aux valeurs de ces clés pour déterminer leur apparence et leur comportement. Lorsque vous changez quelque chose dans les Préférences d’une application, vous changez une valeur associée à une clé dans GConf.

### Copie du nom d’une clé

Pour copier le nom d’une clé dans le presse-papiers, sélectionnez le nom de la clé à copier dans le volet de modification. Choisissez Édition Copier le nom de la clé. Vous pouvez coller le nom de la clé dans n’importe quelle autre application.

### Affichage des clés récentes

Pour afficher les clés récentes, choisissez Édition Afficher les clés récentes. Cette action ouvre le volet de résultats au bas de la fenêtre courante. Vous pouvez vous déplacer dans la liste de résultats en faisant défiler la barre de défilement ou en utilisant les touches fléchées. L’information relative à la clé sélectionnée ou au dossier s'affiche dans le reste de la fenêtre.

Voir une clé récente est utile si vous devez retrouver une clé que vous avez changé récemment, mais que vous ne vous souvenez plus de sa localisation.

Une capture d'écran pourrait être judicieuse. Il faudrait notamment expliquer les boutons fermer, copier et effacer dans le volet des résultats.

### Modification de la valeur d’une clé

L’icône située à côté du nom d’une clé montre le type de valeur que cette clé peut prendre. Consultez pour plus d’informations sur chaque icône. Pour modifier la valeur d’une clé, suivez les étapes suivantes :

- Utilisez l’arborescence pour afficher dans le volet de modification la clé à modifier.

- Sélectionnez la clé à modifier dans le volet de modification.

- Pour changer la valeur d’une clé représentant un nombre entier ou une chaîne de caractères, cliquez sur la colonne Valeur de la clé. Saisissez la nouvelle valeur pour la clé. Vous pouvez aussi cliquer avec le bouton droit de la souris sur la clé et choisir Éditer la clé du menu contextuel.

  Pour changer la valeur d’une clé booléenne, cliquez dans la colonne Valeur de la clé pour cocher ou décocher la case. Vous pouvez aussi cliquer avec le bouton droit de la souris sur la clé et choisir Éditer la clé depuis le menu contextuel.

  Pour changer la valeur d’une clé de type liste, cliquez avec le bouton droit de la souris sur la clé et choisir Éditer la clé du menu contextuel. La fenêtre Éditer la clé fournit une liste de valeurs associées à cette clé. Vous pouvez utiliser cette boîte de dialogue pour éditer chaque valeur de la liste, ajouter ou retirer des valeurs de la liste et déplacer chaque valeur dans la liste.

Votre administrateur système a peut-être verrouillé certaines clés en fournissant des valeurs obligatoires. Si une valeur obligatoire est définie pour la clé sélectionnée, vous ne pouvez pas la modifier. Le volet de documentation affiche le texte Cette clé est en lecture seule si vous n’êtes pas autorisé à éditer la valeur de cette clé.

## Recherche rapide d'une clé

Pour localiser rapidement une clé, il est possible d’effectuer une recherche sur le nom de la clé. Vous pouvez également utiliser les signets pour accéder aux clés ou répertoires que vous utilisez fréquemment.

### Utilisation des signets

Pour accéder à un répertoire à partir d’un signet, choisissez le répertoire dans le menu Signets. Vous pouvez ajouter ou enlever des répertoires à ce menu.

Pour ajouter un signet, sélectionnez le répertoire à ajouter dans l’arborescence, puis choisissez Signets Ajouter un signet.

Pour supprimer un signet, effectuez les étapes suivantes :

- Choisissez Signets Éditer les signets.

- Sélectionnez le signet dans la fenêtre Éditer les signets, puis cliquez sur le bouton Supprimer.

- Cliquez sur Fermer.

### Recherche de clés

Pour rechercher des clés, effectuez les étapes suivantes :

- Choisissez Édition Rechercher.

- Saisissez le mot clé à rechercher dans le champ Rechercher. Vous avez aussi la possibilité de cocher les cases Rechercher aussi les noms de clé et Rechercher aussi les valeurs de clé. Si ces cases ne sont pas cochées, la recherche s’effectue seulement sur les noms de répertoire. Cocher ces cases étend la recherche.

- Cliquez sur Rechercher.

Les résultats de la recherche apparaissent dans le volet de résultats. Pour vous déplacer dans la liste, sélectionnez d’abord le volet. Ensuite, vous pouvez vous déplacer avec la barre de défilement ou les touches fléchées. Les informations d’une clé ou d’un répertoire sélectionné s’affichent dans le reste de la fenêtre.

Une capture d'écran pourrait être judicieuse. Il faudrait notamment expliquer les boutons fermer, copier et effacer dans le volet des résultats.

## Réglages par défaut et obligatoires

Si vous êtes un administrateur système, vous pouvez fixer des réglages par défauts et obligatoires qui affecteront tous les utilisateurs. Les réglages par défaut sont utilisés lorsqu’un utilisateur n’a pas réglé une valeur explicitement. Les utilisateurs peuvent redéfinir ces valeurs. Les réglages obligatoires sont toujours utilisés par tous les utilisateurs, et ils ne peuvent pas être redéfinis par les utilisateurs.

Vous pouvez utilisez les fenêtres Paramètres par défaut et Paramètres obligatoires pour éditer et supprimer les réglages par défaut et obligatoires. Les fenêtres Paramètres par défaut et Paramètres obligatoires ne montrent que les réglages qui sont mis par défaut ou obligatoires. Vous ne pouvez pas utiliser ces fenêtres pour créer de nouveaux réglages par défaut ou obligatoires. Utilisez la fenêtre Paramètres pour cela.

Pour ouvrir une fenêtre Paramètres par défaut, choisissez Fichier Nouvelle fenêtre de réglages par défaut. Pour ouvrir une fenêtre Paramètres obligatoires, choisissez Fichier Nouvelle fenêtre de réglages obligatoires.

### Création de réglages par défaut

Pour créer un réglage par défaut, effectuez les étapes suivantes :

- Dans la fenêtre Paramètres, utilisez l’arborescence pour afficher la clé à définir par défaut.

- Cliquez avec le bouton droit de la souris et sélectionnez Définir par défaut à partir du menu contextuel.

### Création de réglages obligatoires

Pour créer des réglages obligatoires, effectuez les étapes suivantes :

- Dans la fenêtre Paramètres, utilisez l’arborescence pour afficher la clé à définir comme obligatoire.

- Cliquez avec le bouton droit de la souris et sélectionnez Définir comme obligatoire à partir du menu contextuel.

### Modification et suppression de réglages par défaut et obligatoires

Vous pouvez utiliser les fenêtres Paramètres par défaut et Paramètres obligatoires pour modifier ou supprimer un réglage par défaut ou obligatoire. Pour cela, utilisez la fenêtre appropriée et modifiez la clé comme vous le feriez dans la fenêtre Paramètres. Consultez pour plus d’informations sur la modification des clés.

Pour supprimer une clé par défaut ou obligatoire, effectuez les étapes suivantes :

- Dans la fenêtre appropriée, utilisez l’arborescence pour afficher la clé à retirer des réglages par défaut ou obligatoire.

- Cliquez avec le bouton droit de la souris sur la clé et sélectionnez Désactiver la clé dans le menu contextuel.

## Icônes et types de clé

Les icônes à côté des clés dans le volet de modification indiquent le type de valeur acceptable pour les clés. La liste suivante montre les icônes utilisées et les types de valeurs qu’elles représentent.

Clé booléenne

  Peut être soit vrai, soit faux. L’éditeur de configuration fournit une case à cocher pour ce type de clé.

Clé numérique

  Peut contenir des nombres. Il peut s’agir de nombres entiers ou de nombres réels.

Clé chaîne de caractères

  Peut contenir n’importe quelle chaîne de caractères.

Clé schéma

  Ce type de clé est utilisé pour documenter d’autres clés. La documentation pour chaque clé est fournie par une clé séparée, typiquement dans le répertoire `/schemas`. Habituellement, les utilisateurs et administrateurs système n’ont pas besoin de travailler avec les clés schéma directement.

Clé liste

  Listes de longueur arbitraire. Chaque élément de la liste doit être du même type, et d’un type primitif : booléen, numérique ou chaîne de caractères.

Clé paire

  Peut contenir exactement deux valeurs. Les deux valeurs doivent être d’un type primitif, mais elles n’ont pas besoin d’être du même type. Actuellement, l’éditeur de configuration est incapable d’éditer les clés paires.

Vide

  Utilisé lorsque l’éditeur de configuration ne comprend pas le type de la clé. L’icône vide est aussi utilisée pour les clés paires.

Éditeur GConf