日本語
ツールキット
datamodels-toolkit は、オープンソースのコマンドラインツールと GitHub Action です。コマンドの名前は datamodels です。次のことができます。
- 自分のデータモデルを、自分のサイト(ノード)で変わらない URL で公開します。サイトには
catalog.json、@context、JSON Schema、語彙、例、型と属性ごとの説明のページがそろいます。例は models.gtt-project.org(Redmine の GTT プラグインのモデル)です。 - CSV の一覧を、このカタログのモデルのエンティティに変換します。
自分のサイトが要るかどうかは、自分のデータモデルで確かめてください。
実行する
Node.js 24 以降が要ります。コマンドは npx で GitHub のリリースから実行するので、インストールは要りません。
bash
npx github:geolonia/datamodels-toolkit#v0.3.3 --helpこのセクションの例は、このリリースを使います。すべてのコマンドとオプションは、--help と README(英語)にあります。このセクションでは、作業ごとに使い方を説明します。
ページ
自分のサイトを公開する
- サイトを始める:
initでノードを作り、GitHub Pages と自分のドメインで公開します。 - モデルを足す:
addとextendでモデルを足し、属性を書きます。 - 検査とビルド:
checkとbuild、公開する GitHub Action です。 - バージョン:公開したモデルを
bumpで変え、upgradeで新しいツールキットに移ります。
データを扱う
- 一覧を変換する:
convertで、CSV の一覧をモデルのエンティティに変換します。
参照
- データモデルのサイト:datamodels.jp が知っているノードと、そのモデルの一覧です。