# Outils et utilitaires

Ce chapitre documente quelques outils et utilitaires du bureau MATE.

## 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. Open the Run Application dialog in any of the following ways:

   From a panel

     You can add the Run Application button to any panel. See . Click on the Run Application panel button to open the Run Application dialog.

   Using shortcut keys

     Press Alt F2. You can change the shortcut keys that display the Run Application dialog in the Keyboard Shortcuts preference tool.

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

2. 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 pluma, 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.

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

Run Application dialog, using

## 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 . 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
  --- | ---
  Print Screen | Réalise une capture de l'écran entier.
  Alt Print Screen | 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

  Choose Applications Accessories Take Screenshot.

- À partir d'un terminal

  La commande `mate-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 `mate-screenshot` comme suit :

  Option | Fonction
  --- | ---
  `--window` | Réalise une capture de la fenêtre active.
  `--delay=seconds` | 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.

screenshots, taking

## Navigateur d'aide Yelp

### Introduction

Le navigateur d'aide Yelp permet de consulter la documentation de MATE 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.

Yelp Help Browser Window

Yelp Help Browser contains the following elements in

Menubar

  File

    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.

  Edit

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

  Go

    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.

  Bookmarks

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

  Help

    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.

Toolbar

  Back

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

  Forward

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

  Help Topics

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

Browser Pane

  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

To open a document in Yelp Help Browser:

- In an application, click Help Contents

- Use the Table of Contents to navigate to the desired document.

- You can drag a Docbook XML file from Caja to the Yelp window or launcher.

- Press the F1 key.

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 pour en savoir plus à ce sujet.

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

Pour ouvrir une nouvelle fenêtre :

- Click File New Window

- Utilisez le raccourci clavier Ctrl N

#### À propos de ce document

Pour afficher des informations sur le document actuellement ouvert :

- Click File About This 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 :

- Click File Print this Page

#### Impression d'un document

Pour imprimer un document en entier :

- Click File Print this 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 :

- Click File Close Window

- Utilisez le raccourci clavier Ctrl W

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

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

- Click Edit Preferences

A window will appear that looks like :

Yelp Help Browser Preferences Window

The options that are available in this dialog have the following functions:

Use system fonts

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

  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.

  Variable Width

    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.

  Fixed Width

    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.

Browse with caret

  Cochez cette option si vous souhaitez voir apparaître le curseur dans le . 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 :

- Click Go Back

- 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 :

- Click Go Forward

- 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 :

- Click Go Help Topics

- 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 :

- Click Go Previous Section

- 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 :

- Click Go Next Section

- 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 :

- Click Go Contents

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

#### Ajout d'un signet

Pour ajouter un signet vers un document particulier :

- Click Bookmarks Add Bookmark

- Use the key combination Ctrl D

A window will appear that looks like .

Add Bookmark Window

Enter your desired bookmark title in to the Title text entry field. Then click Add to add the bookmark, or click Cancel to cancel the request.

#### Édition des signets

Pour éditer votre collection de signets :

- Click Bookmarks Edit Bookmarks...

- Use the key combination Ctrl B

A window will appear that looks like .

Edit Bookmarks Window

You can manage your bookmarks using this window in the following ways:

Open

  Use this button to open the selected bookmark in a new window.

Rename

  Use this button to rename the title of your bookmark.

Remove

  Use this button to delete the bookmark from your collection.

Once you are finished managing your bookmarks, click the Close button to exit the Edit Bookmarks Window.

#### Aide de Yelp

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

- Click Help Contents

### 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 Caja ou glissez son icône de Caja 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/mate/help/gcalctool/C/gcalctool.xml

`help:` ou `mate-help:`

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

      yelp help: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 help: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 MATE

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

- Ease translation of documents to different languages.

- Provide a set of tools to help package and install documentation into the correct location and register the documentation with scrollkeeper.

- Perform conversion from DocBook format to a format suitable for display.

Yelp Help Browser relies on MATE XSLT Stylesheets to perform conversion from DocBook to HTML. MATE Documentation Build Utilities are relied upon by application authors to install and register documentation within the help system.

#### 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, mate-doc-devel-list@gnome.org.

### Participer au projet de documentation MATE

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

Yelp