ligarb 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c88870d66d05c780d5dd46b93ebad2f0daffa3ce201d8a51b6cec8c61eedcb73
-  data.tar.gz: 3044c7b204c390fe1ed67f187598d50164e27d917e82dae9897878c0d418f334
+  metadata.gz: ab265966761408e494e47dbc0e00d188d86d99d881be30d5055af5d2abe29ef0
+  data.tar.gz: ecca92d4ca8f601b2c24be43694b92b5f56b37e1787f3c84540e37f2d111551f
 SHA512:
-  metadata.gz: 8f1f24fa71f51560116db5ee1390701988e2640ed17dd4680124aad7c1f59ae82d9f513379ed38de3f8b187874399c41322f6649ea588b205e50ae760087bc62
-  data.tar.gz: 927eb04a33dcc3b24525a5899a412f852d2a0f872c6422b0034d881ed67ba27c0151b602e01d42ebf7900324ad3f4d9392d6b7843abc9ac472d9e707466b618c
+  metadata.gz: 9c9be72721b4753bcd00ac2bd5125bc7e4c5361f8c4773ca0c7183a4a0ca5ae80a663d82ac231a0e5b64d70e79f16f7af9de3367a857207d840cb7cf4f5efb6a
+  data.tar.gz: 70a5189e3b2758b9a1c145ec34502a6402ec7b72f79454f7ed1bf56cfc0881d38a9f56fffbb7b5d96259b0e18151a5cf2dcaf4649ea97f1bb6ff0f49e0636c7d

data/assets/style.css

@@ -670,6 +670,34 @@ mark.search-highlight {
   text-decoration: underline;
 }
 
+/* === AI Generated Notice === */
+.ai-badge {
+  display: inline-block;
+  font-size: 0.7rem;
+  font-weight: 600;
+  color: #ca8a04;
+  background: #fefce8;
+  border: 1px solid #facc15;
+  border-radius: 3px;
+  padding: 0.1rem 0.4rem;
+  margin-top: 0.3rem;
+  letter-spacing: 0.03em;
+}
+
+[data-theme="dark"] .ai-badge {
+  color: #fbbf24;
+  background: #2e2a1a;
+  border-color: #854d0e;
+}
+
+.chapter-footer {
+  margin-top: 2rem;
+  padding: 0.5rem 0.75rem;
+  font-size: 0.8rem;
+  color: var(--color-text-muted);
+  border-top: 1px solid var(--color-border);
+}
+
 /* === Print === */
 @media print {
   .sidebar,

data/lib/ligarb/asset_manager.rb

@@ -22,7 +22,7 @@ module Ligarb
         },
       },
       katex: {
-        fence_pattern: /class="math-block"/,
+        fence_pattern: /class="math-(block|inline)"/,
         files: {
           "js/katex.min.js" => "https://cdn.jsdelivr.net/npm/katex@0.16/dist/katex.min.js",
           "css/katex.min.css" => "https://cdn.jsdelivr.net/npm/katex@0.16/dist/katex.min.css",

data/lib/ligarb/builder.rb

@@ -16,6 +16,7 @@ module Ligarb
       structure = load_structure
 
       all_chapters = collect_all_chapters(structure)
+      resolve_cross_references(all_chapters)
       assign_relative_paths(all_chapters) if @config.repository
 
       assets = AssetManager.new(@config.output_path)
@@ -106,6 +107,22 @@ module Ligarb
       end
     end
 
+    def resolve_cross_references(all_chapters)
+      chapter_map = {}
+      all_chapters.each do |ch|
+        abs_path = File.expand_path(ch.instance_variable_get(:@path))
+        chapter_map[abs_path] = {
+          slug: ch.slug,
+          chapter: ch,
+          headings: ch.headings.each_with_object({}) { |h, map| map[h.id] = h }
+        }
+      end
+
+      all_chapters.each do |ch|
+        ch.resolve_cross_references!(chapter_map)
+      end
+    end
+
     def assign_relative_paths(chapters)
       git_root = find_git_root(@config.base_dir)
       chapters.each do |ch|

data/lib/ligarb/chapter.rb

@@ -5,6 +5,8 @@ require "kramdown-parser-gfm"
 
 module Ligarb
   class Chapter
+    class CrossReferenceError < StandardError; end
+
     attr_reader :title, :slug, :html, :headings, :number, :appendix_letter, :index_entries
     attr_accessor :part_title, :cover, :relative_path
 
@@ -43,6 +45,44 @@ module Ligarb
       @cover
     end
 
+    def self.generate_id(text)
+      text.downcase
+          .gsub(/[^\p{L}\p{N}\s_-]/u, "")
+          .strip
+          .gsub(/\s+/, "-")
+    end
+
+    def resolve_cross_references!(chapter_map)
+      source_dir = File.dirname(@path)
+
+      @html = @html.gsub(%r{<a\s+href="((?!https?://)[^"]+\.md)(?:#([^"]*))?">(.*?)</a>}m) do
+        href_path = $1
+        fragment = $2
+        link_text = $3
+
+        target_path = File.expand_path(href_path, source_dir)
+        entry = chapter_map[target_path]
+        unless entry
+          raise CrossReferenceError, "cross-reference target not found: #{href_path} (from #{File.basename(@path)})"
+        end
+
+        if fragment && !fragment.empty?
+          normalized = self.class.generate_id(fragment)
+          heading = entry[:headings][normalized]
+          unless heading
+            raise CrossReferenceError, "cross-reference heading not found: #{href_path}##{fragment} (from #{File.basename(@path)})"
+          end
+          anchor = "#{entry[:slug]}--#{heading.id}"
+          text = link_text.empty? ? heading.display_text : link_text
+        else
+          anchor = entry[:slug]
+          text = link_text.empty? ? entry[:chapter].display_title : link_text
+        end
+
+        %(<a href="##{anchor}">#{text}</a>)
+      end
+    end
+
     def display_title
       if @appendix_letter
         "#{@appendix_letter}. #{@title}"
@@ -61,6 +101,7 @@ module Ligarb
       @html = rewrite_image_paths(doc.to_html)
       @html = apply_heading_ids(@html)
       @html = convert_special_code_blocks(@html)
+      @html = convert_inline_math(@html)
       @html = convert_admonitions(@html)
       @html = scope_footnote_ids(@html)
       @index_entries = []
@@ -96,10 +137,7 @@ module Ligarb
     end
 
     def generate_id(text)
-      text.downcase
-          .gsub(/[^\p{L}\p{N}\s_-]/u, "") # keep letters (any script), digits, spaces, _, -
-          .strip
-          .gsub(/\s+/, "-")
+      self.class.generate_id(text)
     end
 
     def apply_heading_ids(html)
@@ -135,6 +173,24 @@ module Ligarb
       end
     end
 
+    def convert_inline_math(html)
+      # Protect <pre>...</pre> and <code>...</code> from conversion
+      placeholders = []
+      protected = html.gsub(%r{<(pre|code)([ >])(.*?)</\1>}m) do
+        placeholders << $&
+        "\x00PROTECT#{placeholders.size - 1}\x00"
+      end
+
+      # Convert $...$ to inline math (exclude $$, and $ followed/preceded by space)
+      result = protected.gsub(/(?<!\$)\$(?!\$)(?!\s)(.+?)(?<!\s)(?<!\$)\$(?!\$)/m) do
+        raw = decode_entities($1)
+        %(<span class="math-inline" data-math="#{encode_attr(raw)}"></span>)
+      end
+
+      # Restore protected parts
+      result.gsub(/\x00PROTECT(\d+)\x00/) { placeholders[$1.to_i] }
+    end
+
     def decode_entities(text)
       text.gsub("&amp;", "&").gsub("&lt;", "<").gsub("&gt;", ">").gsub("&quot;", '"').gsub("&#39;", "'")
     end

data/lib/ligarb/cli.rb

@@ -17,6 +17,16 @@ module Ligarb
         Builder.new(config_path).build
       when "init"
         Initializer.new(args.first).run
+      when "write"
+        if args.delete("--init")
+          require_relative "writer"
+          Writer.init_brief(args.first)
+        else
+          brief_path = args.reject { |a| a.start_with?("--") }.first || "brief.yml"
+          no_build = args.include?("--no-build")
+          require_relative "writer"
+          Writer.new(brief_path, no_build: no_build).run
+        end
       when "--help", "-h", nil
         print_usage
       when "help"
@@ -37,6 +47,8 @@ module Ligarb
         Usage:
           ligarb init [DIRECTORY]  Create a new book project
           ligarb build [CONFIG]    Build the HTML book (default CONFIG: book.yml)
+          ligarb write [BRIEF]         Generate a book with AI from brief.yml
+          ligarb write --init [DIR]    Create DIR/brief.yml template
           ligarb help              Show detailed specification (for AI integration)
           ligarb version          Show version number
 
@@ -53,6 +65,8 @@ module Ligarb
           chapter_numbers  (optional) Show chapter/section numbers (default: true)
           style            (optional) Custom CSS file path (default: none)
           repository       (optional) GitHub repository URL for "Edit on GitHub" links
+          ai_generated     (optional) Mark as AI-generated (badge + meta tags, default: false)
+          footer           (optional) Custom text at bottom of each chapter
 
         Example:
           ligarb build
@@ -60,8 +74,8 @@ module Ligarb
       USAGE
     end
 
-    def print_spec
-      puts <<~SPEC
+    def spec_text
+      <<~SPEC
         ligarb - Generate a single-page HTML book from Markdown files
 
         Version: #{VERSION}
@@ -117,6 +131,14 @@ module Ligarb
                          When set, each chapter shows a "View on GitHub" link.
                          The link points to {repository}/blob/HEAD/{path-from-git-root}.
                          The chapter path is resolved relative to the Git repository root.
+        ai_generated:    (optional) Mark the book as AI-generated content. Default: false.
+                         When true: adds an "AI Generated" badge in the sidebar header,
+                         adds a default disclaimer footer to each chapter, and adds
+                         noindex/noai meta tags to prevent search indexing and AI training.
+                         The footer text can be overridden with the 'footer' field.
+        footer:          (optional) Custom text displayed at the bottom of each chapter.
+                         Overrides the default ai_generated disclaimer if both are set.
+                         Useful for copyright notices, disclaimers, or other per-chapter text.
         chapters:        (required) Book structure. An array that can contain:
                          - A cover: a centered title/landing page
                          - A string: a chapter Markdown file path (relative to book.yml)
@@ -262,6 +284,17 @@ module Ligarb
             E = mc^2
             ```
 
+        Inline math uses $...$ syntax within text:
+
+            The equation $E = mc^2$ is well-known.
+
+        Rules for inline math:
+        - $$ is not matched (use ```math for display math)
+        - $ followed by a space is not matched (e.g. $10)
+        - $ preceded by a space is not matched
+        - Content inside <code> and <pre> is not affected
+        - The content is rendered with KaTeX (displayMode: false)
+
         == Images ==
 
         Place image files in the 'images/' directory next to book.yml.
@@ -374,12 +407,74 @@ module Ligarb
         - CAUTION: red (stop)
         - IMPORTANT: purple (exclamation)
 
+        == Cross-References ==
+
+        Link to other chapters or headings using standard Markdown relative links.
+        ligarb resolves .md file references to internal anchors in the single-page
+        output.
+
+        Syntax:
+
+            [link text](other-chapter.md)            Link to a chapter
+            [link text](other-chapter.md#Heading)    Link to a specific heading
+            [](other-chapter.md)                     Auto-fill with chapter title
+            [](other-chapter.md#Heading)             Auto-fill with heading text
+
+        The .md path is resolved relative to the current Markdown file's directory.
+        The heading fragment is matched against heading IDs (case-insensitive,
+        normalized the same way heading slugs are generated).
+
+        When the link text is empty, ligarb fills it with the target's display text:
+        - Chapter link: the chapter's display title (e.g. "3. Config Guide")
+        - Heading link: the heading's display text (e.g. "3.2 Setup")
+
+        If a referenced chapter or heading does not exist, the build fails with an
+        error message indicating the broken reference and its source file.
+
+        External URLs ending in .md (e.g. https://example.com/README.md) are not
+        affected — only relative paths are resolved.
+
         == Previous/Next Navigation ==
 
         Each chapter displays Previous and Next navigation links at the bottom.
         These follow the flat chapter order (including across parts and appendix).
-        Part title pages do not show navigation.
+        Cover pages do not show navigation.
+
+        == Write Command ==
+
+        ligarb write [BRIEF]        Generate a complete book using AI (Claude).
+                                    BRIEF defaults to 'brief.yml' in the current directory.
+                                    Reads the brief, sends a prompt to Claude, and builds
+                                    the generated book. Files are created in the same
+                                    directory as brief.yml.
+
+        ligarb write --init [DIR]   Create a brief.yml template.
+                                    If DIR is given, creates DIR/brief.yml (mkdir as needed).
+                                    If omitted, creates brief.yml in the current directory.
+
+        ligarb write --no-build     Generate files only, skip the build step.
+
+        brief.yml fields:
+
+        title:           (required) The book title.
+        language:        (optional) Language. Default: "ja".
+        audience:        (optional) Target audience (used in the prompt).
+        notes:           (optional) Additional instructions for Claude (free text).
+        author:          (optional) Passed through to book.yml.
+        output_dir:      (optional) Passed through to book.yml.
+        chapter_numbers: (optional) Passed through to book.yml.
+        style:           (optional) Passed through to book.yml.
+        repository:      (optional) Passed through to book.yml.
+
+        The book is generated in the directory containing brief.yml.
+        Example: 'ligarb write ruby_book/brief.yml' creates files in ruby_book/.
+
+        Requires the 'claude' CLI to be installed.
       SPEC
     end
+
+    def print_spec
+      puts spec_text
+    end
   end
 end

data/lib/ligarb/config.rb

@@ -13,7 +13,8 @@ module Ligarb
     # children: array of StructEntry (for :part and :appendix_group)
 
     attr_reader :title, :author, :language, :output_dir, :base_dir,
-                :chapter_numbers, :structure, :style, :repository
+                :chapter_numbers, :structure, :style, :repository,
+                :ai_generated, :footer
 
     def initialize(path)
       @base_dir = File.dirname(File.expand_path(path))
@@ -28,6 +29,8 @@ module Ligarb
       @chapter_numbers = data.fetch("chapter_numbers", true)
       @style           = data.fetch("style", nil)
       @repository      = data.fetch("repository", nil)
+      @ai_generated    = data.fetch("ai_generated", false)
+      @footer          = data.fetch("footer", nil)
       @structure       = parse_structure(data["chapters"])
     end
 
@@ -43,6 +46,17 @@ module Ligarb
       @language == "ja" ? "付録" : "Appendix"
     end
 
+    def effective_footer
+      return @footer if @footer
+      return nil unless @ai_generated
+
+      if @language == "ja"
+        "この章の内容は AI によって生成されました。正確性は保証されません。"
+      else
+        "This chapter was generated by AI. Accuracy is not guaranteed."
+      end
+    end
+
     # Returns a flat list of all chapter file paths (excluding part title pages)
     def chapter_paths
       collect_chapter_paths(@structure)

data/lib/ligarb/template.rb

@@ -31,6 +31,8 @@ module Ligarb
       b.local_variable_set(:assets, assets)
       b.local_variable_set(:repository, config.repository)
       b.local_variable_set(:appendix_label, config.appendix_label)
+      b.local_variable_set(:ai_generated, config.ai_generated)
+      b.local_variable_set(:footer, config.effective_footer)
       b.local_variable_set(:index_tree, build_index_tree(index_entries, chapters))
 
       ERB.new(template, trim_mode: "-").result(b)

data/lib/ligarb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ligarb
-  VERSION = "0.2.0"
+  VERSION = "0.4.0"
 end

data/lib/ligarb/writer.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+require "yaml"
+require "fileutils"
+
+module Ligarb
+  class Writer
+    BRIEF_FIELDS_FOR_BOOK_YML = %w[author output_dir chapter_numbers style repository].freeze
+
+    def initialize(brief_path, no_build: false)
+      @brief_path = File.expand_path(brief_path)
+      @no_build = no_build
+    end
+
+    def run
+      check_claude_installed!
+      brief = load_brief
+      output_dir = output_dir_for(brief)
+      book_yml_path = File.join(output_dir, "book.yml")
+
+      if File.exist?(book_yml_path)
+        $stderr.puts "Error: #{book_yml_path} already exists. Remove it first to regenerate."
+        exit 1
+      end
+
+      FileUtils.mkdir_p(output_dir)
+      prompt = build_prompt(brief, output_dir)
+      run_claude(prompt)
+
+      unless File.exist?(book_yml_path)
+        $stderr.puts "Error: Claude did not generate book.yml in #{output_dir}"
+        exit 1
+      end
+
+      puts "Book files generated in #{output_dir}"
+
+      unless @no_build
+        puts "Building..."
+        require_relative "builder"
+        Builder.new(book_yml_path).build
+      end
+    end
+
+    def self.init_brief(directory = nil)
+      dir = directory || "."
+      target = File.expand_path(dir)
+      path = File.join(target, "brief.yml")
+
+      if File.exist?(path)
+        $stderr.puts "Error: #{path} already exists."
+        exit 1
+      end
+
+      FileUtils.mkdir_p(target)
+
+      File.write(path, <<~YAML)
+        # brief.yml - Book brief for ligarb write
+        title: "My Book"
+        language: ja
+        audience: ""
+        notes: |
+          5章くらいで。
+      YAML
+
+      claude_md = File.join(target, "CLAUDE.md")
+      created_claude_md = false
+      unless File.exist?(claude_md)
+        File.write(claude_md, <<~MD)
+          # ligarb book project
+
+          This is a book project using [ligarb](https://github.com/ko1/ligarb).
+
+          ## Commands
+
+          - `ligarb build` — Build the book (generates build/index.html)
+          - `ligarb help` — Show full specification (Markdown syntax, config options, etc.)
+
+          ## Key rules
+
+          - All chapter files are Markdown (.md), listed in book.yml
+          - The first h1 in each file is the chapter title
+          - Use ```mermaid, ```math, admonitions (> [!NOTE]), etc. as needed
+          - Run `ligarb build` after changes to verify the output
+        MD
+        created_claude_md = true
+      end
+
+      puts "Created #{path}"
+      puts "Created #{claude_md}" if created_claude_md
+      brief_arg = directory ? " #{path}" : ""
+      puts "Edit brief.yml, then run 'ligarb write#{brief_arg}' to generate the book."
+    end
+
+    private
+
+    def check_claude_installed!
+      unless system("claude", "--version", out: File::NULL, err: File::NULL)
+        $stderr.puts "Error: 'claude' command not found. Install Claude Code first."
+        exit 1
+      end
+    end
+
+    def load_brief
+      unless File.exist?(@brief_path)
+        $stderr.puts "Error: #{@brief_path} not found."
+        exit 1
+      end
+
+      brief = YAML.safe_load_file(@brief_path)
+      unless brief.is_a?(Hash) && brief["title"] && !brief["title"].empty?
+        $stderr.puts "Error: 'title' is required in #{@brief_path}."
+        exit 1
+      end
+
+      brief
+    end
+
+    def output_dir_for(_brief)
+      File.dirname(@brief_path)
+    end
+
+    def build_prompt(brief, output_dir)
+      abs_output_dir = File.expand_path(output_dir)
+      spec = CLI.spec_text
+
+      lines = []
+      lines << "You are writing a book using the ligarb tool."
+      lines << ""
+      lines << "<ligarb-spec>"
+      lines << spec
+      lines << "</ligarb-spec>"
+      lines << ""
+      lines << "Write a complete book based on this brief:"
+      lines << "- Title: #{brief["title"]}"
+      lines << "- Language: #{brief["language"] || "ja"}"
+      lines << "- Target audience: #{brief["audience"]}" if brief["audience"] && !brief["audience"].empty?
+
+      if brief["notes"] && !brief["notes"].strip.empty?
+        lines << ""
+        lines << "Additional instructions:"
+        lines << brief["notes"].strip
+      end
+
+      book_yml_fields = BRIEF_FIELDS_FOR_BOOK_YML.select { |k| brief.key?(k) }
+      if book_yml_fields.any?
+        settings = book_yml_fields.map { |k| "#{k}: #{brief[k].inspect}" }.join(", ")
+        lines << ""
+        lines << "In book.yml, set: #{settings}"
+      end
+
+      lines << ""
+      lines << "Create all files in: #{abs_output_dir}"
+      lines << "In book.yml, always set: ai_generated: true"
+      lines << "Create book.yml first, then each chapter .md file."
+      lines << "Include a cover page for books with 4+ chapters."
+      lines << "Each chapter: substantive content with multiple ## sections."
+      lines << "Use code blocks, admonitions, mermaid diagrams where appropriate."
+      lines << "Chapter filenames: 01-topic.md, 02-topic.md, etc."
+
+      lines.join("\n")
+    end
+
+    def run_claude(prompt)
+      tools = "Write,Bash,WebFetch,WebSearch"
+      allowed = "Write,Bash(mkdir:*),Bash(ls:*),Bash(ligarb:*),WebFetch,WebSearch"
+      cmd = ["claude", "-p", "--verbose", prompt, "--tools", tools, "--allowedTools", allowed]
+      unless system(*cmd)
+        $stderr.puts "Error: Claude process failed."
+        exit 1
+      end
+    end
+  end
+end

data/templates/book.html.erb

@@ -4,6 +4,10 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title><%= title %></title>
+<%- if ai_generated -%>
+<meta name="robots" content="noindex, nofollow, noarchive">
+<meta name="robots" content="noai, noimageai">
+<%- end -%>
 <style>
 <%= css %>
 </style>
@@ -35,6 +39,9 @@
     <%- unless author.empty? -%>
     <p class="book-author"><%= author %></p>
     <%- end -%>
+    <%- if ai_generated -%>
+    <span class="ai-badge"><%= language == 'ja' ? 'AI 生成' : 'AI Generated' %></span>
+    <%- end -%>
   </div>
   <div class="search-box">
     <input type="text" id="toc-search" placeholder="Search..." autocomplete="off">
@@ -123,7 +130,10 @@
       <a href="<%= repository.chomp('/') %>/blob/HEAD/<%= chapter.relative_path %>" target="_blank" rel="noopener">View on GitHub</a>
     </div>
     <%- end -%>
-    <%- unless chapter.part_title? || chapter.cover? -%>
+    <%- if footer && !chapter.part_title? && !chapter.cover? -%>
+    <div class="chapter-footer"><%= footer %></div>
+    <%- end -%>
+    <%- unless chapter.cover? -%>
     <nav class="chapter-nav">
       <%- if idx > 0 -%>
       <a href="#" class="nav-prev" onclick="showChapter('<%= chapters[idx-1].slug %>'); return false;">&larr; <%= chapters[idx-1].display_title %></a>
@@ -211,6 +221,12 @@
           catch(e) { el.textContent = el.getAttribute('data-math'); }
         }
       });
+      section.querySelectorAll('.math-inline[data-math]').forEach(function(el) {
+        if (el.childNodes.length === 0) {
+          try { katex.render(el.getAttribute('data-math'), el, {displayMode: false, throwOnError: false}); }
+          catch(e) { el.textContent = el.getAttribute('data-math'); }
+        }
+      });
     }
   }
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ligarb
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - ligarb contributors
@@ -82,6 +82,7 @@ files:
 - lib/ligarb/initializer.rb
 - lib/ligarb/template.rb
 - lib/ligarb/version.rb
+- lib/ligarb/writer.rb
 - templates/book.html.erb
 homepage: https://github.com/ligarb/ligarb
 licenses: