From 4697e81df1d01795e137c98b9a7a416a246edbf6 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Wed, 30 Sep 2026 09:54:39 +0200 Subject: [PATCH] [Sync-En] chapters, chmonly: fix typos and grammar --- chapters/intro.xml | 20 +++++++++--------- chapters/tutorial.xml | 47 ++++++++++++++++++++--------------------- chmonly/aboutchm.xml | 14 ++++++------ chmonly/integration.xml | 17 +++++++-------- chmonly/search.xml | 23 ++++++++++---------- chmonly/usingchm.xml | 13 ++++++------ 6 files changed, 65 insertions(+), 69 deletions(-) diff --git a/chapters/intro.xml b/chapters/intro.xml index e61fef1d85..b02e5afee3 100644 --- a/chapters/intro.xml +++ b/chapters/intro.xml @@ -1,5 +1,5 @@ - + @@ -50,7 +50,7 @@ echo "Bonjour, je suis un script PHP !"; qui permettent au serveur web de passer en mode PHP. - Ce qui distingue PHP des langages de script comme le Javascript, + Ce qui distingue PHP des langages de script comme JavaScript, est que le code est exécuté sur le serveur, générant ainsi le HTML, qui sera ensuite envoyé au client. Le client ne reçoit que le résultat du script, sans aucun moyen d'avoir accès au code @@ -131,34 +131,34 @@ echo "Bonjour, je suis un script PHP !"; la programmation procédurale ou objet (OOP), ou encore un mélange des deux. - + PHP ne se limite pas à la production de code HTML. Ses capacités incluent la création de types de fichiers riches, tels que des images ou des fichiers PDF, le chiffrement de données et l'envoi d'e-mails. Il peut également facilement générer n'importe quel texte, tel que JSON ou XML. PHP peut générer automatiquement ces fichiers et les enregistrer dans - le système de fichiers au lieu de les imprimer, formant ainsi un cache côté serveur pour + le système de fichiers au lieu de les afficher, formant ainsi un cache côté serveur pour le contenu dynamique. - - + + Une des forces les plus significatives de PHP est qu'il supporte énormément de bases de données. Écrire une page web faisant appel à une base de données devient terriblement simple, en utilisant une des extensions spécifiques - aux bases de données (par exemple pour mysql), + aux bases de données (par exemple pour MySQL), ou utilisant une couche d'abstraction comme PDO, ou une connexion à n'importe quelle base de données supportant le standard Open Database Connection via l'extension ODBC. Les autres bases de données peuvent utiliser l'extension cURL ou sockets comme CouchDB. - + PHP supporte de nombreux protocoles comme LDAP, IMAP, SNMP, NNTP, POP3, HTTP, COM (sous Windows) et encore d'autres. Il peut aussi ouvrir des sockets réseau, et interagir avec n'importe quel autre protocole. - + PHP possède des fonctionnalités utiles dans le traitement de texte, incluant les expressions régulières compatibles Perl (PCRE), @@ -168,7 +168,7 @@ echo "Bonjour, je suis un script PHP !"; et étend le jeu de fonctionnalités en ajoutant le support de SimpleXML, XMLReader et XMLWriter. - + Beaucoup d'autres extensions existent, catégorisées alphabétiquement et par catégorie. diff --git a/chapters/tutorial.xml b/chapters/tutorial.xml index 6704448ea4..a48dc214c1 100755 --- a/chapters/tutorial.xml +++ b/chapters/tutorial.xml @@ -1,6 +1,5 @@ - - + Une introduction à PHP @@ -106,7 +105,7 @@ php -S localhost:8000 de balises spéciales qui permettent de réaliser beaucoup de choses intéressantes. - + Le point important de cet exemple était de montrer le format des balises spéciales PHP. Nous avons utilisé ici <?php pour indiquer le début de la balise PHP. @@ -115,11 +114,11 @@ php -S localhost:8000 au mode HTML et vice-versa, de cette manière, à volonté. Pour plus d'informations, consulter la section du manuel sur la syntaxe basique de PHP. - + Une note sur les retours à la ligne - + Les retours à la ligne ont une signification minime en HTML, cependant, c'est toujours une bonne idée de rendre le HTML aussi joli et propre que possible en y ajoutant des retours à la ligne. Un retour à la ligne @@ -131,12 +130,12 @@ php -S localhost:8000 PHP (?>) pour forcer l'espace et un retour à la ligne à afficher, ou d'ajouter explicitement un retour à la ligne dans le dernier echo/print du bloc PHP. - + Une note sur les éditeurs de texte - + Il existe de nombreux éditeurs de texte et environnements de développement (IDE) utilisables pour créer, éditer et gérer des applications PHP. Une liste partielle de ces outils @@ -145,22 +144,22 @@ php -S localhost:8000 Pour recommander un éditeur particulier, il suffit de visiter cette page et de demander au webmestre de l'ajouter. Avoir au minimum un éditeur de texte avec la coloration syntaxique peut être utile. - + Une note sur les traitements de texte - + Les traitements de texte tels que StarOffice Writer, Microsoft Word et - Abiword sont de très mauvais choix pour éditer des scripts PHP. + AbiWord sont de très mauvais choix pour éditer des scripts PHP. Pour utiliser l'un d'entre eux malgré tout pour tester des scripts, il faut s'assurer de sauver les fichiers au format texte seul (plain text) : sinon, PHP ne sera pas capable de lire et d'exécuter ces scripts. - + - + Maintenant que le script PHP précédent fonctionne, c'est le moment de créer le plus célèbre script PHP ! Un appel à la fonction phpinfo affichera beaucoup d'informations @@ -169,7 +168,7 @@ php -S localhost:8000 linkend="language.variables.predefined">variables pré-définies disponibles, les modules PHP chargés ainsi que la configuration. Prendre le temps de revoir ces informations importantes. - + Récupération des informations du système à partir de PHP @@ -233,12 +232,12 @@ Mozilla/5.0 (Linux) Firefox/112.0 - + Il y a de nombreux types de variables disponibles en PHP. Dans l'exemple ci-dessus, nous avons affiché un élément d'une variable Tableau (Array). Les tableaux peuvent être très utiles. - + $_SERVER est juste une variable qui est automatiquement disponible dans le script. Une liste de toutes les variables qui sont @@ -289,7 +288,7 @@ Vous utilisez Firefox. de consulter le chapitre consacré à la référence du langage. - + Le second concept que nous avons introduit est la fonction str_contains. str_contains est une fonction intégrée à PHP, qui détermine la présence d'une chaîne donnée dans une autre. Dans notre cas, nous @@ -307,7 +306,7 @@ Vous utilisez Firefox. la page du manuel "comment lire une définition de fonction" ainsi que la section sur les fonctions PHP. - + Il est maintenant possible de progresser et de montrer comment passer entre les modes PHP et HTML, au milieu d'un bloc PHP : @@ -343,19 +342,19 @@ if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) { - + Au lieu d'utiliser une commande echo pour afficher du texte, il est possible d'utiliser du code HTML pur. Le point important à noter ici est que la logique de programmation est conservée. Seul un des deux blocs HTML sera affiché, suivant le résultat de la fonction str_contains. En d'autres termes, cela dépend si la chaîne Firefox a été trouvée ou non. - +
Utiliser un formulaire - + L'un des points forts de PHP est sa capacité à gérer les formulaires. Le concept de base qui est important à comprendre est que tous les champs d'un formulaire seront automatiquement disponibles dans le @@ -363,7 +362,7 @@ if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) { variables depuis des sources externes à PHP pour plus d'informations et d'exemples sur la façon d'utiliser les formulaires. Voici un exemple de formulaire HTML : - + Un simple formulaire HTML @@ -410,12 +409,12 @@ Tu as 29 ans. - + Mis à part les parties htmlspecialchars et (int), ce script ne fait que des choses évidentes. htmlspecialchars s'assure que tous les caractères spéciaux HTML sont proprement encodés afin d'éviter des injections - de balises HTML et de Javascript dans les pages. Pour l'âge, vu que + de balises HTML et de JavaScript dans les pages. Pour l'âge, vu que c'est un entier, il est possible de le convertir en un &integer;. PHP peut également le faire @@ -434,7 +433,7 @@ Tu as 29 ans. $_REQUEST, pour ne pas se soucier de la source des données. Elle contient un mélange des données de GET, POST et COOKIE. - +
diff --git a/chmonly/aboutchm.xml b/chmonly/aboutchm.xml index 92a65c069e..2594c36386 100644 --- a/chmonly/aboutchm.xml +++ b/chmonly/aboutchm.xml @@ -1,10 +1,9 @@ - - + À propos de cette édition - + L'édition Windows HTML Help du Manuel PHP est destinée aux développeurs qui veulent avoir le manuel à portée de main à tout moment, et qui souhaitent lire les pages du manuel et les notes @@ -14,12 +13,13 @@ intéressantes fournies par l'application de visualisation, par les scripts que nous utilisons pour générer ce format et par d'autres contributeurs sous forme de skins. - + - + Cette distribution du Manuel PHP contient de nombreux fichiers, y compris le fichier principal du manuel php_manual_fr.chm. - Le manuel peut être visualisé en double-cliquant sur ce fichier. + Le manuel peut être visualisé en double-cliquant sur ce fichier + (comme on pouvait s'en douter). - + Intégration du Manuel PHP @@ -18,16 +17,16 @@ mais il est peut-être nécessaire de connaître quelques détails sur le contenu du CHM pour intégrer avec succès le manuel dans l'environnement. - + Le CHM est construit en utilisant des feuilles de style XSL à partir de sources XML. C'est actuellement unique dans la famille du Manuel PHP, car toutes les autres versions sont générées à l'aide de feuilles de style DSSSL. Cela signifie également que des différences de rendu non intentionnelles peuvent apparaître. Un script de conversion - spécial est exécuté sur la sortie XSLT, ajoutant plusieurs fonctionnalités sympas, + spécial est exécuté sur la sortie XSLT, ajoutant plusieurs fonctionnalités utiles, et emballant le manuel avec les fichiers de préférences et les exemples de skin. - - + + Les CHMs peuvent être considérés comme des fichiers compressés avec un accès supporté par le système d'exploitation pour les fichiers à l'intérieur et un support de recherche et d'index ajouté. Cependant, les CHMs ne peuvent être visualisés qu'en utilisant l'HTML Help @@ -35,7 +34,7 @@ d'URL spécial, le nom du fichier CHM et le fichier demandé à l'intérieur. Comme tout le contenu de l'aide est stocké dans des fichiers HTML, il est possible d'afficher des pages du CHM dans Internet Explorer. - + En supposant que le fichier php_manual_en.chm se trouve dans c:\phpmanual, l'index du manuel (visible @@ -88,12 +87,12 @@ et de fournir la chaîne spécifiée par l'IDE comme paramètre. Un exemple pour cela est l'intégration UltraEdit 9 (voir le site web de l'édition). - + L'index du manuel (accessible via l'onglet index sur le volet de navigation) peut également être utilisé à des fins d'intégration. Toutes les pages HTML sont incluses dans l'index avec leurs titres comme termes d'index (y compris les pages de description des fonctions). - + Pour les développeurs d'applications de bureau souhaitant intégrer étroitement le CHM dans leur programme (comme afficher l'arborescence de la table des matières diff --git a/chmonly/search.xml b/chmonly/search.xml index f2a95a15ab..4f2a684a8f 100644 --- a/chmonly/search.xml +++ b/chmonly/search.xml @@ -1,6 +1,5 @@ - - + La recherche textuelle complète @@ -27,14 +26,14 @@ onglet. - + Les mots trouvés sont mis en évidence sur la page actuelle dans le panneau de sujet par défaut. Il est possible de désactiver cette fonction en choisissant l'élément de menu "Search Highlight Off" dans le menu Options. La fonctionnalité peut être réactivée de la même manière. Pour un long sujet, seules les 500 premières occurrences d'un mot ou d'une phrase de recherche seront mises en évidence, en raison d'une limitation du visualiseur. - + Règles générales de recherche @@ -72,13 +71,13 @@ - + Lors de la recherche d'un nom de fichier avec une extension, il faut regrouper - l'intégralité de la chaîne dans des guillemets doubles, ("nomdefichier.ext"). Sinon, le point + l'intégralité de la chaîne dans des guillemets doubles ("nomdefichier.ext"). Sinon, le point cassera le nom de fichier en deux termes distincts. L'opération par défaut entre les termes est AND, ce qui créera l'équivalent logique de "nomdefichier AND ext". - + @@ -124,7 +123,7 @@ esc* ou HT?? - Résultats pour le premier exemple incluent les sujets contenant les termes "ESC", + Les résultats pour le premier exemple incluent les sujets contenant les termes "ESC", "escape", "escalation", etc. L'astérisque ne peut pas être le seul caractère dans le terme. @@ -199,11 +198,11 @@ - + Les caractères |, &, et ! peuvent également être utilisés à la place de OR, AND et NOT respectivement. Cela peut ne pas fonctionner avec une version très ancienne du visualiseur. - + @@ -262,7 +261,7 @@ You can have more than one language of the manual, while only need to have one notes file. All the CHM files need to be in the same directory, and all translations need to share the same - preferences if you would not like to have more then one notes file. + preferences if you would not like to have more than one notes file. @@ -279,7 +278,7 @@ - All these benefits lead us to provide the manual the way you can see it + All these benefits led us to provide the manual the way you can see it right now. This distribution had the effect on the full text search that you get search results from the manual content and from the user notes as separate ones. The "Location" column shows the source of the result, diff --git a/chmonly/usingchm.xml b/chmonly/usingchm.xml index 6c87a7a809..abc201b9a8 100644 --- a/chmonly/usingchm.xml +++ b/chmonly/usingchm.xml @@ -1,10 +1,9 @@ - - + Utilisation de l'édition CHM du Manuel PHP - + 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 : @@ -16,9 +15,9 @@ 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. - + - + 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 @@ -28,7 +27,7 @@ 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 hh.dat. - + La barre d'outils de l'aide HTML @@ -401,7 +400,7 @@ - Rechercher un mot-clé dans la liste des résultats + Rechercher un mot-clé dans la liste des résultats d'une recherche précédente ALT