Převodník jazyků/Pokročilá syntaxe
 | Tato stránka je ve výstavbě. Do not mark for translation. See zh:Wikipedia:互助客栈/技术#Request for Translation of LanguageConverter documentation for discussions. |
- Přeložená verze zh:Help:高级字词转换语法
Stránka popisuje speciální značky nalezené v překladači jazyků - systému, který převádí mezi jazykovými variantami pomocí nahrazování znaků a slov. Ve všech níže uvedených příkladech jsou znaky představující zjednodušenou čínštinu použity malými písmeny a znaky psané v UPPERCASE představují tradiční čínštinu.
Některé příklady znaků, které můžete použít k testování:
| TRADIČNÍ | zjednodušená | Přepis (Pinyin) |
Význam |
|---|---|---|---|
| 氣 | 气 | qì | vzduch |
| 馬 | 马 | mǎ | kůň |
| 電 | 电 | diàn | elektřina |
Koncept
Značky LanguageConverter vypadají takto:
-{ text }--{ flag | variant1 : text1 ; variant2 : text2 ; }--{ flag1 ; flag2 | from => variant : to ; }-
Tam, kde jsou níže popsány flagy a názvy variant jsou kódy jazyků (jako je zh-cn nebo zh-tw).
Jazykové kódy
V níže uvedených příkladech jsou použity následující jazykové kódy:
| Kód | Jazyk | Poznámka |
|---|---|---|
| zh | čínština | "zh" je počáteční souhláska mandarínského pinyinu pro znak "中". (Čína je 中国, Zhōngguó.) |
| zh-hans | čínština (zjednodušená) | 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 | čínština (tradičná) | 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
Základní syntaxe
| Název | Popis | Příklad | Poznámka | |
|---|---|---|---|---|
| Wikitext | Výstup | |||
| Obousměrná | Obousměrná konverze s podporou příznaku. Nejběžnější syntaxe v manuální konverzi. |
-{zh-cn:computer; zh-tw:ELECTRONICBRAIN;}-
|
|
|
| Jednosměrná | Jednosměrná konverze s podporou příznaku. Používá se především pro přidání nových pravidel převodu. Běží rychleji než obousměrná pravidla.
To je užitečné zejména pro sjednocení jazykových variací a zabránění nepravidelné konverzi. |
-{H|HUGEBLOCK=>zh-cn:macro;}-
Test: HUGEBLOCK, macro
|
|
Při jednosměrném převodu není náhrada podporována. Například ve výše uvedeném příkladu nebudou zh-hans a zh-sg používat pravidla zh-cn. Na druhou stranu, pokud by pravidlo bylo vloženo do zh-hans, vztahovalo by se to pouze na zh-hans, ale nikoli na zh-cn.
|
| Zakázaná | Zakázat převod jazyka |
-{SimpTrad}-
(Alternativně s příznakem "R": |
|
Tím zcela deaktivujete převod. |
| Částečně zakázaná | Zakázat překlad "slov" (rozdělení slov neovlivní přepis znaků) Užitečné pro zastavení nepravidelného převodu správným rozdělením slov. |
HAN-{}-GUK, cho-{}-sun
(za předpokladu, že mezi systémem |
|
Existuje jiný způsob, jak toho dosáhnout, což je výhodnější v šablonách. Viz "Příznak kombinované konverze" níže. Například: -{zh;zh-hans;zh-hant|HANGUK}- -{zh;zh-hans;zh-hant|chosun}-
|
Příznaky převodu
Běžné příznaky
Upozorňujeme, že skutečný účinek vložených pravidel se projeví až po bodě, kde je pravidlo definováno. Proto se doporučuje umístit pravidla (například pomocí šablony NoteTA) na začátek článku a nad jakoukoli předmluvu nebo infobox. V některých případech je však žádoucí zabránit transformaci slov v rozlišovacím výrazu šablona hatnote, v takovém případě by měla být pravidla umístěna pod tímto výrazem.
| Příznak | Popis | Příklad | Poznámka | |
|---|---|---|---|---|
| Wikitext | Výstup | |||
| H | Vloží pravidlo převodu bez výstupu |
-{H|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}-
Test: blog, WEBJOURNAL, WEBLOG
|
|
zh-hans a zh-hant jsou jednoduše skripty a nebudou uplatňovat obousměrná pravidla. Viz také parametr $manualLevel v LanguageConverter.
|
| A | Vloží pravidlo převodu s výsledkem v aktuálním jazyce |
-{A|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}-
Test: blog, WEBJOURNAL, WEBLOG
|
|
Porovnejte první výstup (A) s výstupem z H a bez příznaku. |
| - | Odebere stávající pravidlo převodu |
-{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
|
|
Porovnejte test (+), test (-) a základní hans/hant |
| T | Přepíše název stránky |
-{T|zh-cn:tom hanks; zh-hk:SOUP HANS; zh-tw:TOM HANKS;}-
(za předpokladu, že původní název je "TomHanks") |
(zobrazeno jako název stránky)
|
|
| D | Popíše pravidlo převodu |
-{D|zh-cn:tom hanks; zh-hk:SOUP HANS; zh-tw:TOM HANKS}-
|
|
Dobré pro generování přehledů ve skupinách pravidel veřejné konverze. |
Příznak kombinované konverze
| Příznak | Popis | Příklad | Poznámka | |
|---|---|---|---|---|
| Wikitext | Výstup | |||
| název varianty | Pro převod uvažujete pouze s některými variantami |
-{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}-
(za předpokladu, že toto běží na čínské wiki) |
|
Porovnejte test 1, test 2 a případ použití v příznaku H výše. 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. |
Výjimky
Převaděč jazyků se vyhýbá převodu všeho, co se nachází v blocích "code", jako je <pre>...</pre>, <code>...</code> a značkou skriptu <script>...</script> používanou pro přenos spustitelného JavaScriptu.
Vložení prázdného -{}- pravidla převodu do těchto značek bude fungovat jako přepínač "force convert" (převod silových jednotek) pro převodník.
Tento hack může být užitečný pro ukázky kódu vnořeného do těchto značek.
Upozorňujeme, že se zdá, že tento přepínač nefunguje pro značky <syntaxhighlight> poskytované rozšířeními, které nakonec vygenerují <pre>...</pre> s vnořenými prvky (T34943).
Přepínač také nebude fungovat se skripty, které nejsou původně součástí zdrojového kódu HTML stránky, pro kterou je LC navržen.
Zprávy MediaWiki nejsou zpracovány LC. Tato nepříjemnost je sledována v T170916.
Související odkazy
- Nápověda:Kouzelná slova - pro spínače související s převodníkem
- Parsoid/Language conversion - která shromažďuje další dokumentaci týkající se jazykové konverze