Skip to content

README.md のサンプルで未定義の dbp:dbpaDateTimeFormat が使われている(正式名は dbp:dbpaDatetimeFormat #21

Description

@nagata-yoshiteru

概要

README.md のサンプル JSON-LD 3 箇所で dbp:dbpaDateTimeFormatT が大文字)が使われて
いますが、この語彙は本リポジトリのどの正本にも定義されていません。正式なプロパティ名は
dbp:dbpaDatetimeFormatt が小文字)です。

該当箇所

ファイル 現状 あるべき表記
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:254optional string dbpaDatetimeFormat = 70;
  • dbp_schema.proto:553optional string dbpaDatetimeFormat = 50;DataFieldType
  • dbp_schema.sql:367dbpaDatetimeFormat VARCHAR(256)
  • dbp_schema.pb.go:1884DbpaDatetimeFormat ... 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 側の訂正をご検討ください。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions