Parrot Markup
Parrot Markup es la pequeña sintaxis que enriquece los textos de un diccionario: los huecos de un ejercicio, las respuestas admitidas, la puntuación que no se evalúa, las pistas, las palabras en otro idioma, la pronunciación. Un texto simple sigue siendo un texto simple: solo se añade marcado donde sirve.
Dónde usarlo
| Texto | Uso habitual |
|---|---|
Ejercicios (value de preguntas, respuestas, propuestas) | huecos, afijos, pistas, alternativas |
| Consignas y títulos | una palabra citada en otro idioma: {lang=pt-PT§ser} |
Palabras del vocabulario (text) | grafías admitidas: colour|color |
translation_context | un contexto por idioma: {lang=es§vehículo}{lang=pt§veículo} |
Patterns (prefix, suffix) | pronunciación impuesta: ipa=ˈsʌmθɪŋ§ sth |
Cinco caracteres especiales
| Carácter | Función |
|---|---|
{ } | delimitan un grupo |
| | separa alternativas |
§ | termina un atributo colocado al principio de un texto |
` | escapa el carácter siguiente |
Todo lo demás, espacios incluidos, es texto normal.
Alternativas
| separa formas que se aceptan todas. Fuera de las llaves afecta a todo el texto; dentro, solo a la parte que varía.
| Escritura | Respuestas aceptadas |
|---|---|
colour|color | colour, color |
I'd like {a flat|an apartment} | I'd like a flat, I'd like an apartment |
{the |}cinema | the cinema, cinema: una rama vacía hace opcional una palabra |
En un archivo de ejercicios, es preferible una línea answer o proposal por respuesta: la
importación las une ella misma con |, y la hoja de cálculo sigue siendo legible.
Atributos
Un atributo se escribe clave=valor§ al principio de un texto, normalmente dentro de un grupo:
{lang=pt-PT§ser}. Varios atributos se suceden, cada uno con su propio §, en cualquier orden:
{type=clue§lang=fr-FR§passé} equivale a {lang=fr-FR§type=clue§passé}.
| Atributo | Efecto |
|---|---|
?1§ (o input=1§) | un hueco numerado |
#1§ (o section=1§) | una sección numerada del ejercicio |
lang=…§ | el idioma del texto: lo lee la voz de ese idioma |
type=affix§ | un afijo: se muestra, nunca se evalúa |
type=clue§ | una pista, mostrada entre paréntesis |
type=context§ | un contexto que elimina una ambigüedad |
ipa=…§ | la pronunciación impuesta |
Un atributo solo vale para la rama a la que precede. {?1§was|were} significa «was en el hueco 1,
o were fuera del hueco»: were sería rechazada. Para que el hueco admita ambas, encierra las
alternativas: {?1§{was|were}}.
Huecos
En la pregunta, {?1§} marca el lugar que rellenar. En la respuesta,
{?1§bought} da lo que se espera en ese hueco. Varios huecos se numeran ?1, ?2…
| Escritura | |
|---|---|
| Pregunta | Yesterday I {?1§} a new phone. |
| Respuesta | {?1§bought} |
| Dos huecos | {?1§buy}{?2§bought} |
Solo se evalúa el contenido del hueco: lo que lo rodea en la pregunta se muestra, no se teclea. En un archivo de ejercicios, la columna
index fija el número del hueco, así que una respuesta a menudo se escribe sin ningún marcado.
Afijos: se muestran, nunca se evalúan
{type=affix§…} encierra lo que acompaña a la respuesta sin formar parte de ella: la puntuación final, los signos de apertura
del español, las comillas. El alumno no lo teclea y nunca se le penaliza.
{?1§A coffee, please}{type=affix§.}
{type=affix§¿}Cómo te llamas{type=affix§?}
El artículo y el to del infinitivo inglés también son afijos, pero se declaran de una vez por todas en un pattern (consulta Crear un diccionario).
Pistas y contexto
{type=clue§…} añade una pista mostrada entre paréntesis: el verbo que conjugar, un registro, la forma
esperada. No se teclea. Se lee en voz alta si la opción Leer las pistas está marcada (consulta
Locución y voz).
Yesterday I {?1§}{type=clue§buy} a new phone.
{?1§How do you do}?{type=clue§formal}
{type=context§…} elimina una ambigüedad, como el contexto de una palabra del vocabulario: siempre se lee. Una pista nunca
debe revelar la respuesta.
Idiomas
{lang=…§…} señala un fragmento escrito en un idioma distinto del resto del texto: lo lee la voz de su idioma, con su acento.
Indica el código completo, con el país.
Completa con «{lang=pt-PT§ser}».
{type=clue§{lang=pt-PT§você}, afirmativo}
Secciones
Un ejercicio puede tener varias secciones numeradas, por ejemplo la frase que completar y, a su lado, su traducción
para guiar al alumno. {#2§…} coloca un texto en la sección 2. En un archivo de ejercicios, la columna section
de la línea _ indica en qué sección están la pregunta y la respuesta.
{#1§I gave up.}{#2§lang=es-ES§Me rendí.}
Pronunciación
ipa=…§ impone la pronunciación del texto al que precede, en alfabeto fonético internacional, cuando la síntesis de voz se
equivoca. Solo transcribe ese texto, nunca la frase de alrededor.
{?1§ipa=ˈrɛd§{read}}
ipa=ˈsʌmθɪŋ§ sth
Escribir un carácter especial
El acento grave hace literal el carácter que lo sigue: `{, `}, `|, `§, y
`` para el propio acento grave. También sirve en los archivos CSV, para una celda que empieza por ~,
+ o - sin ser una orden (`+18).
Sin mensajes de error
Parrot Markup nunca se rechaza: una llave de más o de menos, un atributo desconocido, nada bloquea la importación. Es cómodo, pero una errata pasa desapercibida.
- Solo existen las claves
lang,section,input,type,ipayref; cualquier otra (lnag=,part=1) se ignora y el texto pierde su estructura. typesolo acepta valores conocidos (affix,clue,context…); los demás se ignoran.- Las mayúsculas cuentan:
lang=fr-FR, noLANG=FR-fr.
Tras una importación, haz unos cuantos ejercicios en la aplicación: es el mejor control.
Chuleta
| Escritura | Sentido |
|---|---|
a|b, {a|b} | alternativas |
{palabra |} | palabra opcional |
{?1§} / {?1§respuesta} | hueco en la pregunta / respuesta esperada |
{?1§{a|b}} | hueco con varias respuestas |
{type=affix§.} | se muestra, nunca se evalúa |
{type=clue§…} | pista entre paréntesis |
{type=context§…} | contexto que elimina una ambigüedad |
{lang=pt-PT§…} | fragmento en otro idioma |
{#2§…} | sección 2 |
ipa=…§texto | pronunciación impuesta |
`{, `|, `§, `` | carácter especial literal |