Super Parrot Documentazione

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

Codici di lingua

Tipi di file

TipoCartellaIntestazione (obbligatorie in grassetto)
Dizionarioradice, uno soloattribute;locale;value
Categoriecategories/reference;parent;locale;category;selectable;optional;description
Etichettetags/reference;parent;locale;tag;selectable;optional;description
Abbreviazioniabbreviations/reference;locale;abbreviation;categories
Patternpatterns/reference;locale;name;prefix;suffix
Vocabolariovocabulary/type;reference;locale;text;context;translation_context;ipa;register;frequency;level;categories;tags;pattern;illustration
Sensi collegatirelations/meaning;meaning_locale;type;target;target_locale;rank
Eserciziexercises/topic;item;attribute;section;index;locale;value
Corsolessons/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

AttributoValore
titletitolo, una riga per lingua
referenceriferimento leggibile e stabile
author, organizationautori (una riga ciascuno), organizzazione
typeDICTIONARY (predefinito) o WORKBOOK (con un corso)
versionversione del contenuto
modelearning (predefinito) o exam; con exam_order (selection, random) ed exam_correction (immediate, end)
speech_localevoce che legge una lingua senza voce di sistema (co → it-IT)
spoken_abbreviation, spoken_abbreviation_textpronuncia di un'abbreviazione (sth: ˈsʌmθɪŋ, sth: something)

Vocabolario

ColonnaRiga meaningRiga word
referenceriferimento 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
illustrationimmagine 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

AttributoSerie (_)ItemRuolo
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

AttributoCapitolo (_)LezioneValore
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.

ScritturaEffetto
{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θɪŋ§sthimpone 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)

Aggiornamenti

ModalitàComportamento
Creazionedall'elenco dei dizionari; il file Dizionario è obbligatorio
Complementoi file aggiungono e modificano; una cella vuota non cambia nulla; nulla viene archiviato
Versione completai file descrivono tutto: una cella vuota cancella, ciò che manca viene archiviato (e si può ripristinare)
Incorporazionei 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.