ButirNilai
NamaDESCRIPTION (BIND dokumen spesifikasi DESCRIPTION)
TAG ID0x0A6L
Codec ID0x00000A60
Dokumen spesifikasi0x00000000/codecs/0x00000A60/ (target DECLARE 0A60)
Bagian5 0101 (Edge pernyataan), offset dalam bagian C = 6
KindEdge · keluarga: pernyataan, kelompok: penunjukan dan nama
TAG WORD0000 1010 0110 LLLL (000K KKKC CCCC LLLL)
Deskripsi indeksMenghubungkan deskripsi (description) bahasa Subject. Layout sama dengan LABEL
Sisi Hugoedge/description.md

Bidang (dokumen spesifikasi)

Urutan FIELD dalam dokumen adalah urutan bidang Payload (dokumen spesifikasi Codec). Edge Id milik Edge tidak dideklarasikan sebagai FIELD.

UrutanBidang (BIND)FIELDLebarBentuk yang diterima (CODEC)ENUM
1subject#2recordrecord apa saja (kecuali penanda slot)
2object#3record0780 UTF8-LANGUAGE-TEXT, 0790 UTF8-LANGUAGE-TEXT, 0050 LOCAL

DESCRIPTION adalah Edge pernyataan yang menghubungkan satu deskripsi objek Subject dalam bahasa tertentu sebagai Object. Codec 0x0A6L.

Deskripsi adalah frasa pendek yang membedakan objek (description Wikidata, contoh: “ibu kota dan kota terbesar Jerman”). Ini bukan definisi atau klaim tentang objek. Proposisi tentang objek ditulis dengan TRIPLE. Layout sama dengan LABEL. Deskripsi dan bahasanya dimuat dalam satu Object, yaitu UTF8-LANGUAGE-TEXT. Tidak ada bidang nilai mentah.

Layout

TAG WORD          0000 1010 0110 LLLL
[Length extension TAG]
Edge Id           record LOCAL Reference
Subject           1 record Reference
Object            1 Value UTF8-LANGUAGE-TEXT atau record LOCAL Reference

Interpretasi dan validitas

  • Aturan Subject dan Object sama dengan LABEL. Subject adalah tepat satu record Reference yang lengkap. Object adalah tepat satu record UTF8-LANGUAGE-TEXT (0x078L·0x079L) yang lengkap, atau LOCAL Reference yang terselesaikan menjadi UTF8-LANGUAGE-TEXT lewat binding REFERENCE-NODE dalam dokumen yang sama.
  • Teks tanpa bahasa (UTF8-TEXT) tidak dapat menjadi DESCRIPTION. Deskripsi satu per bahasa, sehingga aturan itu hanya berlaku jika ada bahasa. Deskripsi yang sama untuk banyak bahasa ditulis dengan bahasa mul.
  • DESCRIPTION untuk Subject dan bahasa yang sama paling banyak satu.
  • Deskripsi dipakai untuk membedakan dari objek lain yang bernama sama. Sebaiknya pasangan LABEL dan DESCRIPTION dalam bahasa yang sama tidak tumpang tindih pada dua objek, tetapi spesifikasi tidak memeriksanya (Wikidata pun hanya menganjurkan, tidak memaksa).
  • Dokumen spesifikasi geul.org membatasi Object dengan CODEC (0780·0790·0050, sama dengan LABEL).

Panjang

total = 1 + N_len + N_id + N_subject + N_object WORD
  • Record bahasa dan jumlah byte teks pada Object ditangani oleh record Object. Kursor setelah membaca record terakhir harus tepat sama dengan akhir Edge.
  • Deskripsi lebih panjang daripada label, sehingga Object maupun Edge mudah melebihi 15 WORD. Dalam hal itu dipakai Length extension (record).

Contoh (non-normatif)

Edge Id 0009, Subject Q64 (0141 0040), Object capital and largest city of Germany (en). Bahasa adalah contoh bentuk LANGUAGE-BCP47-CODE (en punya nomor registri 0x0784, sehingga dapat juga dipakai sebagai SHORT-CODE).

  • Object terdiri dari bahasa 0761 656E (BCP47 en, 2 WORD) + teks 35 byte (ganjil, 18 WORD), sehingga 0x079L, TAG 1 + extension TAG 1 + 20 = 22 WORD, 079E 0016 ….
  • Edge adalah TAG 1 + extension TAG 1 + Edge Id 2 + Subject 2 + Object 22 = 28 WORD sehingga LLLL=1110, TAG 0A6E, extension TAG 001C.
0A6E 001C 0051 0009 0141 0040
079E 0016 0761 656E 6361 7069 7461 6C20 616E 6420 6C61 7267 6573 7420 6369 7479 206F 6620 4765 726D 616E 7900

Padanan Wikidata

  • descriptions item (satu per bahasa) → satu DESCRIPTION per bahasa. Kode bahasa dialihkan dengan tabel padanan kode bahasa yang sama dengan LABEL.

Masalah terbuka

  • Apakah ada kasus yang perlu mengizinkan deskripsi UTF8-TEXT tanpa bahasa (saat ini tidak diizinkan).

Halaman terkait

Teks asli dokumen spesifikasi

Tampilan dokumen spesifikasi 0x00000000/codecs/0x00000A60/latest.geul yang dibaca dengan geul show (heksadesimal huruf besar).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000A6000000000
BODY
#1 DECLARE 0x0A60
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "DESCRIPTION"
#5 BIND #2 "subject"
#6 BIND #3 "object"
#7 CODEC #3 0x0780
#8 CODEC #3 0x0790
#9 CODEC #3 0x0050