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
- Codificação UTF-8 (um BOM no início, como o Excel escreve, é tolerado).
- Separador
; ou tabulação, detectado na linha de cabeçalho. A vírgula separa os valores múltiplos dentro
de uma célula (noun, fem).
- Aspas: uma célula que contém o separador, aspas ou uma quebra de linha fica entre
", e aspas internas
são duplicadas. As planilhas fazem isso sozinhas.
- Cabeçalho obrigatório, nomes de coluna exatos, ordem livre. Uma coluna obrigatória ausente ou uma coluna desconhecida
invalida o arquivo: um erro de digitação nunca se perde em silêncio.
- Linhas ignoradas: as vazias, ou aquelas cuja primeira célula começa com
#.
- Booleanos:
x = sim, vazio = não.
- Apagar um valor em uma atualização como complemento: uma célula que contém só
~.
- Modificar uma lista como complemento:
+Viagem adiciona, -Comércio remove.
Códigos de idioma
- Nomes (títulos, categorias, etiquetas, abreviaturas): código simples
pt, en, fr; um código
regional só quando ele diz algo.
- Palavras e exercícios: o idioma com o país quando o dicionário os distingue (
pt-BR, pt-PT,
en-GB, en-US).
Tipos de arquivo
| Tipo | Pasta | Cabeçalho (obrigatórias em negrito) |
| Dicionário | raiz, um só | attribute;locale;value |
| Categorias | categories/ | reference;parent;locale;category;selectable;optional;description |
| Etiquetas | tags/ | reference;parent;locale;tag;selectable;optional;description |
| Abreviaturas | abbreviations/ | reference;locale;abbreviation;categories |
| Patterns | patterns/ | reference;locale;name;prefix;suffix |
| Vocabulário | vocabulary/ | type;reference;locale;text;context;translation_context;ipa;register;frequency;level;categories;tags;pattern;illustration |
| Sentidos relacionados | relations/ | meaning;meaning_locale;type;target;target_locale;rank |
| Exercícios | exercises/ | topic;item;attribute;section;index;locale;value |
| Curso | lessons/ | 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
| Atributo | Valor |
title | título, uma linha por idioma |
reference | referência legível e estável |
author, organization | autores (uma linha cada), organização |
type | DICTIONARY (padrão) ou WORKBOOK (com um curso) |
version | versão do conteúdo |
mode | learning (padrão) ou exam; com exam_order
(selection, random) e exam_correction (immediate, end) |
speech_locale | voz que lê um idioma sem voz do sistema (co → it-IT) |
spoken_abbreviation, spoken_abbreviation_text | pronúncia de uma abreviatura
(sth: ˈsʌmθɪŋ, sth: something) |
Vocabulário
| Coluna | Linha meaning | Linha word |
| reference | referê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 |
| illustration | imagem 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
| Atributo | Série (_) | Item | Funçã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
| Atributo | Capítulo (_) | Lição | Valor |
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.
| Escrita | Efeito |
{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θɪŋ§sth | impõ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)
- O cabeçalho
lang declara o idioma do material: os termos em *itálico* passam a poder ser ouvidos.
*[en-US] sidewalk* marca uma variante regional; *schedule /ˈʃɛdjuːl/* acrescenta uma pronúncia.
- Uma citação
> = um exemplo e sua tradução; uma frase por citação.
(§8.3) remete à lição 3 do capítulo 8 e vira um link no app.
- Também são aceitos: títulos
# e ##, tabelas, listas -, ~~riscado~~,
`código`.
Atualizações
| Modo | Comportamento |
| Criação | a partir da lista de dicionários; o arquivo Dicionário é obrigatório |
| Complemento | os arquivos adicionam e modificam; uma célula vazia não muda nada; nada é arquivado |
| Versão completa | os arquivos descrevem tudo: uma célula vazia apaga, o que falta é arquivado (e pode ser restaurado) |
| Incorporação | os 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.