Super Parrot Documentação

Parrot Markup

Parrot Markup é a pequena sintaxe que enriquece os textos de um dicionário: as lacunas de um exercício, as respostas aceitas, a pontuação que não é avaliada, as dicas, as palavras em outro idioma, a pronúncia. Um texto simples continua sendo um texto simples: só se acrescenta marcação onde ela é útil.

Onde usar

TextoUso comum
Exercícios (value das perguntas, respostas, propostas)lacunas, afixos, dicas, alternativas
Enunciados e títulosuma palavra citada em outro idioma: {lang=pt-PT§ser}
Palavras do vocabulário (text)grafias aceitas: colour|color
translation_contextum contexto por idioma: {lang=pt§veículo}{lang=en§vehicle}
Patterns (prefix, suffix)pronúncia imposta: ipa=ˈsʌmθɪŋ§ sth

Cinco caracteres especiais

CaractereFunção
{ }delimitam um grupo
|separa alternativas
§termina um atributo colocado no início de um texto
`escapa o caractere seguinte

Todo o resto, espaços incluídos, é texto comum.

Alternativas

| separa formas que são todas aceitas. Fora das chaves, vale para o texto inteiro; dentro delas, só para a parte que muda.

EscritaRespostas aceitas
colour|colorcolour, color
I'd like {a flat|an apartment}I'd like a flat, I'd like an apartment
{the |}cinemathe cinema, cinema: um ramo vazio torna uma palavra opcional

Em um arquivo de exercícios, prefira uma linha answer ou proposal por resposta: a importação as junta sozinha com |, e a planilha continua legível.

Atributos

Um atributo é escrito chave=valor§ no início de um texto, geralmente dentro de um grupo: {lang=pt-PT§ser}. Vários atributos se seguem, cada um terminado pelo próprio §, em qualquer ordem: {type=clue§lang=fr-FR§passé} equivale a {lang=fr-FR§type=clue§passé}.

AtributoEfeito
?1§ (ou input=1§)uma lacuna numerada
#1§ (ou section=1§)uma seção numerada do exercício
lang=…§o idioma do texto: ele é lido pela voz desse idioma
type=affix§um afixo: exibido, nunca avaliado
type=clue§uma dica, exibida entre parênteses
type=context§um contexto que desfaz uma ambiguidade
ipa=…§a pronúncia imposta

Um atributo só vale para o ramo que ele precede. {?1§was|were} quer dizer “was na lacuna 1, ou were fora da lacuna”: were seria recusada. Para a lacuna aceitar as duas, envolva as alternativas: {?1§{was|were}}.

Lacunas

Na pergunta, {?1§} marca o lugar a preencher. Na resposta, {?1§bought} indica o que se espera nessa lacuna. Várias lacunas são numeradas ?1, ?2…

Escrita
PerguntaYesterday I {?1§} a new phone.
Resposta{?1§bought}
Duas lacunas{?1§buy}{?2§bought}

Só o conteúdo da lacuna é avaliado: o que a rodeia na pergunta é exibido, não digitado. Em um arquivo de exercícios, a coluna index define o número da lacuna, de modo que uma resposta muitas vezes é escrita sem nenhuma marcação.

Afixos: exibidos, nunca avaliados

{type=affix§…} envolve o que acompanha a resposta sem fazer parte dela: a pontuação final, os sinais de abertura do espanhol, as aspas. O aluno não digita e nunca é penalizado.

{?1§A coffee, please}{type=affix§.}
{type=affix§¿}Cómo te llamas{type=affix§?}

O artigo e o to do infinitivo inglês também são afixos, mas são declarados de uma vez por todas em um pattern (veja Criar um dicionário).

Dicas e contexto

{type=clue§…} acrescenta uma dica exibida entre parênteses: o verbo a conjugar, um registro, a forma esperada. Ela não é digitada. É lida em voz alta se a opção Ler as dicas estiver marcada (veja Locução e voz).

Yesterday I {?1§}{type=clue§buy} a new phone.
{?1§How do you do}?{type=clue§formal}

{type=context§…} desfaz uma ambiguidade, como o contexto de uma palavra do vocabulário: é sempre lido. Uma dica nunca deve entregar a resposta.

Idiomas

{lang=…§…} sinaliza um fragmento escrito em um idioma diferente do resto do texto: ele é lido pela voz do seu idioma, com o sotaque dele. Informe o código completo, com o país.

Complete com “{lang=en-GB§be}”.
{type=clue§{lang=pt-PT§você}, afirmativo}

Seções

Um exercício pode ter várias seções numeradas, por exemplo a frase a completar e, ao lado, a tradução dela para orientar o aluno. {#2§…} coloca um texto na seção 2. Em um arquivo de exercícios, a coluna section da linha _ diz em que seção ficam a pergunta e a resposta.

{#1§I gave up.}{#2§lang=pt-BR§Eu desisti.}

Pronúncia

ipa=…§ impõe a pronúncia do texto que ele precede, no Alfabeto Fonético Internacional, quando a síntese de voz erra. Ele transcreve só esse texto, nunca a frase em volta.

{?1§ipa=ˈrɛd§{read}}
ipa=ˈsʌmθɪŋ§ sth

Escrever um caractere especial

O acento grave torna literal o caractere seguinte: `{, `}, `|, `§, e `` para o próprio acento grave. Ele também serve nos arquivos CSV, para uma célula que começa com ~, + ou - sem ser um comando (`+18).

Sem mensagens de erro

O Parrot Markup nunca é recusado: uma chave a mais ou a menos, um atributo desconhecido, nada bloqueia a importação. É prático, mas um erro de digitação passa despercebido.

Depois de uma importação, faça alguns exercícios no app: é a melhor verificação.

Resumo

EscritaSentido
a|b, {a|b}alternativas
{palavra |}palavra opcional
{?1§} / {?1§resposta}lacuna na pergunta / resposta esperada
{?1§{a|b}}lacuna com várias respostas
{type=affix§.}exibido, nunca avaliado
{type=clue§…}dica entre parênteses
{type=context§…}contexto que desfaz uma ambiguidade
{lang=pt-PT§…}fragmento em outro idioma
{#2§…}seção 2
ipa=…§textopronúncia imposta
`{, `|, `§, ``caractere especial literal