文字体系/構文
- zh:Help:高级字词转换语法 を翻訳した版です
このページでは、LanguageConverter で見られる特殊なマークアップについて説明します。このシステムは、文字や単語の置換によって言語変種間の変換を行うものです。 下記のすべての例について、小文字は簡体字表記の中国語を、大文字は繁体字表記の中国語を表しています。
概念
LanguageConverter のマークアップは以下のようになります:
-{ text }--{ flag | variant1 : text1 ; variant2 : text2 ; }--{ flag1 ; flag2 | from => variant : to ; }-
フラグについては後述しますが、言語変種名は言語コード (zh-cn や zh-tw など) です。
言語変種間のフォールバックを利用できます。
中国語向けに設計された以下の例では、zh-cn と zh-sg は zh-hans の文字体系で書かれた言語変種、zh-hk と zh-mo は zh-hant の文字体系で書かれた言語変種です。
例えば、LanguageZh.php 内の $variantfallbacks の定義によると、zh-hk の規則が見つからない場合、コンバーターは zh-hant、zh-mo、zh-tw の定義の使用を試みます。
この例では、ほとんどの例で zh-mo と zh-sg が存在しないことに気付くかもしれません。
これは、それぞれ他の言語変種である zh-hk と zh-cn との類似性が高いためです。
構文
基礎的な構文
| 名前 | 説明 | 例 | 注記 | |
|---|---|---|---|---|
| ウィキテキスト | 出力 | |||
| 双方向 | Bidirectional conversion with flag support. Most common syntax in manual conversion. |
-{zh-hans:computer; zh-hant:ELECTRONICBRAIN;}-
|
|
|
| 単方向 | Unidirectional conversion with flag support. Primarily used for adding new conversion rules. Runs faster than bidirectional rules.
Mainly useful for unifying language variance and preventing erratic conversion. |
-{H|HUGEBLOCK=>zh-cn:macro;}-
Test: HUGEBLOCK, macro
|
|
Fallback is not supported in unidirectional conversion. For example, in the above example, zh-hans and zh-sg won't use zh-cn's rules. On the other hand, if the rule was inserted into zh-hans, it would only apply to zh-hans, but not zh-cn.
|
| 無効 | Disable language conversion |
-{SimpTrad}-
<!--Alternatively, with the "R" flag: -{R|SimpTrad}--->
|
|
This disables conversion completely. |
| (半)無効 | Disable "word" conversion (breaking words apart, won't affect character transcription) Useful for stopping erratic conversion by splitting words correctly. |
HAN-{}-GUK, cho-{}-sun
(assuming there's a system-wide conversion rule between |
hanguk, chosun
|
There's another way to achieve this, which is more convenient in templates. See "Combined conversion flag" below. 例: -{zh;zh-hans;zh-hant|HANGUK}- -{zh;zh-hans;zh-hant|chosun}-
|
変換フラグ
共通フラグ
| フラグ | 説明 | 例 | 注記 | |
|---|---|---|---|---|
| ウィキテキスト | 出力 | |||
| H | Insert a conversion rule without output |
-{H|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}-
Test: blog, WEBJOURNAL, WEBLOG
|
|
zh-hans and zh-hant are simply scripts and won't apply bidirectional rules. See also the $manualLevel parameter in LanguageConverter.
|
| A | Insert a conversion rule with a result in the current language |
-{A|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}-
-{zh-hans:→; zh-hant:⇒}-
blog, WEBJOURNAL, WEBLOG
|
|
Compare the first (A) output with the one from H and flag-free operation. |
| - | Remove existing conversion rule |
-{H|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}- <!-- Add rule -->
+ blog, WEBJOURNAL, WEBLOG
-{-|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}- <!-- Remove rule -->
- blog, WEBJOURNAL, WEBLOG
|
|
Compare test (+), test (-), and basic hans/hant |
| T | Override page title |
-{T|zh-cn:tom hanks; zh-hk:SOUP HANS; zh-tw:TOM HANKS;}-
(assuming the original title is "TomHanks") |
(shown as page title)
|
|
| D | Describe conversion rule |
-{D|zh-cn:tom hanks; zh-hk:SOUP HANS; zh-tw:TOM HANKS}-
|
|
Good for generating overviews in public conversion rule-groups. |
変換フラグの組み合わせ
| フラグ | 説明 | 例 | 注記 | |
|---|---|---|---|---|
| ウィキテキスト | 出力 | |||
| 言語変種名 | Only consider certain variants for 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}-
(assuming this runs on a Chinese wiki) |
|
Compare test 1, test 2 and the usage case in H flag above. |
例外
Language converter avoids converting anything found in "code" blocks like <pre>...</pre>, <code>...</code>, as well as the <script>...</script> tag used for carrying executable JavaScript.
Putting an empty conversion rule block -{}- inside these tags will function as a "force convert" switch for the converter.
This hack can be useful for code samples nested in these tags.
A caveat, however, is that this switch doesn't seem to work for the extension-provided <syntaxhighlight> tags which eventually generates a <pre>...</pre> nested with elements (T34943).
The switch also won't work with scripts not originally included with the page's HTML source that LC is designed to operate on.
MediaWiki messages are not processed by LC. This inconvenience is tracked in T170916.
関連項目
- Help:マジックワード - コンバーターに関連するスイッチについて
- Parsoid/Language conversion - which collects additional documentation relating to Language Conversion