Référence des fichiers CSV
La référence des fichiers d'import, type par type. Pour une première approche, partez plutôt de
Créer un dictionnaire et de son exemple.
Règles communes
- Encodage UTF-8 (un BOM en tête, comme en écrit Excel, est toléré).
- Séparateur
; ou tabulation, détecté sur la ligne d'en-tête. La virgule sépare les valeurs multiples
à l'intérieur d'une case (noun, fem).
- Guillemets : une case qui contient le séparateur, un guillemet ou un saut de ligne est entourée de
", et un guillemet intérieur est doublé. Les tableurs le font seuls.
- En-tête obligatoire, noms de colonnes exacts, ordre libre. Une colonne obligatoire absente ou une colonne
inconnue rend le fichier invalide : une faute de frappe ne se perd pas en silence.
- Lignes ignorées : vides, ou dont la première case commence par
#.
- Booléens :
x = oui, vide = non.
- Effacer une valeur lors d'une mise à jour en complément : une case qui ne contient que
~.
- Modifier une liste en complément :
+Voyage ajoute, -Commerce retire.
Codes de langue
- Libellés (titres, catégories, étiquettes, abréviations) : code nu
fr, en, pt ; un code
régional seulement s'il dit quelque chose.
- Mots et exercices : la langue avec le pays quand le dictionnaire les distingue (
fr-FR, en-GB,
en-US, pt-BR).
Types de fichiers
| Type | Dossier | En-tête (obligatoires en gras) |
| Dictionnaire | racine, un seul | attribute;locale;value |
| Catégories | categories/ | reference;parent;locale;category;selectable;optional;description |
| Étiquettes | tags/ | reference;parent;locale;tag;selectable;optional;description |
| Abréviations | abbreviations/ | reference;locale;abbreviation;categories |
| Patterns | patterns/ | reference;locale;name;prefix;suffix |
| Vocabulaire | vocabulary/ | type;reference;locale;text;context;translation_context;ipa;register;frequency;level;categories;tags;pattern;illustration |
| Sens apparentés | relations/ | meaning;meaning_locale;type;target;target_locale;rank |
| Exercices | exercises/ | topic;item;attribute;section;index;locale;value |
| Cours | lessons/ | chapter;lesson;attribute;locale;value |
Les exports ajoutent une colonne (ou un attribut) id : l'identifiant interne, qui retrouve l'objet sans ambiguïté lors
d'une réimportation. Ne le recopiez pas quand vous dupliquez une ligne pour créer un objet voisin.
Chaque fichier se suffit à lui-même pour son type : une branche d'arbre complète, un sens avec tous ses mots, une série avec tous ses
items, un chapitre avec toutes ses leçons.
Dictionnaire
| Attribut | Valeur |
title | titre, une ligne par langue |
reference | référence lisible et stable |
author, organization | auteurs (une ligne chacun), organisation |
type | DICTIONARY (défaut) ou WORKBOOK (avec un cours) |
version | version du contenu |
mode | learning (défaut) ou exam ; avec exam_order
(selection, random) et exam_correction (immediate, end) |
speech_locale | voix qui lit une langue sans voix système (co → it-IT) |
spoken_abbreviation, spoken_abbreviation_text | prononciation d'une abréviation
(qqch: kɛlkə ʃoz, qqch: quelque chose) |
Vocabulaire
| Colonne | Ligne meaning | Ligne word |
| reference | référence du sens, facultative (sinon m1, m2…) | facultative |
| locale | — | langue du mot, avec le pays |
| text | — | le mot nu, ou la phrase |
| context | — | contexte principal, dans la langue du mot |
| translation_context | — | contexte de traduction, dans la langue de celui qu'on interroge :
fr§véhicule |
| ipa | — | transcription API |
| register, frequency, level | — | une catégorie des familles registre, frequence,
niveau |
| categories, tags, pattern | — | par référence (recommandé) ou libellé |
| illustration | image du sens (chemin dans resources/) | — |
Les synonymes sont des mots du même sens. Les liens entre sens différents (pluriel, antonyme, dérivé) vont dans
relations/, avec les types INFLECTION, OPPOSITE et DERIVED.
Exercices
| Attribut | Série (_) | Item | Rôle |
title | ✓ | | titre, une ligne par langue |
wording | ✓ | ✓ | consigne ; sur un item, elle remplace celle de la série |
example | ✓ | | exemple affiché |
question | ✓ | ✓ | série : section et langue de la question ; item : l'énoncé |
answer | ✓ | ✓ | série : section et langue de la réponse ; item : une réponse admise par ligne |
proposal | ✓ | ✓ | propositions à toucher, une par ligne |
language | | ✓ | langue de la réponse quand elle diffère de celle de la série |
categories, tags | ✓ | ✓ | pour les filtres |
Cours
| Attribut | Chapitre (_) | Leçon | Valeur |
title | ✓ | ✓ | titre, une ligne par langue (facultatif pour une leçon : le titre de sa fiche) |
order | ✓ | ✓ | rang ; obligatoire pour le premier chapitre de chaque fichier s'il y en a plusieurs |
note | | ✓ | chemin d'une fiche (.md ou .html) ; une ligne par langue
pour les versions d'une même fiche |
exercise | | ✓ | une série, par sa référence ou son titre |
vocabulary | | ✓ | un sens : sa référence, ou un mot avec sa langue (louer [location]) |
Textes : Parrot Markup
Les cases de texte acceptent un balisage léger entre accolades, Parrot Markup ; le texte simple reste le cas courant. L'essentiel ci-dessous ; tout est dans Parrot Markup.
| Écriture | Effet |
{the|}, {colour|color} | alternatives : toutes sont acceptées |
{?1§} | un trou à remplir (n° 1) dans la question |
{?1§bought} | la réponse attendue pour le trou n° 1 |
{type=affix§.} | affiché mais jamais noté (ponctuation, article) |
{type=clue§prétérit} | un indice, affiché entre parenthèses |
{#1§lang=fr-FR§Il a abandonné.} | une section dans une autre langue (une traduction qui guide) |
ipa=kɛlkə ʃoz§qqch | impose la prononciation |
`{` | l'accent grave échappe un caractère spécial |
Fiches de cours en Markdown
---
lang: en-GB
---
# Titre de la fiche
**1** Un paragraphe, avec un *terme* prononçable et du **gras**.
> *I'd like a coffee, please.*
> Je voudrais un café, s'il vous plaît.
## Un intertitre
| forme | sens |
|---|---|
| *go up* | augmenter |
- une liste
- voir la leçon (§2.1)
- L'en-tête
lang déclare la langue du corpus : les termes en *italique* deviennent prononçables.
*[en-US] sidewalk* marque une variante régionale ; *schedule /ˈʃɛdjuːl/* ajoute une prononciation.
- Une citation
> = un exemple et sa traduction ; une phrase par citation.
(§8.3) renvoie à la leçon 3 du chapitre 8, et devient un lien dans l'application.
- Sont aussi acceptés : titres
# et ##, tableaux, listes -, ~~barré~~,
`code`.
Mises à jour
| Mode | Comportement |
| Création | depuis la liste des dictionnaires ; le fichier Dictionnaire est obligatoire |
| Complément | les fichiers ajoutent et modifient ; une case vide ne change rien ; rien n'est archivé |
| Version complète | les fichiers décrivent tout : une case vide efface, ce qui manque est archivé (et se restaure) |
| Incorporation | les fichiers sont versés dans un autre dictionnaire ; les mots communs sont rapprochés ; le dictionnaire
cible l'emporte en cas de conflit |
Un objet est retrouvé par son identifiant, puis par sa référence écrite, puis par son contenu (un sens par ses mots inchangés, un mot
corrigé par sa ressemblance). C'est pourquoi les références restent facultatives.