プロジェクト概要

このリポジトリは tree-to-book のセクション版テンプレートから生成されています。src/sections/ のディレクトリ構造を正本として製本順を決め、dist/BOOK.md を生成します。詳細仕様は docs/SPEC.md を参照してください。

コマンド

• npm install — 依存をインストール
• npm run validate — 構造・参照・deps を検証
• npm run compile — dist/BOOK.md を生成
• npm run create-section -- --parent src/sections --name 0600_new --template sample-basic --title "新章タイトル" — サンプルテンプレートからセクション追加（npx でも可）
  • --parent だけ指定すれば、名前は自動採番、テンプレートは sample-basic、タイトルは "New Section" が既定になります。省略した項目は対話プロンプト（TTY の場合）で入力できます。
• コンテンツカタログ: src/catalog.content.yaml に TERM/REQ を記述し、本文中では [[TERM:...]] / [[REQ:...]] で参照します。参照があるのにカタログが無い、未定義の id を参照、id/desc 形式違反は npm run validate で検出されます。

ディレクトリ

• src/sections/ — 本文セクション（NNNN_slug/index.md）
• src/assets/ — 資産置き場（画像など）
• src/catalog.content.yaml — TERM/REQ カタログ
• docs/ — 仕様・ガイド
• dist/ — 生成物（compile が BOOK.md を出力）

カタログ例

id: TERM:example-term
desc: |
  用語の定義をここに書く。
---
id: REQ:example-requirement
desc: |
  必須条件や禁止事項をここに書く。

本文での参照例: [[REQ:example-requirement]]

ライセンス

このテンプレートは MIT ライセンスです。必要に応じてプロジェクト方針に合わせてください。