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
| Texto | Uso comum |
|---|---|
Exercícios (value das perguntas, respostas, propostas) | lacunas, afixos, dicas, alternativas |
| Enunciados e títulos | uma palavra citada em outro idioma: {lang=pt-PT§ser} |
Palavras do vocabulário (text) | grafias aceitas: colour|color |
translation_context | um contexto por idioma: {lang=pt§veículo}{lang=en§vehicle} |
Patterns (prefix, suffix) | pronúncia imposta: ipa=ˈsʌmθɪŋ§ sth |
Cinco caracteres especiais
| Caractere | Funçã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.
| Escrita | Respostas aceitas |
|---|---|
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: 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é}.
| Atributo | Efeito |
|---|---|
?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 | |
|---|---|
| Pergunta | Yesterday 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.
- Só existem as chaves
lang,section,input,type,ipaeref; qualquer outra (lnag=,part=1) é ignorada e o texto perde a estrutura. typesó aceita valores conhecidos (affix,clue,context…); os outros são ignorados.- Maiúsculas e minúsculas contam:
lang=fr-FR, nãoLANG=FR-fr.
Depois de uma importação, faça alguns exercícios no app: é a melhor verificação.
Resumo
| Escrita | Sentido |
|---|---|
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=…§texto | pronúncia imposta |
`{, `|, `§, `` | caractere especial literal |