概要
README.md のサンプル JSON-LD 3 箇所で dbp:dbpaDateTimeFormat(T が大文字)が使われて
いますが、この語彙は本リポジトリのどの正本にも定義されていません。正式なプロパティ名は
dbp:dbpaDatetimeFormat(t が小文字)です。
該当箇所
| ファイル |
行 |
現状 |
あるべき表記 |
README.md |
100 |
"dbp:dbpaDateTimeFormat": "%Y-%m-%dT%H:%M:%S", |
"dbp:dbpaDatetimeFormat" |
README.md |
299 |
同上 |
同上 |
README.md |
316 |
同上 |
同上 |
根拠(正本側の定義)
正本はいずれも 小文字 t で定義しています:
dbp-schema.jsonld:1615 — "@id": "dbp:dbpaDatetimeFormat" / "rdfs:label": "dbpaDatetimeFormat"
dbp-schema.ja.jsonld:1262 — "@id": "dbp:dbpaDatetimeFormat"
dbp_schema.proto:254 — optional string dbpaDatetimeFormat = 70;
dbp_schema.proto:553 — optional string dbpaDatetimeFormat = 50;(DataFieldType)
dbp_schema.sql:367 — dbpaDatetimeFormat VARCHAR(256)
dbp_schema.pb.go:1884 — DbpaDatetimeFormat ... json:"dbpaDatetimeFormat,omitempty"
つまり README のサンプルだけが正本と食い違っている状態です。
⚠️ 注意:一括置換しないでください
同じ接頭辞を持つ 別プロパティ 3 つは大文字 T が正式名 で、正本側でもそのように
定義されています。sed s/dbpaDateTimeFormat/dbpaDatetimeFormat/g のような一括置換を行うと
これらまで壊れます。
| プロパティ |
正式表記 |
定義箇所 |
dbp:dbpaDateTimeFormatOffset |
大文字 T のまま |
dbp-schema.jsonld:1271, dbp_schema.proto:257 |
dbp:dbpaDateTimeFormatUtcIsUTCinRFC3339 |
大文字 T のまま |
dbp-schema.jsonld:1274, dbp_schema.proto:258 |
dbp:dbpaDateTimeFormatUtcIsZinRFC3339 |
大文字 T のまま |
dbp-schema.jsonld:1277, dbp_schema.proto:259 |
修正対象は 裸の dbp:dbpaDateTimeFormat のみ です(README の 3 箇所とも裸の形なので、
いずれも修正対象に該当します)。
なお dbp:dbpaDatetimePrecision / dbp:dbpaDatetimeDiffBytes は既に小文字 t で統一
されており、対応は不要です。
背景
exdata-inc/semantipack#11 で「利用側リポジトリの dbp:dbpaDateTimeFormat を正式名に直す」
作業を進めており、その調査過程で正本と README の不一致を発見したため報告します。
利用側(dbp-dbpa-compressor / semantipack-web)の修正 PR は別途対応中です。
サンプルは実装者がコピペする参照元になりやすく、誤った表記が伝播する原因になり得るため、
README 側の訂正をご検討ください。
概要
README.mdのサンプル JSON-LD 3 箇所でdbp:dbpaDateTimeFormat(Tが大文字)が使われていますが、この語彙は本リポジトリのどの正本にも定義されていません。正式なプロパティ名は
dbp:dbpaDatetimeFormat(tが小文字)です。該当箇所
README.md"dbp:dbpaDateTimeFormat": "%Y-%m-%dT%H:%M:%S","dbp:dbpaDatetimeFormat"README.mdREADME.md根拠(正本側の定義)
正本はいずれも 小文字
tで定義しています:dbp-schema.jsonld:1615—"@id": "dbp:dbpaDatetimeFormat"/"rdfs:label": "dbpaDatetimeFormat"dbp-schema.ja.jsonld:1262—"@id": "dbp:dbpaDatetimeFormat"dbp_schema.proto:254—optional string dbpaDatetimeFormat = 70;dbp_schema.proto:553—optional string dbpaDatetimeFormat = 50;(DataFieldType)dbp_schema.sql:367—dbpaDatetimeFormat VARCHAR(256)dbp_schema.pb.go:1884—DbpaDatetimeFormat ... json:"dbpaDatetimeFormat,omitempty"つまり README のサンプルだけが正本と食い違っている状態です。
同じ接頭辞を持つ 別プロパティ 3 つは大文字
Tが正式名 で、正本側でもそのように定義されています。
sed s/dbpaDateTimeFormat/dbpaDatetimeFormat/gのような一括置換を行うとこれらまで壊れます。
dbp:dbpaDateTimeFormatOffsetTのままdbp-schema.jsonld:1271,dbp_schema.proto:257dbp:dbpaDateTimeFormatUtcIsUTCinRFC3339Tのままdbp-schema.jsonld:1274,dbp_schema.proto:258dbp:dbpaDateTimeFormatUtcIsZinRFC3339Tのままdbp-schema.jsonld:1277,dbp_schema.proto:259修正対象は 裸の
dbp:dbpaDateTimeFormatのみ です(README の 3 箇所とも裸の形なので、いずれも修正対象に該当します)。
なお
dbp:dbpaDatetimePrecision/dbp:dbpaDatetimeDiffBytesは既に小文字tで統一されており、対応は不要です。
背景
exdata-inc/semantipack#11 で「利用側リポジトリの
dbp:dbpaDateTimeFormatを正式名に直す」作業を進めており、その調査過程で正本と README の不一致を発見したため報告します。
利用側(
dbp-dbpa-compressor/semantipack-web)の修正 PR は別途対応中です。サンプルは実装者がコピペする参照元になりやすく、誤った表記が伝播する原因になり得るため、
README 側の訂正をご検討ください。