Quick Start

まず短い .tdsl を読み、Playgroundで試し、最後にCLIで保存・検証します。

1. 読む

timeline "読書メモ" {
    title "読書メモ";
    unit year;
    range 2024..2026;
    calendar proleptic_gregorian;
}

lane "本" as books { kind custom; order 10; }

event books 2025 "Timeline DSLを試す" { id "event:first"; };

timeline で年表全体、lane で縦軸、event で出来事を書きます。文法の読み方は 文法とサンプル に短い例をまとめています。

2. Playgroundで試す

このサンプルをPlaygroundで開く

Playground 本体は今後追加予定です。リンクは /playground/?source=... にサンプル本文を渡す将来URLとして用意しています。

3. CLIで保存して検証する

同じ内容を sample.tdsl として保存し、CLIで検証します。

tdsl check sample.tdsl
tdsl lint sample.tdsl

出力が成功すれば、構文と基本的な品質チェックを通過しています。JSONとして確認する場合は build を使います。

tdsl build sample.tdsl --pretty --output sample.json

ブラウザで確認する場合は、スタンドアロンHTMLとして描画します。

tdsl render sample.tdsl --output sample.html

次のステップ

• 文法とサンプル で span、event_range、Wikidata import の制約を確認する
• Commands で用途ごとのCLIを確認する
• CIで検証する で tdsl check と tdsl lint を自動化する