Super Parrot Documentación

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

TextoUso habitual
Ejercicios (value de preguntas, respuestas, propuestas)huecos, afijos, pistas, alternativas
Consignas y títulosuna palabra citada en otro idioma: {lang=pt-PT§ser}
Palabras del vocabulario (text)grafías admitidas: colour|color
translation_contextun 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ácterFunció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.

EscrituraRespuestas aceptadas
colour|colorcolour, color
I'd like {a flat|an apartment}I'd like a flat, I'd like an apartment
{the |}cinemathe 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é}.

AtributoEfecto
?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
PreguntaYesterday 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.

Tras una importación, haz unos cuantos ejercicios en la aplicación: es el mejor control.

Chuleta

EscrituraSentido
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=…§textopronunciación impuesta
`{, `|, `§, ``carácter especial literal