mirror of
https://github.com/php/doc-fr.git
synced 2026-03-23 22:52:18 +01:00
2d314f78aa
* CI: add French style checker based on TRADUCTIONS.txt
Checks changed XML files in PRs for:
- Direct address forms (vous/votre/vos) → warnings
- French grammar errors (etc..., comme par exemple, si il) → errors
- Incorrect terminology (librairie, chiffrage, encryption) → warnings
Inspired by doc-ja's textlint+prh approach but simpler:
runs directly on XML sources, no PhD render needed.
Only errors (grammar/spelling) fail the CI.
Style warnings appear as PR annotations without blocking.
* test: introduce style errors to validate CI check
* Revert "test: introduce style errors to validate CI check"
This reverts commit 7c1d523c6bbef116f54fc6dad7b61a45ee4f7ddd.
* Corriger toutes les violations de style TRADUCTIONS.txt
- 174x "Notez que" → "Il est à noter que"
- 50x "depuis PHP X" → "à partir de PHP X"
- 50x "votre" → le/la/du
- 15x "si il" → "s'il"
- 14x "Vous pouvez" → "Il est possible de"
- 14x "encryption" (faux positifs entity refs exclus)
- 12x "assurez-vous" → "il faut s'assurer"
- 12x "Vous devez" → "Il faut"
- 11x "vos" → les/des
- 9x "comme par exemple" → "par exemple"
- 6x "Vous devriez" → "Il est recommandé de"
- 2x "optionel" → "optionnel"
- 2x "reportez-vous" → "se reporter"
Toutes les règles passent désormais en erreur dans la CI.
* Harmoniser les noms de workflows GitHub Actions
- integrate.yaml → build.yml (extension + nom cohérent)
- check-style-fr.yml → check-style.yml ("-fr" redondant)
- Aligner les noms de workflow et job
* Lire les règles dynamiquement depuis TRADUCTIONS.txt
Le script parse TRADUCTIONS.txt au démarrage et génère les règles
de vérification automatiquement. Plus aucune règle en dur.
* Règles dynamiques depuis TRADUCTIONS.txt
Le script CI lit les lignes INTERDIT de TRADUCTIONS.txt pour générer
les règles de vérification. Plus aucune règle en dur dans le script.
Corrige les 27 violations restantes (Depuis PHP → À partir de PHP).
* Corriger les trailing whitespace
558 lines
17 KiB
XML
558 lines
17 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- EN-Revision: eee245cdbd89dc2fd908285f588e3b9e055924e5 Maintainer: Fan2Shrek Status: ready -->
|
|
<!-- Reviewed: yes -->
|
|
<chapter xml:id="chm.using" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<title>Utilisation de l'édition CHM du Manuel PHP</title>
|
|
|
|
<para>
|
|
Lors d'un double-clic sur un CHM, une fenêtre de visualisation
|
|
de l'aide HTML s'ouvre avec trois volets. Sur le côté gauche de la fenêtre
|
|
se trouve le volet de navigation. Il contient quatre onglets de navigation :
|
|
les onglets Contenu, Index, Recherche et Favoris. Sur le côté droit
|
|
de la fenêtre se trouve le volet de sujet. Il affiche le
|
|
sujet d'aide sélectionné, ou le sujet d'aide par défaut au démarrage.
|
|
Les pages d'aide sont toutes des fichiers HTML séparés, Internet
|
|
Explorer affiche les pages dans le volet de sujet. Le troisième volet
|
|
est la barre d'outils, qui se trouve en dessous de la barre de titre
|
|
de la fenêtre d'aide. Il est possible d'ajuster la disposition horizontale
|
|
en faisant glisser la bordure verticale entre le volet de navigation et le volet de sujet.
|
|
</para>
|
|
|
|
<para>
|
|
Il est important de noter que lors de la première ouverture du CHM, il peut
|
|
apparaître dans une position et une taille étranges. À partir de là, Windows
|
|
se souvient de la position de la fenêtre, de la taille et de l'onglet
|
|
ouvert en dernier. Tous ces éléments, y compris les favoris, sont stockés
|
|
dans un fichier nommé <filename>hh.dat</filename>. Si le
|
|
fichier est déplacé dans un autre répertoire, tous ces paramètres mémorisés seront
|
|
perdus (y compris la liste de favoris !). Si le
|
|
fichier CHM est remplacé par un nouveau, portant le même nom, ce n'est pas un problème.
|
|
Les noms de fichiers et les valeurs de chemin sont stockés dans <filename>hh.dat</filename>.
|
|
</para>
|
|
|
|
<sect1 xml:id="chm.using.toolbar">
|
|
<title>La barre d'outils de l'aide HTML</title>
|
|
<para>
|
|
La barre d'outils de l'aide HTML contient les icônes suivantes,
|
|
lors de la visualisation du Manuel PHP :
|
|
<itemizedlist>
|
|
<listitem>
|
|
<simpara>Hide/Show - Masque/Affiche le volet de navigation.</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
Locate - Localise un sujet dans l'onglet de contenu (au cas où
|
|
un sujet a été atteint avec la recherche, l'index ou
|
|
les favoris, et qu'il est souhaitable de voir où il se trouve
|
|
dans l'arborescence de la table des matières).
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Back - Retourne en arrière dans l'historique.</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Forward - Avance dans l'historique.</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Refresh - Recharge la page actuelle.</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Home - Ouvre la page de démarrage du CHM.</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Print - Ouvre la boîte de dialogue d'impression.</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Options - Fournit une liste déroulante avec plus d'options.</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
Utiliser cette barre d'outils est vraiment facile, beaucoup des icônes
|
|
de la barre d'outils sont fortement liées à leurs équivalents
|
|
dans Internet Explorer.
|
|
</para>
|
|
</sect1>
|
|
|
|
<sect1 xml:id="chm.using.navpane">
|
|
<title>Le volet de navigation</title>
|
|
<para>
|
|
Le volet de navigation contient quatre onglets de navigation :
|
|
les onglets Contenu, Index, Recherche et Favoris. Ils
|
|
fournissent tous des méthodes différentes pour accéder à un sujet
|
|
dans le fichier d'aide.
|
|
<itemizedlist>
|
|
<listitem>
|
|
<simpara>
|
|
L'onglet Contenu révèle une table des matières en arborescence,
|
|
permettant de naviguer vers le sujet désiré en ouvrant
|
|
et fermant des parties de l'arbre. Il est même possible d'accéder
|
|
aux sections les plus profondes en utilisant cette table
|
|
des matières. Un clic droit sur un élément
|
|
ici, suivi de "Imprimer...", offre l'option
|
|
d'imprimer le sujet sélectionné ou le sujet sélectionné
|
|
et tous les sous-sujets. Cependant, l'impression n'est pas
|
|
l'objectif initial de cette représentation du manuel (la version PDF
|
|
est adaptée à l'impression).
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
L'onglet Index liste un grand nombre de "mots-clés" (en fait
|
|
les titres des pages du manuel). Il est possible d'en choisir un,
|
|
ou de commencer à taper un mot-clé, voir la liste s'ajuster
|
|
à la saisie, et ensuite cliquer sur un sujet, ou appuyer
|
|
sur Entrée si le sujet sélectionné est celui souhaité.
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
L'onglet Recherche montre l'une des fonctionnalités les plus
|
|
puissantes de l'aide HTML, la recherche plein texte (aussi
|
|
connue sous le nom de FTS). Ici, il est possible de taper une
|
|
expression de recherche, en connectant éventuellement des
|
|
mots avec AND/OR/NEAR/NOT. Avant de cliquer sur 'Liste des sujets',
|
|
il est également possible de définir quelques options en bas. Après
|
|
l'affichage des résultats de la recherche, il apparaîtra
|
|
que les résultats des textes manuels et des notes d'utilisateurs
|
|
sont séparés. Pour trier les deux types, cliquez sur l'en-tête
|
|
de colonne 'Emplacement'. Maintenant, à partir de la liste
|
|
des résultats de la recherche, il suffit de choisir un sujet
|
|
pour voir sa page. Les mots-clés recherchés
|
|
sont mis en surbrillance sur la page.
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
L'onglet Favoris permet de stocker les sujets les plus utilisés
|
|
dans une liste, facilement accessible. Ici, il est possible de voir
|
|
la liste, ajouter le sujet actuel, en retirer un, ou
|
|
afficher un élément sélectionné. Il est également possible de spécifier un
|
|
titre personnalisé pour le favori, en le tapant dans la zone 'Current
|
|
topic :'. Les titres des pages de notes d'utilisateurs sont précédés
|
|
d'une chaîne 'N:' afin de les distinguer
|
|
des pages de manuel normales dans la liste des favoris.
|
|
</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
</sect1>
|
|
|
|
<sect1 xml:id="chm.using.keyshorts">
|
|
<title>Raccourcis clavier</title>
|
|
<para>
|
|
Il existe de nombreux raccourcis clavier permettant d'augmenter la
|
|
productivité. De nombreux utilisateurs trouvent plus approprié d'utiliser
|
|
ces raccourcis clavier pour accéder aux sujets, au lieu de
|
|
cliquer.
|
|
</para>
|
|
<para>
|
|
<table>
|
|
<title>Raccourcis clavier généraux de la visionneuse d'aide</title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Pour</entry>
|
|
<entry>Appuyer sur</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>Fermer la visionneuse d'aide</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>F4</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Afficher le menu Options</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>O</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Masquer ou afficher le volet de navigation</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>O</keycap>
|
|
</keycombo>,
|
|
et ensuite <keycap>T</keycap>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Imprimer un sujet</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>O</keycap>
|
|
</keycombo>,
|
|
et ensuite <keycap>P</keycap>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Revenir au sujet précédent</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>Flèche de gauche</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Avancer au sujet suivant (s'il a été vu juste avant)</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>Flèche de droite</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Activer ou désactiver la mise en surbrillance de la recherche</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>O</keycap>
|
|
</keycombo>,
|
|
et ensuite <keycap>O</keycap>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Revenir à la page d'accueil de l'aide</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>O</keycap>
|
|
</keycombo>,
|
|
et ensuite <keycap>H</keycap>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Changer entre le volet de navigation et le volet de sujet</entry>
|
|
<entry><keycap>F6</keycap></entry>
|
|
</row>
|
|
<row>
|
|
<entry>Défiler à travers tous les liens dans un sujet ou à travers toutes les options sur un onglet du volet de navigation</entry>
|
|
<entry><keycap>TAB</keycap></entry>
|
|
</row>
|
|
<row>
|
|
<entry>Afficher le menu contextuel (clic droit)</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>SHIFT</keycap>
|
|
<keycap>F10</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
|
|
<table>
|
|
<title>Raccourcis clavier de l'onglet Contenu</title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Pour</entry>
|
|
<entry>Appuyer sur</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>Afficher l'onglet Contenu</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>C</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Ouvrir et fermer un livre ou un dossier</entry>
|
|
<entry>
|
|
<keycap>+</keycap> et <keycap>-</keycap>
|
|
ou <keycap>Flèche de gauche</keycap> et <keycap>Flèche de droite</keycap>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Sélectionner un sujet</entry>
|
|
<entry>
|
|
<keycap>Flèche du bas</keycap> et <keycap>Flèche du haut</keycap>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Afficher le sujet sélectionné</entry>
|
|
<entry><keycap>Entrée</keycap></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
|
|
<table>
|
|
<title>Raccourcis clavier de l'onglet Index</title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Pour</entry>
|
|
<entry>Appuyer sur</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>Afficher l'onglet Index</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>N</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Taper un mot-clé pour rechercher</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>W</keycap>
|
|
</keycombo>,
|
|
et ensuite taper le mot
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Sélectionner un mot-clé dans la liste</entry>
|
|
<entry>
|
|
<keycap>Flèche du haut</keycap> et <keycap>Flèche du bas</keycap>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Afficher le sujet associé</entry>
|
|
<entry>
|
|
<keycap>Entrée</keycap> ou
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>D</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
|
|
<table>
|
|
<title>Raccourcis clavier de l'onglet Recherche</title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Pour</entry>
|
|
<entry>Appuyer sur</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>Afficher l'onglet Recherche</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>S</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Taper un mot-clé pour rechercher</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>W</keycap>
|
|
</keycombo>,
|
|
et ensuite taper le mot
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Lancer la recherche</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>L</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Sélectionner un sujet dans la liste des résultats</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>T</keycap>
|
|
</keycombo>,
|
|
et puis
|
|
<keycap>Flèche du haut</keycap> et <keycap>Flèche du bas</keycap>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Afficher le sujet sélectionné</entry>
|
|
<entry>
|
|
<keycap>Entrée</keycap> ou
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>D</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Rechercher un mot-clé dans la liste des résultats</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>U</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>
|
|
Recherche de mots similaires au mot-clé.
|
|
Par exemple, pour trouver des mots comme "courir" et "court" pour le mot-clé "courir"
|
|
</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>M</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Recherche uniquement dans les titres de sujets</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>R</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
|
|
<table>
|
|
<title>Raccourcis clavier de l'onglet Favoris</title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Pour</entry>
|
|
<entry>Appuyer sur</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>Afficher l'onglet Favoris</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>I</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Ajouter le sujet actuel à la liste des favoris</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>A</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Sélectionner un sujet dans la liste des favoris</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>P</keycap>
|
|
</keycombo>,
|
|
et puis
|
|
<keycap>Flèche du haut</keycap> et <keycap>Flèche du bas</keycap>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Afficher le sujet sélectionné</entry>
|
|
<entry>
|
|
<keycap>Entrée</keycap> ou
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>D</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Supprimer le sujet sélectionné de la liste des favoris</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>ALT</keycap>
|
|
<keycap>R</keycap>
|
|
</keycombo>
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
|
|
<table>
|
|
<title>Raccourcis clavier du volet de sujet</title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Pour</entry>
|
|
<entry>Appuyer sur</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>Rechercher dans l'index</entry>
|
|
<entry>
|
|
Sélectionner les mots à rechercher et appuyer sur
|
|
<keycap>F1</keycap>
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Rechercher dans la page</entry>
|
|
<entry>
|
|
<keycombo action='simul'>
|
|
<keycap>CTRL</keycap>
|
|
<keycap>F</keycap>
|
|
</keycombo>,
|
|
et ensuite ajuster les options
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Recharger la page</entry>
|
|
<entry><keycap>F5</keycap></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
</para>
|
|
</sect1>
|
|
|
|
</chapter>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|