# Outils et utilitaires

Vincent Renardias
vincent@ldsol.com
1998-2000.
Vincent Renardias
Joaquim Fellmann
joaquim@hrnet.fr
2000.
Joaquim Fellmann
Christophe Merlet
redfox@redfoxcenter.org
2000-2006.
Christophe Merlet
Christophe Fergeau
teuf@users.sourceforge.net
2002-2003.
Christophe Fergeau
Sun G11n
gnome_int_l10n@ireland.sun.com
2002.
Sun G11n
Robert-André Mauchin
zebob.m@pengzone.org
2006-2008.
Robert-André Mauchin
Stéphane Raimbault
stephane.raimbault@gmail.com
2007.
Stéphane Raimbault
Yannick Tailliez
ytdispatch-libre@yahoo.com
2008.
Yannick Tailliez
Claude Paroz
claude@2xlibre.net
2008-2010.
Claude Paroz
Gérard Baylard
gerard dot b at bbox dot fr
2010
Gérard Baylard

This section describes some tools and utilities in the MATE Desktop.

## 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 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.

   If you enter only the location of a file, an appropriate application will launch to open it. If you enter a web page address, your default web browser will open the page. Prefix the web page address with https://, as in https://mate-desktop.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.

## 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
  --- | ---
  Impr. Écran | Réalise une capture de l'écran entier.
  Alt Print Screen | Réalise une capture de la fenêtre active.

  You can use the tool to modify the default shortcut keys.

- À 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.

## 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.

Yelp Help Browser is internationalized, meaning that it has support to view documents in different languages. The documents must be localized or translated for each language and installed properly for Yelp Help Browser to be able to view them.

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

Barre de menus

  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.

  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

  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

- Use the Back button in the Toolbar

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

- Use the Forward button in the Toolbar

#### Affichage du sommaire de l'aide

Pour afficher le sommaire de l'aide :

- Click Go Help Topics

- Utilisez le raccourci clavier Alt Origine

- Use the Help Topics button in the Toolbar

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

To get help to use Yelp Help Browser (and see this 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 :

`fichier :`

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

      yelp file:///usr/share/help/C/mate-control-center/config-mouse.xml

`aide :`

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

      yelp help:mate-terminal

  If you want to open the help document at a particular section, append a slash to the end of the URI, followed by the section id.

      yelp help:mate-user-guide/yelp-advanced-cmdline

`man :`

  Use this URI when you want to access a particular man page. You can append the section of the man page you would like to view if there are multiple man pages with the same name. The section number should be enclosed in parentheses and therefore it may be necessary to escape the argument so that the shell does not interpret the parenthesis.

      yelp man:mate-panel

  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

This section details some helper applications which Yelp Help Browser uses, and provides resources where you can get more information about Yelp Help Browser.

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

For further information on Yelp Help Browser, please visit the Documentation Project homepage, `http://mate-desktop.org`, or subscribe to the mailing list, `http://ml.mate-desktop.org/listinfo/mate-dev`.

### Participer au projet de documentation MATE

If you are interested in helping produce and update documentation for the MATE project, please visit the Documentation Project homepage: `http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team`