# Outils et utilitaires

Ce chapitre documente quelques outils et utilitaires du bureau GNOME.

## Lancement d'applications

La boîte de dialogue « Lancer une application » donne accès à la ligne de commande. Lorsque vous exécutez une commande dans la boîte de dialogue « Lancer une application », vous n'obtenez cependant pas l'écho du résultat de la commande.

Pour exécuter une commande au moyen de la ligne de commande, effectuez les opérations suivantes :

1. Ouvrez la boîte de dialogue Lancer une application en utilisant l'une des méthodes suivantes :

   À partir d'un tableau de bord

2. Vous pouvez ajouter le bouton Lancer une application à n'importe quel tableau de bord. Référez-vous à la panels-addobject. Cliquez sur le bouton Lancer une application pour ouvrir la boîte de dialogue Lancer une application.

À l'aide de raccourcis clavier

- Appuyez sur Alt F2. Ce raccourci clavier peut être modifié dans le panneau de préférences Raccourcis clavier.

La boîte de dialogue Lancer une application apparaît.

- Saisissez la commande à exécuter dans le champ vierge, ou faites un choix parmi la liste des applications connues.

  Si vous saisissez l'emplacement d'un fichier, l'application appropriée se lance pour l'ouvrir. Si vous saisissez l'adresse d'une page Web, le navigateur Web par défaut va ouvrir la page. Préfixez l'adresse de la page avec « http:// », comme dans http://www.gnome.org.

  Pour retrouver une commande précédemment saisie, cliquez sur la flèche à droite de la zone de saisie, puis sélectionnez la commande à exécuter.

  Vous pouvez aussi choisir un fichier à ajouter à la ligne de commande en cliquant sur le bouton Lancer avec un fichier. Par exemple, vous pouvez saisir la commande gedit, puis choisir un fichier à modifier.

  Cochez l'option Lancer dans un terminal pour exécuter l'application ou la commande dans une fenêtre de terminal. Cette option est utile lorsque la commande ou l'application ne crée pas elle-même de fenêtre lorsqu'elle s'exécute.

- Cliquez sur le bouton Lancer de la boîte de dialogue Lancer une application.

## Captures d'écran

Vous pouvez réaliser une capture d'écran en ayant recours à l'une des méthodes suivantes :

- À partir d'un tableau de bord

  Vous pouvez ajouter un bouton Capture d'écran à n'importe quel tableau de bord. Pour connaître la marche à suivre, consultez la panels-addobject. Cliquez sur le bouton Capture d'écran pour effectuer une capture de tout l'écran.

- À l'aide des touches de raccourci

  Pour réaliser une capture d'écran, utilisez les touches de raccourci suivantes :

  Touches de raccourci par défaut | Fonction
  Impr écran | Réalise une capture de l'écran entier.
  Alt Impr écran | Réalise une capture de la fenêtre active.

  Le panneau de préférences Raccourcis clavier permet de modifier les touches de raccourci par défaut.

- À partir de la Barre de menus

  Choisissez Applications Accessoires Capture d'écran.

- À partir d'un terminal

  La commande `gnome-screenshot` permet de réaliser une capture d'écran. La capture s'effectue pour tout l'écran et la boîte de dialogue Enregistrer la capture d'écran apparaît. Celle-ci permet d'enregistrer la capture d'écran.

  Vous pouvez également utiliser les options de la commande `gnome-screenshot` comme suit :

  Option | Fonction
  `--window` | Réalise une capture de la fenêtre active.
  `--delay=`secondes`` | Réalise une capture d'écran après le nombre de secondes spécifié et affiche ensuite la boîte de dialogue Enregistrer la capture d'écran. Celle-ci permet d'enregistrer la capture d'écran.
  `--include-border` | Réalise une capture d'écran qui inclut la bordure de la fenêtre.
  `--remove-border` | Réalise une capture d'écran sans la bordure de la fenêtre.
  `--border-effect=shadow` | Réalise une capture d'écran et ajoute un effet d'ombre portée autour d'elle.
  `--border-effect=border` | Réalise une capture d'écran et entoure la capture d'un cadre.
  `--interactive` | Ouvre une fenêtre qui vous permet de configurer les options avant de faire la capture d'écran.
  `--help` | Affiche les options de la commande.

Lorsque vous réalisez une capture d'écran, la boîte de dialogue Enregistrer la capture d'écran apparaît. Pour enregistrer la capture en tant qu'image, saisissez le nom de fichier de la capture, choisissez un emplacement dans la liste déroulante et cliquez sur le bouton Enregistrer. Vous pouvez également utiliser le bouton Copier dans le presse-papiers pour copier l'image dans le presse-papiers ou la transférer vers une autre application en faisant un glisser-déposer.

## Navigateur d'aide Yelp

### Introduction

Le navigateur d'aide Yelp permet de consulter la documentation de GNOME et d'autres composants dans des formats divers. Ces formats comprennent les fichiers Docbook, les pages d'aide HTML, les pages de manuel et les pages info (la prise en charge des pages de manuel et des pages info est une option à la compilation). En dépit des différents formats pris en charge, Yelp fait tout son possible pour présenter une apparence la plus cohérente possible quel que soit le format du document original.

Le navigateur d'aide Yelp est internationalisé, ce qui signifie qu'il prend en charge l'affichage de documents dans différentes langues. Les documents doivent bien sûr être traduits pour chaque langue et installés correctement pour que le navigateur d'aide Yelp soit capable de les afficher.

### Lancement de Yelp

#### Lancement du navigateur d'aide Yelp

Le navigateur d'aide Yelp peut être lancé de différentes manières :

Menu Système

- Choisissez Aide

Ligne de commande

- Exécutez la commande suivante : `yelp`

#### Interface

Au démarrage du navigateur d'aide Yelp, la fenêtre suivante apparaît.

##### Fenêtre du navigateur d'aide Yelp

Le navigateur d'aide Yelp contient les éléments suivants dans la fig-yelp-window

Barre de menus

- Fichier

- Ce menu permet d'ouvrir une nouvelle fenêtre, de voir la page « À propos de ce document », d'imprimer le document actuel ou de fermer la fenêtre.

Édition

- Ce menu permet de copier, de tout sélectionner, de rechercher ou de définir les préférences.

Aller

- Ce menu permet de se rendre à la page suivante ou précédente et d'afficher le sommaire de l'aide. Si vous consultez un document DocBook, ce menu permet de passer à la section suivante ou précédente et d'afficher le sommaire.

Signets

- Ce menu permet d'ajouter ou de modifier des signets.

Aide

- Ce menu permet d'afficher des informations au sujet du navigateur d'aide Yelp et des contributeurs de ce projet par l'élément de menu À propos. Ouvrez le présent document avec l'élément de menu Sommaire ou en appuyant sur F1.

Barre d'outils

- Précédent

- Ce bouton permet de remonter dans l'historique de navigation du document.

Suivant

- Ce bouton permet d'avancer dans l'historique de navigation du document.

Sommaire de l'aide

- Ce bouton permet de revenir à la table des matières principale (affichée dans la fig-yelp-window).

Volet de navigation

- Le volet de navigation contient la table des matières ou le contenu de la documentation. Cette table vous permet de trouver facilement la documentation recherchée.

### Utilisation de Yelp

#### Ouverture d'un document

Pour ouvrir un document dans le navigateur d'aide Yelp :

- Dans une application, choisissez Aide Sommaire

- Utilisez le sommaire de l'aide pour rechercher le document souhaité.

- Vous pouvez faire glisser un fichier XML Docbook depuis Nautilus vers la fenêtre ou le lanceur d'application de Yelp.

- Appuyez sur la touche F1.

Il est aussi possible d'afficher un document particulier en lançant le navigateur d'aide Yelp à partir de la ligne de commande ou en glissant les fichiers dans Yelp. Consultez yelp-advanced-cmdline pour en savoir plus à ce sujet.

#### Ouverture d'une nouvelle fenêtre

Pour ouvrir une nouvelle fenêtre :

- Choisissez Fichier Nouvelle fenêtre

- Utilisez le raccourci clavier Ctrl N

#### À propos de ce document

Pour afficher des informations sur le document actuellement ouvert :

- Choisissez Fichier À propos de ce document

Cette option n'est disponible que pour la documentation DocBook. Les notices légales et les contributeurs de la documentation sont généralement visibles dans cette section.

#### Impression d'une page

Pour imprimer n'importe quelle page visible dans le navigateur d'aide Yelp :

- Choisissez Fichier Imprimer cette page

#### Impression d'un document

Pour imprimer un document en entier :

- Choisissez Fichier Imprimer ce document

Cette option n'est disponible que pour de la documentation au format DocBook.

#### Fermeture d'une fenêtre

Pour fermer une fenêtre dans le navigateur d'aide Yelp, procédez comme suit :

- Choisissez Fichier Fermer la fenêtre

- Utilisez le raccourci clavier Ctrl W

#### Réglage des préférences

Pour paramétrer les préférences du navigateur d'aide Yelp :

- Choisissez Édition Préférences

Une fenêtre ressemblant à la yelp-preferences apparaît :

##### Fenêtre des préférences du navigateur d'aide Yelp

Les options disponibles dans cette boîte de dialogue offrent les fonctionnalités suivantes :

Utiliser les polices système

- Cochez cette option pour afficher la documentation avec les polices par défaut définies pour le bureau GNOME.

  Pour choisir vos propres polices d'affichage de la documentation, décochez cette option et cliquez sur les boutons en regard des libellés Chasse variable et Chasse fixe.

  Chasse variable

- C'est la police utilisée lorsqu'une chasse statique ou fixe n'est pas nécessaire. La majorité du texte est de ce type.

Chasse fixe

- C'est la police utilisée lorsque tous les caractères doivent avoir la même dimension. En général, cette police sert à écrire des commandes, des bouts de programme ou d'autres textes similaires.

Naviguer avec le curseur

- Cochez cette option si vous souhaitez voir apparaître le curseur dans le yelp-browser-pane. Cela permet de naviguer plus facilement dans le document, car l'emplacement du curseur est visible.

#### Recul dans l'historique de navigation

Pour remonter dans l'historique de navigation du document :

- Choisissez Aller Précédent

- Utilisez le raccourci clavier Alt Flèche gauche

- Utilisez le bouton Précédent dans la barre d'outils

#### Avance dans l'historique de navigation

Pour avancer dans l'historique de navigation du document :

- Choisissez Aller Suivant

- Utilisez le raccourci clavier Alt Flèche droite

- Utilisez le bouton Suivant dans la barre d'outils

#### Affichage du sommaire de l'aide

Pour afficher le sommaire de l'aide :

- Choisissez Aller Sommaire de l'aide

- Utilisez le raccourci clavier Alt Origine

- Utilisez le bouton Sommaire de l'aide dans la barre d'outils

#### Retour à la section précédente

Pour revenir à la section précédente :

- Choisissez Aller Section précédente

- Utilisez le raccourci clavier Alt Flèche haut

Cette option n'est disponible que pour les documents au format DocBook.

#### Passage à la section suivante

Pour passer à la section suivante :

- Choisissez Aller Section suivante

- Utilisez le raccourci clavier Alt Flèche bas

Cette option n'est disponible que pour les documents au format DocBook.

#### Affichage du sommaire du document

Pour afficher le sommaire du document :

- Choisissez Aller Sommaire

Cette option n'est disponible que pour les documents au format DocBook.

#### Ajout d'un signet

Pour ajouter un signet vers un document particulier :

- Choisissez Signets Ajouter un signet

- Utilisez le raccourci clavier Ctrl D

Une fenêtre similaire à la yelp-add-bookmark apparaît.

##### Fenêtre d'ajout de signet

Saisissez le titre du signet dans le champ Titre. Cliquez ensuite sur Ajouter pour ajouter le signet ou cliquez sur Annuler pour annuler.

#### Édition des signets

Pour éditer votre collection de signets :

- Choisissez Signets Éditer les signets

- Utilisez le raccourci clavier Ctrl B

Une fenêtre similaire à la yelp-edit-bookmarks apparaît.

##### Fenêtre d'édition des signets

Vous pouvez gérer vos signets à l'aide de cette fenêtre par les actions suivantes :

Ouvrir

- Ce bouton permet d'ouvrir le signet sélectionné dans une nouvelle fenêtre.

Renommer

- Ce bouton permet de renommer le signet sélectionné.

Enlever

- Ce bouton permet de supprimer le signet de votre collection.

Après avoir terminé de gérer vos signets, cliquez sur le bouton Fermer pour sortir de la fenêtre d'édition des signets.

#### Aide de Yelp

Pour obtenir de l'aide sur le navigateur d'aide Yelp (et donc consulter le présent document) :

- Choisissez Aide Sommaire

### Fonctions avancées

#### Ouverture de documents spécifiques

##### Ouverture de documents à partir du gestionnaire de fichiers

Pour ouvrir un document comme un fichier XML à partir du gestionnaire de fichiers, ouvrez-le dans le gestionnaire de fichiers Nautilus ou glissez son icône de Nautilus vers le volet d'affichage ou le lanceur de Yelp.

##### Utilisation de la ligne de commande pour ouvrir des documents

Le navigateur d'aide Yelp prend en charge l'ouverture de documents à partir de la ligne de commande. Plusieurs URI (Uniform Resource Identifiers) peuvent être utilisés. Notamment :

`file:`

- Cet URI donne accès à un fichier avec yelp, par exemple :

      yelp file:///usr/share/gnome/help/gcalctool/fr/gcalctool.xml

`ghelp:` ou `gnome-help:`

- Cet URI donne accès aux documents d'aide de GNOME, habituellement écrits au format DocBook.

      yelp ghelp:gcalctool

  Si vous souhaitez ouvrir le document d'aide à une section bien précise, complétez l'URI avec un point d'interrogation suivi de l'identifiant de la section.

      yelp ghelp:user-guide?yelp-advanced-cmdline

`man:`

- Cet URI donne accès à une page de manuel. Vous pouvez compléter l'URI avec le numéro de section de la page de manuel s'il en existe plusieurs avec le même nom. Le numéro de section doit être entouré de parenthèses, il est donc souhaitable de neutraliser l'argument afin que le shell n'interprète pas les parenthèses.

      yelp man:gcalctool

  ou

      yelp 'man:intro(1)'
      yelp 'man:intro(2)'

`info:`

- Cet URI donne accès à une page info GNU.

      yelp info:make

#### Actualisation du contenu sur demande

Le navigateur d'aide Yelp prend en charge le raccourci clavier Ctrl R qui recharge le document DocBook actuellement ouvert. Cela permet aux développeurs de voir les changements des documents lors de leur conception.

### Informations supplémentaires

Cette section décrit certaines applications auxiliaires utilisées par le navigateur d'aide Yelp, et présente des ressources contenant de plus amples informations au sujet du navigateur d'aide Yelp.

#### Scrollkeeper

Le navigateur d'aide Yelp utilise scrollkeeper pour générer les sommaires de la documentation DocBook et HTML, ainsi que pour garder la trace des traductions de chaque document.

#### Utilitaires de documentation GNOME

La documentation distribuée avec GNOME utilise un ensemble d'utilitaires pour différentes choses :

- Faciliter la traduction de documents dans différentes langues.

- Fournir un ensemble d'outils pour aider à empaqueter et installer la documentation dans les emplacements adéquats et pour enregistrer la documentation dans scrollkeeper.

- Effectuer la conversion du format DocBook vers un format destiné à l'affichage.

Le navigateur d'aide Yelp s'appuie sur les feuilles de style XSLT GNOME pour effectuer la conversion de DocBook vers le HTML. Les utilitaires pour la construction de la documentation GNOME sont indispensables aux auteurs d'applications pour installer et enregistrer la documentation dans le système d'aide.

#### Page d'accueil et liste de diffusion

Pour plus d'informations sur le navigateur d'aide Yelp, visitez le site du projet de documentation, http://live.gnome.org/Yelp (en anglais), ou inscrivez-vous à la liste de diffusion, gnome-doc-devel-list@gnome.org.

### Participer au projet de documentation GNOME

Si vous souhaitez aider à écrire et à mettre à jour la documentation du projet GNOME, visitez la page d'accueil du projet de documentation : http://live.gnome.org/DocumentationProject (en anglais).