Edición de «Plantilla:Y-e/doc»

{{Subpágina de documentación}}
=== Uso ===
Evalúa si la conjunción copulativa '''''<big>y</big>''''' debe tomar la forma '''''<big>e</big>''''' en función del texto que le sigue, devolviendo «y texto» o «e texto» según corresponda.

=== Código ===
* <code><nowiki>{{y-e|cualquier texto}}</nowiki></code> devuelve → {{y-e|cualquier texto}}
* <code><nowiki>{{y-e|Historia |enlazar}}</nowiki></code> devuelve → {{y-e|Historia |enlazar}}
* <code><nowiki>{{y-e|Historia |sin texto}}</nowiki></code> devuelve → {{y-e|Historia |sin texto}}
* <code><nowiki>{{y-e|del Perú |enlace=Historia del Perú}}</nowiki></code> devuelve → {{y-e|del Perú |enlace=Historia del Perú}}
Para encerrar el texto devuelto entre comillas o caracteres de wikitexto:
* <code><nowiki>{{y-e|iconoscopio |pre=''' |post=''' }}</nowiki></code> devuelve → {{y-e|iconoscopio |pre=''' |post=''' }}
* <code><nowiki>{{y-e|I Love Lucy|pre=«'' |post=''» |enlazar}}</nowiki></code> devuelve → {{y-e|I Love Lucy|pre=«'' |post=''» |enlazar}}
Para forzar el resultado en el caso de que falle la evaluación automática:<sup>(ver [[#Nota]] al pie)</sup>
* <code><nowiki>{{y-e|ILoveYou|e=no |enlazar}}</nowiki></code> devuelve → {{y-e|ILoveYou|e=no |enlazar}}

=== Parámetros ===
;Obligatorios
* «<code>'''texto'''</code>», debe ser el primer parámetro; puede ser una palabra, un título de artículo o cualquier otra frase. No debe comenzar con corchetes de enlace. Si no existe o está en blanco, la plantilla no devolverá nada.
;Opcionales
* <code>'''|enlazar'''</code>, utilizarlo para que el «texto» resulte enlazado. Al ser un parámetro sin nombre, no lleva signo igual. Puede ubicarse en cualquier posición entre los parámetros adicionales, pero nunca antes del «texto». También se aceptan <tt>'''enlace'''</tt> o <tt>'''enlazado'''</tt> como sinónimos.
* <code>'''|enlace=«Título real de la página»'''</code>, utilizarlo cuando el «texto» mostrado no coincida con el título al cual se enlaza. La plantilla decidirá si poner '''y''' o '''e''' en función del «texto» mostrado. Si se hace uso de este parámetro “con signo igual”, el anterior es innecesario.
* <code>'''|sin texto'''</code> o <code>'''|st'''</code>, utilizarlo para obtener <u>solamente</u> la conjunción '''y''' o '''e'''. El «texto» del primer parámetro se usará para evaluar la respuesta, pero no será mostrado.
* <code>'''|pre= '''</code> y <code>'''|post= '''</code>, utilizarlos para insertar caracteres inmediatamente antes y después del «texto» en la cadena devuelta, como pueden ser comillas o código de formato wiki.
* <code>'''|e=sí '''</code> o <code>'''|e=no '''</code>, utilizarlos para forzar el resultado en el caso de que la plantilla falle en su evaluación.<sup>(ver [[#Nota]] al pie)</sup>

=== Aplicaciones posibles ===
* En el código interno de plantillas como {{tl|Otros usos}} o {{tl|AP}}, cuando deban mencionarse los títulos de dos o más artículos.
* En el código interno de plantillas como {{tl|wikificar}}, al nombrar las materias o temas donde se encuadra el artículo.
* '''Actualmente en uso''' en {{tl|problemas artículo}} a través de su plantilla auxiliar {{tl|Temas PA}}.

=== Reglas de evaluación ===
A menos que esté definido el parámetro '''e=''' (en cuyo caso no se lleva a cabo ninguna evaluación), el proceso utilizado para determinar el resultado es el siguiente:

*Si el «texto» enviado como parámetro comienza con '''í''' o '''hí''' (acentuadas), devuelve «e texto» sin evaluar las siguientes letras;
*si el texto comienza con '''i''' o '''hi''', se pasa a analizar la existencia de diptongo, y a la vez la posibilidad de que se trate de una expresión en inglés:
** si la siguiente letra es '''a''', '''e''' u '''o''' (esté o no acentuada) entonces hay diptongo y devuelve «y texto»;
** si a la '''i''' le sigue cualquier otra letra o carácter, y no se detecta que se trate de una expresión en inglés, devuelve «e texto»;
** si se detecta que las primeras letras coinciden con expresiones en inglés (como por ejemplo ''I am, I have'' o ''high''), devuelve «y texto» en concordancia con su pronunciación;
* si el texto comienza con '''y''', se analiza si la misma presenta sonido de '''i''', de la siguiente manera:
** si la letra que sigue es una vocal, acentuada o no, la '''y''' tendrá sonido ''ye'' y la plantilla devolverá «y texto»;
**si a la '''y''' le sigue cualquier otra letra o carácter, incluyendo un espacio en blanco, devolverá «e texto»;
* si el texto comienza con '''e''', se analiza la posibilidad de que se trate de una expresión en inglés como ''eagle'', ''eBay'' o ''e-book'', en cuyo caso devuelve «e texto»; de lo contrario devuelve «y texto»;
* si el texto comienza con una letra que no sea '''i''', '''h''', '''e''' o '''y'''; o con cualquier otro carácter, a excepción de los signos de apertura de admiración ('''¡''') e interrogación  ('''¿'''), devuelve «y texto»;
* en el caso de que el texto comience con uno de esos signos, lo analiza del mismo modo, pero descartando la posibilidad de que se trate de idioma inglés.

=== Ejemplos ===
Se incluyen variados ejemplos; para ver el código utilizado en cada uno, entra en [{{fullurl:Plantilla:Y-e/doc|action=edit&section=6&preview=yes}} modo edición].
{|
|-
|colspan=4 |'''Sin ningún otro parámetro más que el «texto»'''<br/>Ejemplo: <code><nowiki>{{y-e|historia}}</nowiki></code>
|-
|style="width:140px;"| {{y-e|historia}}
|style="width:140px;"| {{y-e|informática}}
|style="width:140px;"| {{y-e|hielo}}
| {{y-e|épico}}
|-
| {{y-e|yerba}}
| {{y-e|yodo}}
| {{y-e|Ícaro}}
| {{y-e|icono}}
|-
| {{y-e|Yrithinnd}}
| {{y-e|Yodigo}}
| {{y-e|Isha}}
| {{y-e|Ezarate}}
|-
| {{y-e|Eagles}}
| {{y-e|Easy Rider}}
| {{y-e|Eau de-Cologne}}
| {{y-e|Eastmancolor}}
|-
|colspan=4 |<br/>'''Agregando el parámetro “enlazar”'''<br/>Ejemplo: <code><nowiki>{{y-e|hierba|enlazar}}</nowiki></code> 
|-
| {{y-e|hierba|enlazar}}
| {{y-e|hiato (fonología)|enlazar}}
| {{y-e|Islandia|enlazado}}
| {{y-e|¡Ya basta!|enlazar}}
|-
| {{y-e|iPhone|enlazar}}
| {{y-e|Ycuá Satí|enlazado}}
| {{y-e|Yugoslavia|enlazado}}
| {{y-e|Hi-5|enlazar}}
|-
| {{y-e|Hawái|enlazar}}
| {{y-e|yo|enlazar}}
| {{y-e|Y|enlazar}}
| {{y-e|Y viva España|enlazar}}
|-
| {{y-e|¡Histeria!|enlazar}}
| {{y-e|iPad|enlazar}}
| {{y-e|I|enlace}}
| {{y-e|Himno Nacional Mexicano|enlazar}}
|-
| {{y-e|¡Hola!|enlazar}}
| {{y-e|iTunes|enlazar}}
| {{y-e|¿Hablas conmigo?|enlace}}
| {{y-e|¿Es usted el asesino?|enlazar}}
|-
| {{y-e|I Love You Baby|enlazar}}
| {{y-e|¡Invasión! (cómic)|enlazar}}
| {{y-e|¿Y ahora qué?|enlace}}
| {{y-e|I've Got a Feeling|enlazar}}
|-
| {{y-e|eBay|enlazar}}
| {{y-e|e-mail|enlazar}}
| {{y-e|iMac|enlazar}}
| {{y-e|e-book|enlazar}}
|-
|colspan=4 |<br/>'''Agregando caracteres de formato mediante “pre=” y “post=”'''<br/>Ejemplo: <code><nowiki>{{y-e|IBM|pre='''|post='''}}</nowiki></code>
|-
| {{y-e|IBM|pre='''|post='''}}
| {{y-e|pre=«|comillas|post=»|enlazar}}
| {{y-e|pre=“|Highlander|post=”}}
| {{y-e|I Want to Hold Your Hand|enlazar|pre=''|post=''}}
|-
|colspan=4 |<br/>'''Resultados forzados con e=sí o e=no''' <sup>(ver [[#Nota]] al pie)</sup><br/>Ejemplo: <code><nowiki>{{y-e|eMule|enlazar|e=sí}}</nowiki></code>
|-
| {{y-e|eMule|enlazar|e=sí}}
| {{y-e|e-learning|enlace}}
| {{y-e|ILoveYou|enlazar|e=no}}
| {{y-e|IDon't Want to Fight|e=no|enlazar}}
|-
|colspan=4 |<br/>'''Usando el parámetro “enlace=”'''<br/>Ejemplo: <code><nowiki>{{y-e|de Química|enlace=Anexo:Ganadores del Premio Nobel de Química}}</nowiki></code>
|-
| {{y-e|de Química|enlace=Anexo:Ganadores del Premio Nobel de Química}}
| {{y-e|de Química|enlace=Anexo:Ganadores del Premio Nobel de Química|e=sí}}
| {{y-e|de Química|enlace=Anexo:Ganadores del Premio Nobel de Química|enlazar}}
| {{y-e|pre=''|República de Islandia|enlace=Islandia|post=''}}
|-
|colspan=4 |<br/>'''Usando el parámetro “sin texto” o “st”'''<br/>Ejemplo: <code><nowiki>{{y-e|Islandia|st}}</nowiki></code>
|-
| {{y-e|Islandia|st}}
| {{y-e|Islandia|st|e=no}}
| {{y-e|Yugoslavia|st}}
| {{y-e|Yugoslavia|st|e=sí}}
|}

=== Nota ===
Si consideras que la evaluación realizada por la plantilla está fallando en algún caso concreto, por favor, plantéalo en la discusión. Ten en cuenta que existen palabras como [[iPhone]] o [[iceberg]] cuya pronunciación no es uniforme para todas las personas: algunos dicen /áifon/, otros /ífon/ y otros /ifone/. En esos casos, donde no hay un criterio único, existirá discrepancia en cuanto a qué forma de la conjunción ''y'' debe usarse.

Ten presente también que la plantilla utiliza un algoritmo sencillo para discernir entre palabras en español y en inglés, y que en el segundo caso seguramente habrá muchas que interprete como españolas y devuelva el valor equivocado; tener en cuenta todos los casos añadiría mucha complejidad a la plantilla. Usa el parámetro <code>'''|e='''</code> como sea oportuno para corregir este problema.

=== Referencias ===
* [http://lema.rae.es/dpd/srv/search?id=9n8R9ghyFD6fcqFIBx DPD]
<includeonly>
[[Categoría:Wikipedia:Plantillas de atajos y cálculos]]
</includeonly>