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
69 lines
2.7 KiB
XML
69 lines
2.7 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: dee52c067be3be96a735f0c33cbcf0009a996b2e Maintainer: lacatoire Status: ready -->
|
|
<!-- Reviewed: yes -->
|
|
|
|
<preface xml:id="preface" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook">
|
|
<info>
|
|
<titleabbrev>Préface</titleabbrev>
|
|
<title>À propos de ce manuel</title>
|
|
<abstract>
|
|
<simpara>
|
|
<acronym>PHP</acronym>, acronyme récursif pour <emphasis>PHP:
|
|
Hypertext Preprocessor</emphasis>, est un langage de script open source
|
|
généraliste, largement utilisé, particulièrement adapté au
|
|
développement web et pouvant être intégré au HTML. Sa syntaxe
|
|
est empruntée aux langages C, Java et Perl, et est facile
|
|
à apprendre. Le but principal de ce langage est de permettre aux
|
|
développeurs web d'écrire des pages générées dynamiquement
|
|
rapidement, mais il est possible de faire beaucoup plus avec PHP.
|
|
</simpara>
|
|
</abstract>
|
|
</info>
|
|
<para>
|
|
Ce manuel est essentiellement une
|
|
<link linkend="funcref">référence des fonctions</link>, mais il contient
|
|
aussi des informations de
|
|
<link linkend="langref">référence sur le langage</link>, des explications sur
|
|
les <link linkend="features">fonctionnalités</link> principales de PHP et
|
|
diverses <link linkend="appendices">informations supplémentaires</link>.
|
|
</para>
|
|
<simpara>
|
|
Ce manuel inclut des informations couvrant les deux versions majeures
|
|
les plus récentes de PHP (versions 7 et 8). Les informations concernant
|
|
les extensions qui ne sont plus incluses avec ces versions de PHP et les
|
|
modifications des fonctions dans les versions antérieures ne sont pas
|
|
incluses. Des archives des versions plus anciennes du manuel qui
|
|
documentent les précédentes versions de PHP sont disponibles dans la
|
|
section "Plus de documentation" sur la <link xlink:href="&url.php.docs;">
|
|
page "Documentation" du site web PHP</link>.
|
|
</simpara>
|
|
<para>
|
|
Il est possible de télécharger ce manuel sous divers formats,
|
|
sur <link xlink:href="&url.php.doc.downloads;">&url.php.doc.downloads;</link>.
|
|
Plus d'informations sur le développement de ce manuel sont disponibles dans l'appendice
|
|
<link linkend="about">À propos du manuel</link>. Pour en savoir plus sur
|
|
<link linkend="history">l'histoire de PHP</link>,
|
|
consulter l'appendice correspondant.
|
|
</para>
|
|
&contributors;
|
|
</preface>
|
|
|
|
<!-- 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:
|
|
-->
|