Super Parrot Documentation

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

Codes de langue

Types de fichiers

TypeDossierEn-tête (obligatoires en gras)
Dictionnaireracine, un seulattribute;locale;value
Catégoriescategories/reference;parent;locale;category;selectable;optional;description
Étiquettestags/reference;parent;locale;tag;selectable;optional;description
Abréviationsabbreviations/reference;locale;abbreviation;categories
Patternspatterns/reference;locale;name;prefix;suffix
Vocabulairevocabulary/type;reference;locale;text;context;translation_context;ipa;register;frequency;level;categories;tags;pattern;illustration
Sens apparentésrelations/meaning;meaning_locale;type;target;target_locale;rank
Exercicesexercises/topic;item;attribute;section;index;locale;value
Courslessons/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

AttributValeur
titletitre, une ligne par langue
referenceréférence lisible et stable
author, organizationauteurs (une ligne chacun), organisation
typeDICTIONARY (défaut) ou WORKBOOK (avec un cours)
versionversion du contenu
modelearning (défaut) ou exam ; avec exam_order (selection, random) et exam_correction (immediate, end)
speech_localevoix qui lit une langue sans voix système (co → it-IT)
spoken_abbreviation, spoken_abbreviation_textprononciation d'une abréviation (qqch: kɛlkə ʃoz, qqch: quelque chose)

Vocabulaire

ColonneLigne meaningLigne word
referenceré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é
illustrationimage 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

AttributSérie (_)ItemRô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

AttributChapitre (_)LeçonValeur
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.

ÉcritureEffet
{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§qqchimpose 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)

Mises à jour

ModeComportement
Créationdepuis la liste des dictionnaires ; le fichier Dictionnaire est obligatoire
Complémentles fichiers ajoutent et modifient ; une case vide ne change rien ; rien n'est archivé
Version complèteles fichiers décrivent tout : une case vide efface, ce qui manque est archivé (et se restaure)
Incorporationles 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.