Riferimento dei file CSV
Il riferimento dei file di importazione, tipo per tipo. Per un primo approccio, parti piuttosto da
Creare un dizionario e dal suo esempio.
Regole comuni
- Codifica UTF-8 (un BOM iniziale, come lo scrive Excel, è tollerato).
- Separatore
; o tabulazione, rilevato sulla riga di intestazione. La virgola separa i valori multipli
all'interno di una cella (noun, fem).
- Virgolette: una cella che contiene il separatore, una virgoletta o un a capo è racchiusa tra
", e una
virgoletta interna è raddoppiata. I fogli di calcolo lo fanno da soli.
- Intestazione obbligatoria, nomi di colonna esatti, ordine libero. Una colonna obbligatoria assente o una colonna
sconosciuta rende il file non valido: un errore di battitura non si perde mai in silenzio.
- Righe ignorate: quelle vuote, o quelle la cui prima cella inizia con
#.
- Booleani:
x = sì, vuoto = no.
- Cancellare un valore in un aggiornamento come complemento: una cella che contiene solo
~.
- Modificare un elenco come complemento:
+Viaggi aggiunge, -Commercio toglie.
Codici di lingua
- Nomi (titoli, categorie, etichette, abbreviazioni): codice semplice
it, en, pt; un codice
regionale solo se dice qualcosa.
- Parole ed esercizi: la lingua con il paese quando il dizionario li distingue (
it-IT, it-CH,
en-GB, pt-BR).
Tipi di file
| Tipo | Cartella | Intestazione (obbligatorie in grassetto) |
| Dizionario | radice, uno solo | attribute;locale;value |
| Categorie | categories/ | reference;parent;locale;category;selectable;optional;description |
| Etichette | tags/ | reference;parent;locale;tag;selectable;optional;description |
| Abbreviazioni | abbreviations/ | reference;locale;abbreviation;categories |
| Pattern | patterns/ | reference;locale;name;prefix;suffix |
| Vocabolario | vocabulary/ | type;reference;locale;text;context;translation_context;ipa;register;frequency;level;categories;tags;pattern;illustration |
| Sensi collegati | relations/ | meaning;meaning_locale;type;target;target_locale;rank |
| Esercizi | exercises/ | topic;item;attribute;section;index;locale;value |
| Corso | lessons/ | chapter;lesson;attribute;locale;value |
Le esportazioni aggiungono una colonna (o un attributo) id: l'identificativo interno, che ritrova l'oggetto senza ambiguità
alla reimportazione. Non copiarlo quando duplichi una riga per creare un oggetto simile.
Ogni file è autosufficiente per il suo tipo: un ramo completo di un albero, un senso con tutte le sue parole, una serie con tutti i suoi
item, un capitolo con tutte le sue lezioni.
Dizionario
| Attributo | Valore |
title | titolo, una riga per lingua |
reference | riferimento leggibile e stabile |
author, organization | autori (una riga ciascuno), organizzazione |
type | DICTIONARY (predefinito) o WORKBOOK (con un corso) |
version | versione del contenuto |
mode | learning (predefinito) o exam; con exam_order
(selection, random) ed exam_correction (immediate, end) |
speech_locale | voce che legge una lingua senza voce di sistema (co → it-IT) |
spoken_abbreviation, spoken_abbreviation_text | pronuncia di un'abbreviazione
(sth: ˈsʌmθɪŋ, sth: something) |
Vocabolario
| Colonna | Riga meaning | Riga word |
| reference | riferimento del senso, facoltativo (altrimenti m1, m2…) | facoltativo |
| locale | — | lingua della parola, con il paese |
| text | — | la parola nuda, o la frase |
| context | — | contesto principale, nella lingua della parola |
| translation_context | — | contesto di traduzione, nella lingua della persona interrogata: it§veicolo |
| ipa | — | trascrizione IPA |
| register, frequency, level | — | una categoria delle famiglie registre, frequence,
niveau |
| categories, tags, pattern | — | per riferimento (consigliato) o nome |
| illustration | immagine del senso (percorso in resources/) | — |
I sinonimi sono parole dello stesso senso. I legami tra sensi diversi (plurale, contrario, derivato) vanno in
relations/, con i tipi INFLECTION, OPPOSITE e DERIVED.
Esercizi
| Attributo | Serie (_) | Item | Ruolo |
title | ✓ | | titolo, una riga per lingua |
wording | ✓ | ✓ | consegna; su un item, sostituisce quella della serie |
example | ✓ | | esempio mostrato |
question | ✓ | ✓ | serie: sezione e lingua della domanda; item: l'enunciato |
answer | ✓ | ✓ | serie: sezione e lingua della risposta; item: una risposta ammessa per riga |
proposal | ✓ | ✓ | proposte da toccare, una per riga |
language | | ✓ | lingua della risposta quando differisce da quella della serie |
categories, tags | ✓ | ✓ | per i filtri |
Corso
| Attributo | Capitolo (_) | Lezione | Valore |
title | ✓ | ✓ | titolo, una riga per lingua (facoltativo per una lezione: il titolo della sua scheda) |
order | ✓ | ✓ | posizione; obbligatoria per il primo capitolo di ogni file se ce ne sono più |
note | | ✓ | percorso di una scheda (.md o .html); una riga per lingua per
le versioni della stessa scheda |
exercise | | ✓ | una serie, tramite il suo riferimento o il suo titolo |
vocabulary | | ✓ | un senso: il suo riferimento, o una parola con la sua lingua
(bill [at a restaurant]) |
Testi: Parrot Markup
Le celle di testo accettano un markup leggero tra parentesi graffe, Parrot Markup; il testo semplice resta il caso comune. L'essenziale qui sotto; tutto il resto in Parrot Markup.
| Scrittura | Effetto |
{the|}, {colour|color} | alternative: sono accettate tutte |
{?1§} | uno spazio da riempire (n. 1) nella domanda |
{?1§bought} | la risposta attesa per lo spazio n. 1 |
{type=affix§.} | mostrato ma mai valutato (punteggiatura, articolo) |
{type=clue§past tense} | un indizio, mostrato tra parentesi |
{#1§lang=fr-FR§Il a abandonné.} | una sezione in un'altra lingua (una traduzione che guida) |
ipa=ˈsʌmθɪŋ§sth | impone la pronuncia |
`{` | l'accento grave protegge un carattere speciale |
Schede del corso in Markdown
---
lang: fr-FR
---
# Titolo della scheda
**1** Un paragrafo, con un *termine* da ascoltare e un po' di **grassetto**.
> *Je voudrais un café, s'il vous plaît.*
> Vorrei un caffè, per favore.
## Un sottotitolo
| forma | senso |
|---|---|
| *l'addition* | il conto |
- un elenco
- vedi la lezione (§2.1)
- L'intestazione
lang dichiara la lingua del materiale: i termini in *corsivo* diventano ascoltabili.
*[en-US] sidewalk* segna una variante regionale; *schedule /ˈʃɛdjuːl/* aggiunge una pronuncia.
- Una citazione
> = un esempio e la sua traduzione; una frase per citazione.
(§8.3) rimanda alla lezione 3 del capitolo 8 e diventa un link nell'app.
- Sono accettati anche: titoli
# e ##, tabelle, elenchi -, ~~barrato~~,
`codice`.
Aggiornamenti
| Modalità | Comportamento |
| Creazione | dall'elenco dei dizionari; il file Dizionario è obbligatorio |
| Complemento | i file aggiungono e modificano; una cella vuota non cambia nulla; nulla viene archiviato |
| Versione completa | i file descrivono tutto: una cella vuota cancella, ciò che manca viene archiviato (e si può
ripristinare) |
| Incorporazione | i file vengono versati in un altro dizionario; le parole comuni vengono abbinate; in caso di conflitto
prevale il dizionario di destinazione |
Un oggetto viene ritrovato dal suo identificativo, poi dal suo riferimento scritto, poi dal suo contenuto (un senso dalle sue parole
invariate, una parola corretta dalla somiglianza). Per questo i riferimenti restano facoltativi.