Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

オープン
#3 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
72/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
静か
技術スタック
python

調査の方向性

既存の writer、validator、CLI のテストから始め、この issue にある LD 形状の構成要素リストを使ってラウンドトリップのケースを組み立て、iter_problems() を確認します。docs/en/guides/lift-export-interop.md を更新して名前付き semantic-domain 範囲の例を追加し、フィールドマッピングのリファレンスの基礎として docs/en/guides/build-export.md を使用します。完了の条件は、値が build、save、reload を通過して保持され、検証がクリーンで、両方の LD エクスポートトピックが文書化されていることです。

索引モデルが issue の本文から書いたものです。

説明

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.
主要言語
Python
スター
1
フォーク
0
平均マージ
11日 3時間
マージ済み PR(30日)
6

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

sillsdev/python-sil-lift のほかの issue

sillsdev/python-sil-lift の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。