Language Converter/Syntaxe avancée
 | Cette page est en construction Do not mark for translation. See zh:Wikipedia:互助客栈/技术#Request for Translation of LanguageConverter documentation for discussions. |
- Version traduite de zh:Help:高级字词转换语法
Cette page décrit les balises spéciales trouvées dans LanguageConverter, un système qui permet de passer d’une variante de langue à une autre en remplaçant des caractères ou des mots. Dans tous les exemples ci-dessous, les caractères en minuscules sont utilisés pour représenter le chinois simplifié, et ceux en MAJUSCULES représentent le chinois traditionnel.
Exemples de caractères utilisables pour les tests :
| TRADITIONAL | simplified | Transliteration (Pinyin) |
Meaning |
|---|---|---|---|
| 氣 | 气 | qì | air |
| 馬 | 马 | mǎ | horse |
| 電 | 电 | diàn | electricity |
Concept
Les balises LanguageConverter ressemblent à :
-{ text }--{ flag | variant1 : text1 ; variant2 : text2 ; }--{ flag1 ; flag2 | from => variant : to ; }-
Là où les drapeaux sont décrits ci-dessous, et les noms des variantes sont des codes de langue (comme zh-cn ou zh-tw).
Codes de langue
Les exemples ci-dessous utilisent les codes de langue suivants :
| Code | Langue | Note |
|---|---|---|
| zh | chinois | "zh" est la consonne initiale du mandarin pinyin pour le caractère "中". (la Chine est 中国, Zhōngguó). |
| zh-hans | chinois simplifié | hans is an ISO 15924 script code, part of the BCP 47 language tag. "han" is the pinyin for the first character in 汉字 Hànzì (written in simplified characters) which is the autonym of the Chinese script, and "s" is the first letter of "Simplified Chinese".
|
| zh-hant | chinois traditionnel | hant is an ISO 15924 script code, part of the BCP 47 language tag. "han" is the pinyin for the first character in 漢字 Hànzì (written in traditional characters) which is the autonym of the Chinese script, and "t" is the first letter of "Traditional Chinese".
|
| zh-cn | Mainland China (Simplified) | cn is the ISO 3166-1 alpha-2 code for mainland China, part of the BCP 47 language tag.
|
| zh-hk | Hong Kong (Traditional) | hk is the ISO 3166-1 alpha-2 code for Hong Kong, part of the BCP 47 language tag.
|
| zh-mo | Macau (Traditional) | mo is the ISO 3166-1 alpha-2 code for Macau, part of the BCP 47 language tag.
|
| zh-my | Malaysia (Simplified) | my is the ISO 3166-1 alpha-2 code for Malaysia, part of the BCP 47 language tag.
|
| zh-sg | Singapore (Simplified) | sg is the ISO 3166-1 alpha-2 code for Singapore, part of the BCP 47 language tag. Malaysia and Singapore were originally covered by a combined variant.
|
| zh-tw | Taiwan (Traditional) | tw is the ISO 3166-1 alpha-2 code for Taiwan, part of the BCP 47 language tag.
|
Each LanguageConverter in MediaWiki has a main language code, which serves as the default value when returning article text unmodified. If a language code does not have a fallback language code set, then the main language code is used as its fallback code. Each language version of Wikipedia defines a default language code; for wikis using language converter that default language code is the main language code of its LanguageConverter.
When the selected language code does not have any available display output, MediaWiki will attempt to fallback to another language code to obtain display output.
Similarly, when word conversion fails to find a full-text conversion for a certain language code, it will consult the rules for the fallback code to attempt to find a matching conversion.
According to ZhConverter::getVariantsFallbacks() the order of fallback variants is as follows:
| Language code | Fallback codes | ||
|---|---|---|---|
| zh-hans | zh-cn | zh-sg | zh-my |
| zh-hant | zh-tw | zh-hk | zh-mo |
| zh-cn | zh-hans | zh-sg | zh-my |
| zh-hk | zh-mo | zh-hant | zh-tw |
| zh-mo | zh-hk | zh-hant | zh-tw |
| zh-my | zh-sg | zh-hans | zh-cn |
| zh-sg | zh-my | zh-hans | zh-cn |
| zh-tw | zh-hant | zh-hk | zh-mo |
The main language code also has fallback codes. The fallback codes for zh are, in order: zh-hans, zh-hant, zh-cn, zh-tw, zh-hk, zh-sg, zh-mo, zh-my.
Syntaxe
Syntaxe basique
| Nom | Description | Exemple | Remarque | |
|---|---|---|---|---|
| Wikicode | Sortie | |||
| Bidirectionnel | Conversion bidirectionnelle avec prise en charge des drapeaux. Syntaxe la plus courante lors de la conversion manuelle. |
-{zh-cn:computer; zh-tw:ELECTRONICBRAIN;}-
|
|
|
| Unidirectionnel | Conversion unidirectionnelle avec prise en charge des drapeaux. Utilisée tout d’abord pour ajouter de nouvelles règles de conversion. S’exécute plus rapidement que les règles bidirectionnelles.
Principalement utilisé pour unifier les différences de langue et éviter une conversion incohérente. |
-{H|HUGEBLOCK=>zh-cn:macro;}-
Test: HUGEBLOCK, macro
|
|
Il n’est pas possible de définir une variante de repli lors de la conversion unidirectionnelle. Par exemple ci-dessus, zh-hans et zh-sg n’utiliseront pas les règles de zh-cn. D’autre part, si la règle est insérée dans zh-hans, elle ne s’appliquera qu'à zh-hans et pas à zh-cn.
|
| Désactivé | Désactiver la conversion de langue |
-{SimpTrad}-
(Alternativement, avec le drapeau « R » : |
|
Cela désactive complètement la conversion. |
| (Semi-)désactivé | Désactive la conversion des mots (couper les mots séparément, n'affectera pas la transcription des caractères) Utile pour arrêter la conversion incohérente en séparant les mots correctement. |
HAN-{}-GUK, cho-{}-sun
(à supposer qu’il existe une règle globale de conversion entre |
|
Une autre manière de parvenir à cela est possible et convient mieux aux modèles. Voir « Drapeau de conversion combiné » ci-dessous. Par exemple : -{zh;zh-hans;zh-hant|HANGUK}- -{zh;zh-hans;zh-hant|chosun}-
|
Marques de conversion
Marques communes
Note that the actual effect of the inserted rules only takes place after the point where the rule is defined. Therefore it is recommended to place rules (for example, using the NoteTA template) at the beginning of the article and above any preface or infobox. In some cases, however, it is desired to present words in the disambiguation hatnote template from being transformed, in which case the rules should be placed below that.
| Drapeau | Description | Exemple | Remarque | |
|---|---|---|---|---|
| Wikicode | Sortie | |||
| H | Insère une règle de conversion sans sortie. |
-{H|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}-
Test: blog, WEBJOURNAL, WEBLOG
|
|
zh-hans et zh-hant sont simplement des écritures et n’appliqueront pas des règles bidirectionnelles. Voir aussi le paramètre $manualLevel dans LanguageConverter.
|
| A | Insère une règle de conversion avec un résultat dans la langue actuelle. |
-{A|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}-
Test: blog, WEBJOURNAL, WEBLOG
|
|
Compare la première sortie (A) avec celle de l’opération H sans drapeau. |
| - | Supprime la règle de conversion existante. |
-{H|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}- <!-- Add a rule -->
+ blog, WEBJOURNAL, WEBLOG
-{-|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}- <!-- Remove a rule -->
- blog, WEBJOURNAL, WEBLOG
|
|
Compare la différence entre les tests (+) et (-) par rapport aux différences basiques entre hans et hant. |
| T | Réécrit le titre de la page. |
-{T|zh-cn:tom hanks; zh-hk:SOUP HANS; zh-tw:TOM HANKS;}-
(à supposer que le titre original est TomHanks) |
(affiché comme le titre de la page)
|
|
| D | Décrit la règle de conversion. |
-{D|zh-cn:tom hanks; zh-hk:SOUP HANS; zh-tw:TOM HANKS}-
|
|
Pratique pour générer des aperçus dans les groupes de règles de conversion. |
Drapeau de conversion combiné
| Drapeau | Description | Exemple | Remarque | |
|---|---|---|---|---|
| Wikicode | Sortie | |||
| nom de variante | Prend seulement en compte certaines variantes pour la conversion. |
-{H|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}-
Test 1:
-{zh;zh-hans;zh-hant|blog, WEBJOURNAL, WEBLOG}-
Test 2:
-{zh;zh-cn;zh-hk|blog, WEBJOURNAL, WEBLOG}-
(à supposer que cela s’exécute sur un wiki en chinois) |
|
Comparez le test 1, le test 2 et le cas d’utilisation pour le drapeau H ci-dessus. Used like the example in test 1, this feature can be used in situations where regional terminology conversion should be avoided, but simplified/traditional character conversion is allowed; for example the regional film titles in zh:Template:Infobox Film. |
Exceptions
LanguageConverter évite de convertir tout ce qui se trouve dans les blocs de code comme <pre>...</pre>, <code>...</code>, mais aussi dans la balise <script>...</script> utilisée pour embarquer le JavaScript exécutable.
Mettre un bloc vide de règles de conversion -{}- à l’intérieur de ces balises forcera le convertisseur à convertir.
Cette astuce peut être utile pour des portions de code incluses dans ces balises.
Attention, cependant, car cette astuce ne semble pas fonctionner pour les balises <syntaxhighlight> fournies par l'extension qui peut générer éventuellement un <pre>...</pre> imbriqué dans d’autres éléments (T34943).
Le sélecteur ne fonctionne pas non plus avec les écritures qui ne sont par initialement incluses avec le source HTML de la page sur laquelle LC doit opérer.
Les messages MediaWiki ne sont pas traités par LC. Ce désagrément est tracé dans T170916.
Voir aussi
- Aide:Mots magiques - pour les sélecteurs liés au convertisseur
- Parsoid/Language conversion - qui rassemble la documentation supplémentaire relative à Language Conversion