GEUL (General Encoding Unified Language) adalah bahasa buatan sekaligus format biner agar manusia dan AI dapat saling bertukar informasi tanpa ambiguitas.

Dokumen-dokumen ini mendefinisikan tata bahasa GEUL v1. Edisi saat ini adalah draf sebelum publikasi dan dapat berubah. Spesifikasi dirilis di bawah CC0 1.0.

Sekilas

  • Semua data adalah rangkaian WORD 16 bit. Ditulis dalam big endian.
  • Satuan data adalah record. Sebuah record diawali satu TAG WORD, dan TAG WORD itu menyatakan jenis serta panjang record.
  • Record ada empat jenis (Kind).
KindFungsiContoh
ReferenceMenunjuk sebuah objekWikidata Q42, #7 di dalam dokumen ini
ValueMemuat nilai itu sendiritanggal, kuantitas, teks berbahasa
EdgeMengikat record lain untuk menyatakan sesuatu“Q42 adalah manusia”, “Nama Inggris Q42 adalah Douglas Adams”
MetaBerbicara tentang dokumenedisi spesifikasi, ID dokumen, penulis, tanda tangan
  • Record-record dimuat dalam satu dokumen. Seperti HTML, dokumen terbagi menjadi HEAD (Meta, serta SOURCE untuk asal-usul seluruh dokumen beserta QUALIFIER-nya) dan BODY (Reference, Value, Edge).
  • Dokumen diterbitkan oleh Issuer (pihak penerbit), dan setiap versinya dikunci dengan hash isi. Versi yang telah dipublikasikan tidak diubah.

Prinsip desain

  1. Record dapat dilewati tanpa codebook. Jenis dan panjang record ada dalam 16 bit TAG WORD. Decoder yang tidak mengetahui cara menafsirkan (codebook) tetap dapat menghitung dan melewati record.
  2. Yang dimuat adalah pernyataan, bukan fakta. Dokumen mencatat siapa, kapan, dan dari apa pernyataan itu berasal, melalui Meta dan Edge dasar.
  3. Identifikasi dilakukan dengan Reference. Objek ditunjuk dengan ID, bukan nama. Nama dilekatkan melalui Edge.
  4. Yang telah dipublikasikan tidak diubah. Perbaikan diterbitkan sebagai versi baru. ID di dalam dokumen menunjuk objek yang sama lintas versi.
  5. Dibiarkan kosong. Sebagian besar ruang bit disisakan untuk masa depan. Kode langsung tidak dapat ditarik kembali, sehingga hanya yang frekuensinya terbukti yang dialokasikan.

Dokumen turunan

Jika Anda membaca untuk pertama kali, bacalah berurutan dari atas tabel.

DokumenIsi
Struktur recordtata letak TAG WORD, Length, Codec, TAG ekstensi
Issuer dan publikasitingkat Issuer, tabel alokasi 2 WORD, cara publikasi, tanda tangan, kunci verifikasi
Alamat publikasi dan daftar versinotasi ID, alamat publikasi, penentuan format, daftar Issuer, daftar versi, lapisan kepercayaan
Dokumen spesifikasi Codeccodebook yang ditulis dengan DECLARE, FIELD, ENUM, CODEC
Dokumen umumDOC, HEAD, BODY, END, ID dokumen, hash isi, versi dan revisi
Indeks kodeseluruh 227 slot alokasi, tabel Codec per Kind dan keluarga
Tata letak bagian16 bagian dan penempatan slot, rentang alokasi dan Reserved
Penanda slotABSENT, UNKNOWN-VALUE, NO-VALUE, aturan penerimaan
Referenceidentifikasi objek, LOCAL, rujukan eksternal, Quantifier, penanda slot
Valuekeluarga nilai, kode langsung, teks, kuantitas, tanggal
Metastruktur, definisi, asal-usul, silsilah, verifikasi, kebijakan, IMPORT
Edgekeluarga pernyataan, dasar, eksekusi, TOULMIN; TRIPLE, QUALIFIER, LABEL
TOULMINkeluarga graf penilaian dan eksekusi, tata letak NODE, LINK, SOURCE
Contoh: entri Wikidatamembaca satu dokumen per WORD

Yang dapat diketahui tanpa codebook

InformasiTanpa codebookDasar
KindDiketahuirentang bagian w >> 9 pada TAG WORD (Reference 0~2, Value 3·4, Edge 5~13, Meta 14·15)
Panjang total record, posisi record berikutnyaDiketahuiLength pada TAG WORD
Nomor CodecDiketahuiTAG WORD (untuk format Issuer, Issuer dan nomor Codec pada TAG ekstensi)
Keluarga, kelasSebagian diketahuiHanya keluarga kode langsung Edge yang diketahui dari bit. Kode langsung Value, keluarga format Issuer, dan kelas Meta tidak diketahui dari bit. Format Issuer diketahui sampai Issuer dan nomor Codec. Kelas verifikasi Meta diketahui dari C >= 5 (w >= 0x1E50) pada bagian 15
Edge Id milik EdgeDiketahuiKomponen pertama Edge (bagian 5~13) selalu Reference LOCAL
Penanda slot (tidak ditulis, tidak diketahui, tidak ada)DiketahuiNilai WORD 0x0000, 0x0010, 0x0020 (Reference, C < 3, L 0). Penanda slot
QuantifierDiketahuiDari offset C dalam bagian: jika 5 <= C < 30 pada bagian 0, atau C < 30 pada bagian 1, maka C % 5
Panjang TAG per Codec, posisi awal PayloadTidak diketahuicodebook
Tafsir Payload, peran komponen EdgeTidak diketahuicodebook
  • Decoder tanpa codebook dapat melewati record dan menghitungnya per Kind dan Codec, tetapi tidak dapat menelusuri struktur graf.
  • Semua decoder harus menangani kelas struktur, definisi, dan IMPORT pada Meta. Codec-codec ini termasuk codebook inti GEUL, dan decoder mengetahuinya dari tabel nomor bawaan (Meta).

Codebook dipublikasikan sebagai dokumen GEUL (Dokumen spesifikasi Codec). Karena itu decoder cukup mengambil dan membaca dokumen spesifikasi yang diperlukan.

Struktur wilayah

Bit teratas TAG WORD membagi wilayah.

PrefixWilayahProporsiDefinisi
1Masa depan jauh50%Reserved (masa depan jauh). Tidak digunakan
01Masa depan25%Reserved (masa depan dekat). Tidak digunakan
001Standar12.5%Tata bahasa yang secara resmi diadopsi dan dioperasikan
000Bebas·usulan12.5%Tata bahasa saat ini. Jika diadopsi, tata letak dibiarkan dan hanya Prefix dipindah ke 001

Seluruh tata bahasa saat ini berada di wilayah 000. Semua TAG WORD dalam spesifikasi ini diawali 000.

  • Decoder v1 menolak TAG WORD yang Prefix-nya bukan 000. Wilayah lain ditentukan oleh edisi berikutnya.
  • Wilayah 000 adalah ruang usulan. Saat ini tidak berlaku pendaftaran maupun perlindungan.