View source for Language Converter/Advanced syntax/es

<languages/>
{{Under construction|2=Do not mark for translation. See [[:zh:Wikipedia:互助客栈/技术#Request for Translation of LanguageConverter documentation]] for discussions.}}
{{#ifeq:{{PAGELANGUAGE}}|zh
|{{softredirect|zh:Help:高级字词转换语法}}
|: Versión traducida de [[:zh:Help:高级字词转换语法]]
}}

Esta página describe marcas especiales que se encuentran en [[Special:MyLanguage/Writing systems#LanguageConverter|LanguageConverter]], un sistema que convierte entre variantes de idioma mediante el reemplazo de caracteres/palabras.
En todos los ejemplos siguientes, los caracteres en minúsculas se utilizan para representar el chino simplificado y las MAYÚSCULAS representan el chino tradicional.

<span lang="en" dir="ltr" class="mw-content-ltr">Some example characters you can use for testing:</span>

{| class="wikitable"
|+
! <span lang="en" dir="ltr" class="mw-content-ltr">TRADITIONAL</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">simplified</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">Transliteration<br> ([[w:Pinyin|Pinyin]])</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">Meaning</span>
|-
|<span lang="zh-hant">氣</span>
|<span lang="zh-hans">气</span>
|<span lang="zh">qì</span>
| <span lang="en" dir="ltr" class="mw-content-ltr">''air''</span>
|-
|<span lang="zh-hant">馬</span>
|<span lang="zh-hans">马</span>
|<span lang="zh">mǎ</span>
| <span lang="en" dir="ltr" class="mw-content-ltr">''horse''</span>
|-
|<span lang="zh-hant">電</span>
|<span lang="zh-hans">电</span>
|<span lang="zh">diàn</span>
| <span lang="en" dir="ltr" class="mw-content-ltr">''electricity''</span>
|}

<span id="Concept"></span>
== Concepto ==

Las marcas de LanguageConverter se ven así:

* <code><nowiki>-{</nowiki> text <nowiki>}-</nowiki></code>
* <code><nowiki>-{</nowiki> [[#Conversion flags|'''flag''']] | variant1 : text1 ; variant2 : text2 ; <nowiki>}-</nowiki></code>
* <code><nowiki>-{</nowiki> [[#Conversion flags|'''flag1''' ; '''flag2''']] | from => variant : to ; <nowiki>}-</nowiki></code>

Donde las banderas se describen a continuación, y los nombres de las variantes son códigos de idioma (como <code>zh-cn</code> o <code>zh-tw</code>).

<div lang="en" dir="ltr" class="mw-content-ltr">
== Language codes ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The examples below use the following language codes:
</div>

{| class = "wikitable"
|-
! <span lang="en" dir="ltr" class="mw-content-ltr">[[w:IETF language tag|Code]]</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">Language</span>
! <span lang="en" dir="ltr" class="mw-content-ltr">Note</span>
|-
|zh || {{#language:zh|{{pagelang2}}}}
| <span lang="en" dir="ltr" class="mw-content-ltr">"zh" is the initial consonant of the Mandarin pinyin for the character "中". (China is 中国, ''Zhōngguó''.)</span>
|-
|zh-hans || {{#language:zh-hans|{{pagelang2}}}}
| <code>hans</code> is an [[w:ISO 15924|ISO 15924]] script code, part of the [[w:IETF language tag|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 || {{#language:zh-hant|{{pagelang2}}}}
| <code>hant</code> is an [[:en:ISO_15924|ISO 15924]] script code, part of the [[:en:IETF_language_tag|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)||<code>cn</code> is the [[:en:ISO_3166-1_alpha-2|ISO 3166-1 alpha-2]] code for mainland China, part of the [[:en:IETF_language_tag|BCP 47 language tag]].
|-
|zh-hk||Hong Kong (Traditional)||<code>hk</code> is the [[:en:ISO_3166-1_alpha-2|ISO 3166-1 alpha-2]] code for Hong Kong, part of the [[:en:IETF_language_tag|BCP 47 language tag]].
|-
|zh-mo||Macau (Traditional)||<code>mo</code> is the [[:en:ISO_3166-1_alpha-2|ISO 3166-1 alpha-2]] code for Macau, part of the [[:en:IETF_language_tag|BCP 47 language tag]].
|-
|zh-my||Malaysia (Simplified)||<code>my</code> is the [[:en:ISO_3166-1_alpha-2|ISO 3166-1 alpha-2]] code for Malaysia, part of the [[:en:IETF_language_tag|BCP 47 language tag]].
|-
|zh-sg||Singapore (Simplified)||<code>sg</code> is the [[:en:ISO_3166-1_alpha-2|ISO 3166-1 alpha-2]] code for Singapore, part of the [[:en:IETF_language_tag|BCP 47 language tag]]. Malaysia and Singapore were originally covered by a combined variant.
|-
|zh-tw||Taiwan (Traditional)||<code>tw</code> is the [[:en:ISO_3166-1_alpha-2|ISO 3166-1 alpha-2]] code for Taiwan, part of the [[:en:IETF_language_tag|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.
{{CSS image crop
|Image         = MediaWiki fallback chains.svg
|bSize         = 1000
|cWidth        = 400
|cHeight       = 380
|oTop          = 0
|oLeft         = 550
|Location      = right
|Description   = Backup chain for MediaWiki language codes
|Alt           = Backup chain for MediaWiki language codes
}}
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 [[wmdoc:mediawiki-core/master/php/ZhConverter_8php_source.html|<code>ZhConverter</code>]]<code>::getVariantsFallbacks()</code> the order of fallback variants is as follows:

{| class="wikitable"
! Language code !! colspan="3"| 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 <code>zh</code> are, in order: zh-hans, zh-hant, zh-cn, zh-tw, zh-hk, zh-sg, zh-mo, zh-my.

<span id="Syntax"></span>
== Sintaxis ==

<span id="Basic_syntax"></span>
=== Sintaxis básica ===
{|class = "wikitable"
|-
!rowspan="2"| Nombre
!rowspan="2" width=20%| Descripción
!colspan="2"| Ejemplo
!rowspan="2" width=15%| Nota
|-
! width=30%| Wikitexto
! Muestra
|-
! Bidireccional
| Conversión bidireccional con soporte de [[#Conversion flags|flag]]. Sintaxis más común en la conversión manual.
|
<syntaxhighlight lang="wikitext">
-{zh-cn:computer; zh-tw:ELECTRONICBRAIN;}-
</syntaxhighlight>
|
;zh, zh-hans, zh-cn, zh-my, zh-sg
:computer
;zh-hant, zh-hk, zh-mo, zh-tw
:ELECTRONICBRAIN
|
|-
! Unidireccional
| Conversión unidireccional con soporte de [[#Conversion flags|flag]]. Se utiliza principalmente para agregar nuevas reglas de conversión. Corre más rápido que las reglas bidireccionales.

Principalmente útil para unificar la variación del idioma y prevenir la conversión errática.
|
<syntaxhighlight lang="wikitext">
-{H|HUGEBLOCK=>zh-cn:macro;}-
Test: HUGEBLOCK, macro
</syntaxhighlight>
|
;zh
:Test: HUGEBLOCK, Macro
;zh-hans, zh-my, zh-sg
:test: hugeblock, macro
;zh-hant, zh-hk, zh-mo, zh-tw
:TEST: HUGEBLOCK, MACRO
;zh-cn
:test: macro, macro
| El respaldo no es compatible con la conversión unidireccional. Por ejemplo, en el ejemplo anterior, <code>zh-hans</code> y <code>zh-sg</code> no usarán las reglas de <code>zh-cn</code>. Por otro lado, si la regla se inserta en <code>zh-hans</code>, solo se aplicaría a <code>zh-hans</code>, pero no a <code>zh-cn</code>.
|-
! Desactivado
| Deshabilitar la conversión de idioma
|
<syntaxhighlight lang="wikitext">
-{SimpTrad}-
</syntaxhighlight>
(<span class="mw-translate-fuzzy">Alternativamente, con el flag "R": <code>-{R|SimpTrad}-</code>-</span>)
|
;(todas las variantes)
:SimpTrad
| Esto deshabilita la conversión por completo.
|-
! (Semi)desactivado
| Desactivar la conversión de "palabras"<br /><small>(Separar palabras, no afectará la transcripción de caracteres.)</small>

Útil para detener la conversión errática dividiendo las palabras correctamente.
|
<syntaxhighlight lang="wikitext">
HAN-{}-GUK, cho-{}-sun
</syntaxhighlight>

(asumiendo que hay una regla de conversión para todo el sistema entre <code>HANGUK</code> y <code>chosun</code>)
|
;zh
:HANGUK, chosun
;zh-hans, zh-cn, zh-my, zh-sg
:hanguk, chosun
;zh-hant, zh-hk, zh-mo, zh-tw
:HANGUK, CHOSUN
| Hay otra forma de lograr esto, que es más conveniente en las plantillas. Consulte "Flag de conversión combinada" a continuación.<br />Por ejemplo: <code>-{{(}}zh;zh-hans;zh-hant{{!}}HANGUK}- -{zh;zh-hans;zh-hant{{!}}chosun}-</code>
|}

<span id="Conversion_flags"></span>
=== Flags de conversión ===

<span id="Common_flags"></span>
==== Flags comunes ====
<span lang="en" dir="ltr" class="mw-content-ltr">Note that the actual effect of the inserted rules only takes place after the point where the rule is defined.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Therefore it is recommended to place rules (for example, using the [[:zh:Template:NoteTA|NoteTA template]]) at the beginning of the article and above any preface or infobox.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">In some cases, however, it is desired to present words in the disambiguation [[w:Wikipedia:Hatnote|hatnote template]] from being transformed, in which case the rules should be placed below that.</span>

{|class = "wikitable"
|-
!rowspan="2" width=3%| Flag
!rowspan="2" width=15%| Descripción
!colspan="2"| Ejemplo
!rowspan="2" width=15%| Nota
|-
! width=35%| Wikitexto
! Muestra
|-
! H
| Insertar una regla de conversión sin salida
|
<syntaxhighlight lang="wikitext">
-{H|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}-
Test: blog, WEBJOURNAL, WEBLOG
</syntaxhighlight>
|
;zh
:Test: blog, WEBJOURNAL, WEBLOG
;zh-hans
:test: blog, webjournal, weblog
;zh-hant: 
:TEST: BLOG, WEBJOURNAL, WEBLOG
;zh-cn, zh-my, zh-sg
:test: blog, blog, blog
;zh-hk, zh-mo:
:TEST: WEBJOURNAL, WEBJOURNAL, WEBJOURNAL
;zh-tw
:TEST: WEBLOG, WEBLOG, WEBLOG
| zh-hans y zh-hant son simplemente tipos de escritura y no aplicarán reglas bidireccionales. Véase también el parámetro <code>$manualLevel</code> en LanguageConverter.
|-
! A
| Insertar una regla de conversión con un resultado en el idioma actual
|
<syntaxhighlight lang="wikitext">
-{A|zh-cn:blog; zh-hk:WEBJOURNAL; zh-tw:WEBLOG;}-
Test: blog, WEBJOURNAL, WEBLOG
</syntaxhighlight>
|
;zh
:blog
:Test: blog, WEBJOURNAL, WEBLOG
;zh-hans
:blog
:test: blog, webjournal, weblog
;zh-hant
:WEBLOG
:TEST: BLOG, WEBJOURNAL, WEBLOG
;zh-cn, zh-my, zh-sg
:blog
:test: blog, blog, blog
;zh-hk, zh-mo
:WEBJOURNAL
:TEST: WEBJOURNAL, WEBJOURNAL, WEBJOURNAL
;zh-tw
:WEBLOG
:TEST: WEBLOG, WEBLOG, WEBLOG
| Compare la primera salida (A) con la de H y la operación sin flags.
|-
! -
| Quitar la regla de conversión existente
|
<syntaxhighlight lang="wikitext">
-{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
</syntaxhighlight>
|
;zh
:+ blog, WEBJOURNAL, WEBLOG
:- blog, WEBJOURNAL, WEBLOG
;zh-hans
:+ blog, webjournal, weblog
:- blog, webjournal, weblog
;zh-hant
:+ BLOG, WEBJOURNAL, WEBLOG
:- BLOG, WEBJOURNAL, WEBLOG
;zh-cn, zh-my, zh-sg
:+ blog, blog, blog
:- blog, webjournal, weblog
;zh-hk, zh-mo
:+ WEBJOURNAL, WEBJOURNAL, WEBJOURNAL
:- BLOG, WEBJOURNAL, WEBLOG
;zh-tw
:+ WEBLOG, WEBLOG, WEBLOG
:- BLOG, WEBJOURNAL, WEBLOG
| Comparar prueba (+), prueba (-) y hans/hant básico
|-
! T
| Anular el título de la página
|
<syntaxhighlight lang="wikitext">
-{T|zh-cn:tom hanks; zh-hk:SOUP HANS; zh-tw:TOM HANKS;}-
</syntaxhighlight>
(assuming the original title is "TomHanks")(asumiendo que el título original es "TomHanks")
| (mostrado como título de la página)
; zh ([[gerrit:19746]])
: TomHanks
; zh-hans, zh-cn, zh-my, zh-sg
: tom hanks
; zh-hant, zh-tw
: TOM HANKS
; zh-hk, zh-mo
: SOUP HANS
| 
|-
! D
| Describe la regla de conversión
|
<syntaxhighlight lang="wikitext">
-{D|zh-cn:tom hanks; zh-hk:SOUP HANS; zh-tw:TOM HANKS}-
</syntaxhighlight>
|
;(all variants)
:大陆：tom hanks；香港：SOUP HANS；臺灣：TOM HANKS；
| Bueno para generar descripciones generales en grupos de reglas de conversión públicos.
|}

<span id="Combined_conversion_flag"></span>
==== Flag de conversión combinada ====
{|class = "wikitable"
|-
!rowspan="2" width=7%| Flag
!rowspan="2" width=13%| Descripción
!colspan="2"| Ejemplo
!rowspan="2" width=12%| Nota
|-
! width=37%| Wikitexto
! Muestra
|-
! ''nombre de variante''
| Considere solo ciertas variantes para la conversión
|
<syntaxhighlight lang="wikitext">
-{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}-
</syntaxhighlight>
(asumiendo que esto se ejecuta en una wiki china)
|
;zh
:Test 1: blog, WEBJOURNAL, WEBLOG
:Test 2: blog, WEBJOURNAL, WEBLOG
;zh-hans, zh-cn, zh-my, zh-sg
:test 1: blog, webjournal, weblog
:test 2: blog, blog, blog
;zh-hant, zh-hk, zh-mo, zh-tw
:TEST 1: BLOG, WEBJOURNAL, WEBLOG
:TEST 2: WEBJOURNAL, WEBJOURNAL, WEBJOURNAL
| Compare la prueba 1, la prueba 2 y el caso de uso en el indicador H anterior. 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]].
|}

<span id="Exceptions"></span>
==Excepciones==
El conversor de lenguaje evita convertir cualquier cosa que se encuentre en bloques de "código" como {{tag|pre}}, {{tag|code}}, así como la etiqueta {{tag|script}} utilizada para llevar JavaScript ejecutable.
Poner un bloqueo de reglas de conversión vacío <code><nowiki>-{}-</nowiki></code> dentro de estas etiquetas funcionará como un interruptor de "conversión forzada" para el convertidor.
Este truco puede ser útil para muestras de código anidadas en estas etiquetas.

Sin embargo, una advertencia es que este cambio no parece funcionar para las etiquetas {{xtag|syntaxhighlight}} proporcionadas por la extensión, que eventualmente genera un {{tag|pre}} anidado con elementos ([[phab:T34943|T34943]]).
El conmutador tampoco funcionará con tipos de escritura que no se incluyeron originalmente con la fuente HTML de la página en la que LC está diseñado para operar.

MediaWiki Los mensajes no son procesados por LC.
Este inconveniente se registra en [[phab:T170916|T170916]].

<span id="See_also"></span>
== Véase también ==
* {{ll|Help:Magic words}} - Para los cambios relacionaron al convertidor
* {{ll|Parsoid/Language conversion}} - que colecciona documentación adicional relacionada con la coversión de idiomas