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
- Codificación UTF-8 (se tolera un BOM al principio, como lo escribe Excel).
- Separador
; o tabulación, detectado en la línea de cabecera. La coma separa los valores múltiples
dentro de una celda (noun, fem).
- Comillas: una celda que contiene el separador, una comilla o un salto de línea va entre
", y una
comilla interior se duplica. Las hojas de cálculo lo hacen solas.
- Cabecera obligatoria, nombres de columna exactos, orden libre. Una columna obligatoria ausente o una columna
desconocida invalida el archivo: una errata nunca se pierde en silencio.
- Líneas ignoradas: las vacías, o aquellas cuya primera celda empieza por
#.
- Booleanos:
x = sí, vacío = no.
- Borrar un valor en una actualización como complemento: una celda que solo contiene
~.
- Modificar una lista como complemento:
+Viajes añade, -Comercio quita.
Códigos de idioma
- Nombres (títulos, categorías, etiquetas, abreviaturas): código simple
es, en, pt; un código
regional solo si aporta algo.
- Palabras y ejercicios: el idioma con el país cuando el diccionario los distingue (
es-ES, es-MX,
en-GB, pt-BR).
Tipos de archivo
| Tipo | Carpeta | Cabecera (obligatorias en negrita) |
| Diccionario | raíz, uno solo | attribute;locale;value |
| Categorías | categories/ | reference;parent;locale;category;selectable;optional;description |
| Etiquetas | tags/ | reference;parent;locale;tag;selectable;optional;description |
| Abreviaturas | abbreviations/ | reference;locale;abbreviation;categories |
| Patterns | patterns/ | reference;locale;name;prefix;suffix |
| Vocabulario | vocabulary/ | type;reference;locale;text;context;translation_context;ipa;register;frequency;level;categories;tags;pattern;illustration |
| Sentidos relacionados | relations/ | meaning;meaning_locale;type;target;target_locale;rank |
| Ejercicios | exercises/ | topic;item;attribute;section;index;locale;value |
| Curso | lessons/ | 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
| Atributo | Valor |
title | título, una línea por idioma |
reference | referencia legible y estable |
author, organization | autores (una línea cada uno), organización |
type | DICTIONARY (por defecto) o WORKBOOK (con un curso) |
version | versión del contenido |
mode | learning (por defecto) o exam; con exam_order
(selection, random) y exam_correction (immediate, end) |
speech_locale | voz que lee un idioma sin voz del sistema (co → it-IT) |
spoken_abbreviation, spoken_abbreviation_text | pronunciación de una abreviatura
(sth: ˈsʌmθɪŋ, sth: something) |
Vocabulario
| Columna | Línea meaning | Línea word |
| reference | referencia 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 |
| illustration | imagen 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
| Atributo | Serie (_) | Ítem | Funció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
| Atributo | Capítulo (_) | Lección | Valor |
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.
| Escritura | Efecto |
{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θɪŋ§sth | impone 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)
- La cabecera
lang declara el idioma del material: los términos en *cursiva* se pueden escuchar.
*[en-US] sidewalk* marca una variante regional; *schedule /ˈʃɛdjuːl/* añade una pronunciación.
- Una cita
> = un ejemplo y su traducción; una frase por cita.
(§8.3) remite a la lección 3 del capítulo 8 y se convierte en un enlace en la aplicación.
- También se aceptan: títulos
# y ##, tablas, listas -, ~~tachado~~,
`código`.
Actualizaciones
| Modo | Comportamiento |
| Creación | desde la lista de diccionarios; el archivo Diccionario es obligatorio |
| Complemento | los archivos añaden y modifican; una celda vacía no cambia nada; no se archiva nada |
| Versión completa | los archivos lo describen todo: una celda vacía borra, lo que falta se archiva (y se puede restaurar) |
| Incorporación | los 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.