Super Parrot Documentación

Referencia de los archivos CSV

La referencia de los archivos de importación, tipo por tipo. Para una primera aproximación, parte mejor de Crear un diccionario y de su ejemplo.

Reglas comunes

Códigos de idioma

Tipos de archivo

TipoCarpetaCabecera (obligatorias en negrita)
Diccionarioraíz, uno soloattribute;locale;value
Categoríascategories/reference;parent;locale;category;selectable;optional;description
Etiquetastags/reference;parent;locale;tag;selectable;optional;description
Abreviaturasabbreviations/reference;locale;abbreviation;categories
Patternspatterns/reference;locale;name;prefix;suffix
Vocabulariovocabulary/type;reference;locale;text;context;translation_context;ipa;register;frequency;level;categories;tags;pattern;illustration
Sentidos relacionadosrelations/meaning;meaning_locale;type;target;target_locale;rank
Ejerciciosexercises/topic;item;attribute;section;index;locale;value
Cursolessons/chapter;lesson;attribute;locale;value

Las exportaciones añaden una columna (o un atributo) id: el identificador interno, que vuelve a encontrar el objeto sin ambigüedad al reimportar. No lo copies cuando dupliques una línea para crear un objeto parecido.

Cada archivo es autosuficiente para su tipo: una rama completa de un árbol, un sentido con todas sus palabras, una serie con todos sus ítems, un capítulo con todas sus lecciones.

Diccionario

AtributoValor
titletítulo, una línea por idioma
referencereferencia legible y estable
author, organizationautores (una línea cada uno), organización
typeDICTIONARY (por defecto) o WORKBOOK (con un curso)
versionversión del contenido
modelearning (por defecto) o exam; con exam_order (selection, random) y exam_correction (immediate, end)
speech_localevoz que lee un idioma sin voz del sistema (co → it-IT)
spoken_abbreviation, spoken_abbreviation_textpronunciación de una abreviatura (sth: ˈsʌmθɪŋ, sth: something)

Vocabulario

ColumnaLínea meaningLínea word
referencereferencia del sentido, opcional (si no, m1, m2…)opcional
locale—idioma de la palabra, con el país
text—la palabra sola, o la frase
context—contexto principal, en el idioma de la palabra
translation_context—contexto de traducción, en el idioma de la persona a la que se pregunta: es§vehículo
ipa—transcripción AFI
register, frequency, level—una categoría de las familias registre, frequence, niveau
categories, tags, pattern—por referencia (recomendado) o nombre
illustrationimagen del sentido (ruta en resources/)—

Los sinónimos son palabras del mismo sentido. Los vínculos entre sentidos distintos (plural, antónimo, derivado) van en relations/, con los tipos INFLECTION, OPPOSITE y DERIVED.

Ejercicios

AtributoSerie (_)ÍtemFunción
title✓título, una línea por idioma
wording✓✓consigna; en un ítem, sustituye la de la serie
example✓ejemplo mostrado
question✓✓serie: sección e idioma de la pregunta; ítem: el enunciado
answer✓✓serie: sección e idioma de la respuesta; ítem: una respuesta admitida por línea
proposal✓✓propuestas para tocar, una por línea
language✓idioma de la respuesta cuando difiere del de la serie
categories, tags✓✓para los filtros

Curso

AtributoCapítulo (_)LecciónValor
title✓✓título, una línea por idioma (opcional para una lección: el título de su ficha)
order✓✓rango; obligatorio para el primer capítulo de cada archivo si hay varios
note✓ruta de una ficha (.md o .html); una línea por idioma para las versiones de una misma ficha
exercise✓una serie, por su referencia o su título
vocabulary✓un sentido: su referencia, o una palabra con su idioma (bill [at a restaurant])

Textos: Parrot Markup

Las celdas de texto aceptan un marcado ligero entre llaves, Parrot Markup; el texto simple sigue siendo el caso habitual. Lo esencial, abajo; todo está en Parrot Markup.

EscrituraEfecto
{the|}, {colour|color}alternativas: todas se aceptan
{?1§}un hueco que rellenar (n.º 1) en la pregunta
{?1§bought}la respuesta esperada para el hueco n.º 1
{type=affix§.}mostrado pero nunca evaluado (puntuación, artículo)
{type=clue§past tense}una pista, mostrada entre paréntesis
{#1§lang=fr-FR§Il a abandonné.}una sección en otro idioma (una traducción que guía)
ipa=ˈsʌmθɪŋ§sthimpone la pronunciación
`{`el acento grave escapa un carácter especial

Fichas de curso en Markdown

---
lang: fr-FR
---
# Título de la ficha

**1** Un párrafo, con un *término* que se puede escuchar y algo de **negrita**.

> *Je voudrais un café, s'il vous plaît.*
> Quisiera un café, por favor.

## Un subtítulo

| forma | sentido |
|---|---|
| *l'addition* | la cuenta |

- una lista
- ver la lección (§2.1)

Actualizaciones

ModoComportamiento
Creacióndesde la lista de diccionarios; el archivo Diccionario es obligatorio
Complementolos archivos añaden y modifican; una celda vacía no cambia nada; no se archiva nada
Versión completalos archivos lo describen todo: una celda vacía borra, lo que falta se archiva (y se puede restaurar)
Incorporaciónlos archivos se vierten en otro diccionario; las palabras comunes se emparejan; el diccionario de destino prevalece en caso de conflicto

Un objeto se encuentra por su identificador, luego por su referencia escrita, luego por su contenido (un sentido por sus palabras sin cambios, una palabra corregida por su parecido). Por eso las referencias siguen siendo opcionales.