複数の Markdown ファイルから、単一ページの HTML 本を生成する CLI ツールです。Web サーバー不要の index.html が 1 つできあがります。

マニュアル（ligarb 自身で作った実際の出力例）

• Markdown ファイル群 → 単一 index.html（Web サーバー不要、外部依存なしで開ける）
• cover / 章 / part / appendix による構造化と、章・節の自動ナンバリング
• 検索可能な目次サイドバー（h1〜h3）、章ごとの表示切り替え、パーマリンク、相互参照
• コードハイライト・図表・数式・関数グラフを自動検出してダウンロード （highlight.js / mermaid / KaTeX / function-plot）
• mermaid 図はビルド時に構文チェック（誤りを file:line で警告）
• 脚注（kramdown 記法、章ごとにスコープ）、Note / Tip / Warning などの admonition
• 参考文献（BibTeX）、画像の取り込み、View on GitHub リンク
• ダークモード、カスタム CSS、レスポンシブ & 印刷対応（ページ番号付き）
• 多言語対応（翻訳ハブ + 言語切り替え UI）

• ligarb serve のライブプレビュー（保存して ligarb build でブラウザ更新、Linux は inotify で即検知）
• 本文を選択 → コメント → Claude（Opus）がレビュー → diff を確認 → Approve でソースに適用＆リビルド（履歴は .ligarb/reviews/ に保存）
• ligarb write で AI に本を丸ごと執筆させる（企画書 brief.yml から生成）
• ligarb setup-github-review で GitHub Pages 公開 + 読者フィードバック（Report as issue）+ Claude 連携の足場を生成
• ligarb help は AI に読ませる前提の仕様書を兼ねる

gem install ligarb

ligarb init my-book   # book.yml と雛形 Markdown を生成
cd my-book
ligarb build          # build/index.html を生成

book.yml で構成を編集します:

title: "My Book"
author: "Author Name"
language: "ja"
repository: "https://github.com/user/repo"   # 任意（View on GitHub リンク用）
chapters:
  - cover: cover.md          # 表紙
  - part: part1.md           # パート
    chapters:
      - 01-introduction.md
      - 02-getting-started.md
  - appendix:                # 付録
    - a1-references.md

chapters の要素は cover / 章（文字列）/ part / appendix の 4 種類です。設定キーの一覧は ligarb help を参照してください。

注意: ligarb serve はローカル開発専用です。インターネットへの公開には使わないでください。

ligarb serve              # http://localhost:3000 で配信
ligarb serve --port 8080  # ポート指定

• 起動時に自動ビルド。ソースを編集して ligarb build するとブラウザに更新ボタンが出ます（Linux では inotify で即検知）。
• 本文を選択して「Comment」でコメントすると、Claude（Opus）がレビューし、変更を提案します。「Show patch」で diff を確認、「Approve」でソースに適用＆リビルド。
• レビュー履歴は .ligarb/reviews/ に JSON で保存されます。

レビュー機能は内部で Claude Code の claude -p を呼び出すため、その CLI が必要です。

注意: AI 生成物には誤りが含まれることがあります。公開前に必ず内容を確認・校正してください。

ligarb write --init ruby_book    # ruby_book/brief.yml を生成
vi ruby_book/brief.yml           # 企画を編集
ligarb write ruby_book/brief.yml # 本を生成してビルド

brief.yml（企画書）の例:

title: "Ruby入門"
language: ja
audience: "プログラミング初心者"
notes: |
  5章くらいで。コード例を多めにしてください。

ligarb write は内部で Claude Code の claude -p を呼び出すため、その CLI が必要です。手動で使う場合は ligarb help の出力（AI 向け仕様書を兼ねる）を AI に読ませると、仕様に従った本を生成できます。

ligarb setup-github-review を実行すると、本を GitHub Pages で公開し、読者からフィードバックを受け取るための足場を既存プロジェクトに追加します。

cd my-book
ligarb setup-github-review   # .github/ + SETUP.md + SETUP.sh + README.md を生成

生成されるもの:

• GitHub Pages 公開 — push でビルド & 公開、PR でビルド検証（いずれも Claude 非依存）
• 読者フィードバック — 構造化された Issue テンプレートと、本文中の「Report as issue」UI（完全に静的。book.yml に github_review.enabled: true がある場合に注入）
• Claude 連携（オプトイン） — 読者の Issue を Claude が確認して PR やコメントを返す／PR コメントに応答する

生成ファイルは上書きされます（book.yml と既存 README.md は保持）。トークン登録やリポジトリ設定など手作業が必要な手順は、生成される SETUP.md を参照してください（bash SETUP.sh で一括設定できます）。

ligarb は、著者自身が作成・確認した Markdown をローカルでビルドすることを前提としています。信頼できない第三者のコンテンツを処理する用途には設計されていません。

ラテン語の ligāre（束ねる・綴じる）から。

MIT