Super Parrot Documentação

Referência dos arquivos CSV

A referência dos arquivos de importação, tipo por tipo. Para uma primeira abordagem, comece por Criar um dicionário e pelo exemplo dela.

Regras comuns

Códigos de idioma

Tipos de arquivo

TipoPastaCabeçalho (obrigatórias em negrito)
Dicionárioraiz, um sóattribute;locale;value
Categoriascategories/reference;parent;locale;category;selectable;optional;description
Etiquetastags/reference;parent;locale;tag;selectable;optional;description
Abreviaturasabbreviations/reference;locale;abbreviation;categories
Patternspatterns/reference;locale;name;prefix;suffix
Vocabuláriovocabulary/type;reference;locale;text;context;translation_context;ipa;register;frequency;level;categories;tags;pattern;illustration
Sentidos relacionadosrelations/meaning;meaning_locale;type;target;target_locale;rank
Exercíciosexercises/topic;item;attribute;section;index;locale;value
Cursolessons/chapter;lesson;attribute;locale;value

As exportações acrescentam uma coluna (ou um atributo) id: o identificador interno, que reencontra o objeto sem ambiguidade na reimportação. Não o copie ao duplicar uma linha para criar um objeto parecido.

Cada arquivo é autossuficiente para o seu tipo: um ramo completo de uma árvore, um sentido com todas as suas palavras, uma série com todos os seus itens, um capítulo com todas as suas lições.

Dicionário

AtributoValor
titletítulo, uma linha por idioma
referencereferência legível e estável
author, organizationautores (uma linha cada), organização
typeDICTIONARY (padrão) ou WORKBOOK (com um curso)
versionversão do conteúdo
modelearning (padrão) ou exam; com exam_order (selection, random) e exam_correction (immediate, end)
speech_localevoz que lê um idioma sem voz do sistema (co → it-IT)
spoken_abbreviation, spoken_abbreviation_textpronúncia de uma abreviatura (sth: ˈsʌmθɪŋ, sth: something)

Vocabulário

ColunaLinha meaningLinha word
referencereferência do sentido, opcional (senão m1, m2…)opcional
locale—idioma da palavra, com o país
text—a palavra pura, ou a frase
context—contexto principal, no idioma da palavra
translation_context—contexto de tradução, no idioma da pessoa perguntada: pt§veículo
ipa—transcrição AFI
register, frequency, level—uma categoria das famílias registre, frequence, niveau
categories, tags, pattern—por referência (recomendado) ou nome
illustrationimagem do sentido (caminho em resources/)—

Os sinônimos são palavras do mesmo sentido. Os vínculos entre sentidos diferentes (plural, antônimo, derivado) vão em relations/, com os tipos INFLECTION, OPPOSITE e DERIVED.

Exercícios

AtributoSérie (_)ItemFunção
title✓título, uma linha por idioma
wording✓✓enunciado; em um item, substitui o da série
example✓exemplo exibido
question✓✓série: seção e idioma da pergunta; item: a pergunta em si
answer✓✓série: seção e idioma da resposta; item: uma resposta aceita por linha
proposal✓✓propostas para tocar, uma por linha
language✓idioma da resposta quando difere do da série
categories, tags✓✓para os filtros

Curso

AtributoCapítulo (_)LiçãoValor
title✓✓título, uma linha por idioma (opcional para uma lição: o título da ficha dela)
order✓✓posição; obrigatória para o primeiro capítulo de cada arquivo quando há vários
note✓caminho de uma ficha (.md ou .html); uma linha por idioma para as versões de uma mesma ficha
exercise✓uma série, pela referência ou pelo título
vocabulary✓um sentido: sua referência, ou uma palavra com seu idioma (bill [at a restaurant])

Textos: Parrot Markup

As células de texto aceitam uma marcação leve entre chaves, o Parrot Markup; o texto simples continua sendo o caso comum. O essencial abaixo; tudo está em Parrot Markup.

EscritaEfeito
{the|}, {colour|color}alternativas: todas são aceitas
{?1§}uma lacuna a preencher (n.º 1) na pergunta
{?1§bought}a resposta esperada para a lacuna n.º 1
{type=affix§.}exibido mas nunca avaliado (pontuação, artigo)
{type=clue§past tense}uma dica, exibida entre parênteses
{#1§lang=fr-FR§Il a abandonné.}uma seção em outro idioma (uma tradução que orienta)
ipa=ˈsʌmθɪŋ§sthimpõe a pronúncia
`{`o acento grave escapa um caractere especial

Fichas de curso em Markdown

---
lang: fr-FR
---
# Título da ficha

**1** Um parágrafo, com um *termo* que dá para ouvir e um pouco de **negrito**.

> *Je voudrais un café, s'il vous plaît.*
> Eu queria um café, por favor.

## Um subtítulo

| forma | sentido |
|---|---|
| *l'addition* | a conta |

- uma lista
- veja a lição (§2.1)

Atualizações

ModoComportamento
Criaçãoa partir da lista de dicionários; o arquivo Dicionário é obrigatório
Complementoos arquivos adicionam e modificam; uma célula vazia não muda nada; nada é arquivado
Versão completaos arquivos descrevem tudo: uma célula vazia apaga, o que falta é arquivado (e pode ser restaurado)
Incorporaçãoos arquivos são despejados em outro dicionário; as palavras em comum são associadas; em caso de conflito, o dicionário de destino prevalece

Um objeto é encontrado pelo identificador, depois pela referência escrita, depois pelo conteúdo (um sentido pelas palavras inalteradas, uma palavra corrigida pela semelhança). Por isso as referências continuam opcionais.