Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở
  • Có gì không ổn?
#3 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
72/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
python
Lĩnh vực
documentation, testing

Hướng nghiên cứu

Bắt đầu với các bài kiểm thử hiện có của writer, validator và CLI, sau đó sử dụng danh sách construct dạng LD trong issue này để xây dựng trường hợp round-trip và kiểm tra iter_problems(). Cập nhật docs/en/guides/lift-export-interop.md với ví dụ về phạm vi semantic-domain có tên, đồng thời dùng docs/en/guides/build-export.md làm cơ sở cho tài liệu tham chiếu về ánh xạ trường. Được xem là hoàn tất khi các giá trị vẫn tồn tại qua build, save và reload, quá trình validation không có lỗi, và cả hai chủ đề xuất LD đều được ghi lại.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.
Ngôn ngữ chính
Python
Star
1
Fork
0
Merge trung bình
11 ngày 8 giờ
Pull request đã merge (30 ngày)
3

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của sillsdev/python-sil-lift

Tất cả issue của sillsdev/python-sil-lift

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.