プロジェクト概要

このリポジトリは 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 を出力）

カタログ例

``yaml
id: TERM:example-term
desc: |
用語の定義をここに書く。
---
id: REQ:example-requirement
desc: |
必須条件や禁止事項をここに書く。
`
本文での参照例: [[REQ:example-requirement]]`

ライセンス

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