Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Living Dictionaries support: LD-shaped round-trip test + export docs

Aperta
#3 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
72/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
python

Direzione di ricerca

Inizia con i test esistenti di writer, validator e CLI, poi usa l’elenco delle costruzioni in forma LD presente in questa issue per assemblare il caso di round-trip e verificare iter_problems(). Aggiorna docs/en/guides/lift-export-interop.md con l’esempio denominato di intervallo semantic-domain e usa docs/en/guides/build-export.md come base per il riferimento al mapping dei campi. Il lavoro è completato quando i valori superano build, save e reload, la validazione è pulita ed entrambi gli argomenti dell’esportazione LD sono documentati.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

enhancement

Background

SIL is investigating LIFT export for Living Dictionaries (sillsdev/TheCombine#4332); if it proceeds, python-sil-lift would be the conformance validator, a Python writer for a converter route, and the reference for conformant output. The writer/validator/CLI already cover the constructs involved — this issue adds the two things still missing here: a test proving the LD field model round-trips, and export docs tailored to the LD case.

Tests

  • Full LD-shaped entry round-trip. One entry exercising every construct the LD→LIFT mapping uses, together: a multi-orthography lexical-unit; a Pronunciation with a speaker-label forms entry (The Combine's Speaker: <name> convention) plus media; a Sense with grammatical-info, gloss, definition, an Example + Translation, an illustration (URLRef with a caption label), a semantic-domain-ddp4 trait, and LD-only data carried as <field>/<trait>. Build → save → reload → assert the values survive and iter_problems() is clean. The model already supports all of these, so this is verification, not new code.
  • (Optional, once a real sample is available) add a representative Living Dictionaries export as a corpus fixture (with provenance) and validate it end-to-end.

Docs

  • Semantic-domain representation for LD — in the Producing conformant LIFT guide (docs/en/guides/lift-export-interop.md), document how to emit LD's ~69-key vocabulary as its own named range in .lift-ranges (lossless, self-describing), with a short example.
  • LD → LIFT field-mapping reference — a concise summary (MultiString → <form lang>, audio/speaker labels, sense photos as <illustration>, LD-only fields as <field>/<trait>) so an exporter author has one place to look; can build on the existing Building a LIFT export from scratch example (docs/en/guides/build-export.md).

Non-goals

  • Any LD exporter (would live in Living Dictionaries / a converter, not here).
  • Bundling the DDP4 taxonomy.
Lingua principale
Python
Stelle
1
Fork
0
Merge medio
11g 3h
PR unite (30g)
6

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di sillsdev/python-sil-lift

Tutte le issue di sillsdev/python-sil-lift

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.