ligarb 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4aa971885dcefac0f440b02705cc3cb0adb88fcbf21c38cc23bed207887f30dc
-  data.tar.gz: 155c53e158b727d4e7c5ef5b012b980e32106e54e737c8c55b4f3953c08caeb2
+  metadata.gz: 9771ee497c353bffb143092dae4b8631c72587e264ca3e6081e614e582de9d1b
+  data.tar.gz: 1def484d79741c7e88d657c485799762e7bf6909cd3bf9a3118aac00ac3cf32f
 SHA512:
-  metadata.gz: a04d10091801975a7029c762a81fed663b685710634a29320b8f6cd0a149297627e1c6fc2d28efd0c69d6fd44576ec5c535764b88fdcd62411ad0ec4f06dae35
-  data.tar.gz: b60a0faef98596347c5c4e6b25b2737a00a47b9998124a562d2d1b918648e1ad46560008e84426cc216d286d6e432d528e14d9f3f1ac3be595cab1463c5fbc54
+  metadata.gz: 8f7902c30dbc242df9605bfc95995a01c6a23729e1c7079811b0ff9e7a7545d534225c3216cce46c6619a073d215a728dd24a1ab6fb2011206887180ed786c03
+  data.tar.gz: 720e0fc0a1433537e956987edc1e2656931b5fb01ceb22dd57ee6b537451ab69c30c34d671ad16c3985f60d5f00ee8ddab4028c8fb4c17527b57b5d8724d70a7

data/assets/serve.js

@@ -58,7 +58,19 @@
           if (typeof hljs !== 'undefined') hljs.highlightAll();
           if (typeof mermaid !== 'undefined') {
             var unrendered = oldMain.querySelectorAll('.mermaid:not([data-processed])');
-            if (unrendered.length > 0) mermaid.run({nodes: unrendered});
+            if (unrendered.length > 0) {
+              var sources = {};
+              unrendered.forEach(function(el) { sources[el.id || el.textContent.slice(0, 50)] = el.textContent; });
+              mermaid.run({nodes: unrendered, suppressErrors: true}).catch(function() {}).finally(function() {
+                unrendered.forEach(function(el) {
+                  if (!el.querySelector('svg')) {
+                    var src = sources[el.id || el.textContent.slice(0, 50)] || el.textContent;
+                    el.innerHTML = '<pre style="color:#c00;border:1px solid #c00;padding:0.5em;white-space:pre-wrap">mermaid エラー:\n' +
+                      src.replace(/</g, '&lt;') + '</pre>';
+                  }
+                });
+              });
+            }
           }
           if (typeof katex !== 'undefined') {
             oldMain.querySelectorAll('.math-block[data-math]').forEach(function(el) {

data/assets/style.css

@@ -161,6 +161,11 @@ body {
   color: var(--color-text-muted);
 }
 
+.toc a.active-section {
+  color: var(--color-accent);
+  font-weight: 600;
+}
+
 .toc-chapter.active > a.toc-h1 {
   border-left-color: var(--color-accent);
   color: var(--color-accent);
@@ -769,6 +774,38 @@ mark.search-highlight {
   border-color: #854d0e;
 }
 
+.lang-switcher {
+  display: flex;
+  gap: 0.3rem;
+  margin-top: 0.4rem;
+  flex-wrap: wrap;
+}
+
+.lang-link {
+  display: inline-block;
+  font-size: 0.7rem;
+  font-weight: 600;
+  padding: 0.15rem 0.4rem;
+  border-radius: 3px;
+  text-decoration: none;
+  border: 1px solid var(--color-border);
+  color: var(--color-accent);
+  background: transparent;
+  transition: background 0.15s, color 0.15s;
+}
+
+.lang-link:hover {
+  background: var(--color-accent);
+  color: #fff;
+}
+
+.lang-link.lang-current {
+  background: var(--color-accent);
+  color: #fff;
+  border-color: var(--color-accent);
+  cursor: default;
+}
+
 .chapter-footer {
   margin-top: 2rem;
   padding: 0.5rem 0.75rem;
@@ -777,6 +814,65 @@ mark.search-highlight {
   border-top: 1px solid var(--color-border);
 }
 
+/* === Full TOC Page === */
+.toc-full {
+  line-height: 1.8;
+}
+
+.toc-full a {
+  color: var(--color-text);
+  text-decoration: none;
+}
+
+.toc-full a:hover {
+  color: var(--color-accent);
+}
+
+.toc-full-part {
+  margin-top: 1.5rem;
+}
+
+.toc-full-part-title {
+  font-weight: 700;
+  font-size: 1.05rem;
+  text-transform: uppercase;
+  letter-spacing: 0.03em;
+}
+
+a.toc-full-part-title {
+  color: var(--color-text);
+  text-decoration: none;
+}
+
+a.toc-full-part-title:hover {
+  color: var(--color-accent);
+}
+
+.toc-full-chapter {
+  margin-top: 0.5rem;
+}
+
+.toc-full-chapter > a {
+  font-weight: 600;
+}
+
+.toc-full ul {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.toc-full-h2 {
+  padding-left: 1.5rem;
+  font-size: 0.92rem;
+}
+
+.toc-full-h3 {
+  padding-left: 3rem;
+  font-size: 0.85rem;
+  color: var(--color-text-muted);
+}
+
 /* === Print === */
 @media print {
   .sidebar,

data/lib/ligarb/builder.rb

@@ -8,11 +8,17 @@ require_relative "asset_manager"
 
 module Ligarb
   class Builder
-    def initialize(config_path)
-      @config = Config.new(config_path)
+    def initialize(config_path, parent_data: nil)
+      @config = Config.new(config_path, parent_data: parent_data)
+      @config_path = File.expand_path(config_path)
     end
 
     def build
+      if @config.translations_hub?
+        build_multilang
+        return
+      end
+
       structure = load_structure
 
       all_chapters = collect_all_chapters(structure)
@@ -49,30 +55,96 @@ module Ligarb
 
     private
 
+    def build_multilang
+      hub_data = @config.instance_variable_get(:@translations_data)
+      hub_base = File.dirname(@config_path)
+      output_dir = hub_data.fetch("output_dir", "build")
+      output_path = File.join(hub_base, output_dir)
+
+      langs = []
+      all_lang_chapters = []
+
+      @config.translations.each do |trans|
+        child_config = Config.new(trans.config_path, parent_data: hub_data)
+        prefix = "#{trans.lang}--"
+        lang_data = build_language_data(trans.lang, child_config, prefix)
+        langs << lang_data
+        all_lang_chapters.concat(lang_data[:chapters])
+      end
+
+      assets = AssetManager.new(output_path)
+      assets.detect(all_lang_chapters)
+      assets.provision!
+
+      html = Template.new.render_multilang(langs: langs, assets: assets,
+                                           hub_data: hub_data)
+
+      FileUtils.mkdir_p(output_path)
+      output_file = File.join(output_path, "index.html")
+      File.write(output_file, html)
+
+      # Copy images from hub base dir
+      images_dir = File.join(hub_base, "images")
+      if Dir.exist?(images_dir)
+        dest = File.join(output_path, "images")
+        FileUtils.mkdir_p(dest)
+        Dir.glob(File.join(images_dir, "*")).each { |img| FileUtils.cp(img, dest) }
+      end
+
+      puts "Built #{output_file}"
+      langs.each { |ld| puts "  #{ld[:lang]}: #{ld[:chapters].size} chapter(s)" }
+    end
+
+    def build_language_data(lang, config, slug_prefix)
+      @config = config
+      structure = load_structure(slug_prefix: slug_prefix)
+      all_chapters = collect_all_chapters(structure)
+      resolve_cross_references(all_chapters)
+      assign_relative_paths(all_chapters) if config.repository
+
+      index_entries = all_chapters.flat_map { |ch|
+        ch.index_entries.map { |e|
+          e.class.new(term: e.term, display_text: e.display_text,
+                      chapter_slug: e.chapter_slug, anchor_id: e.anchor_id)
+        }
+      }
+
+      bibliography = resolve_citations!(all_chapters)
+
+      {
+        lang: lang,
+        config: config,
+        chapters: all_chapters,
+        structure: structure,
+        index_entries: index_entries,
+        bibliography: bibliography,
+      }
+    end
+
     # StructNode mirrors Config::StructEntry but holds loaded Chapter objects
     StructNode = Struct.new(:type, :chapter, :children, keyword_init: true)
 
-    def load_structure
+    def load_structure(slug_prefix: nil)
       chapter_num = 0
       appendix_num = 0
 
       @config.structure.map do |entry|
         case entry.type
         when :cover
-          ch = load_chapter(entry.path)
+          ch = load_chapter(entry.path, slug_prefix: slug_prefix)
           ch.cover = true
           StructNode.new(type: :cover, chapter: ch)
         when :chapter
           chapter_num += 1
-          ch = load_chapter(entry.path)
+          ch = load_chapter(entry.path, slug_prefix: slug_prefix)
           ch.number = chapter_num if @config.chapter_numbers
           StructNode.new(type: :chapter, chapter: ch)
         when :part
-          part_ch = load_chapter(entry.path)
+          part_ch = load_chapter(entry.path, slug_prefix: slug_prefix)
           part_ch.part_title = true
           children = (entry.children || []).map do |child|
             chapter_num += 1
-            ch = load_chapter(child.path)
+            ch = load_chapter(child.path, slug_prefix: slug_prefix)
             ch.number = chapter_num if @config.chapter_numbers
             StructNode.new(type: :chapter, chapter: ch)
           end
@@ -80,7 +152,7 @@ module Ligarb
         when :appendix_group
           children = (entry.children || []).map do |child|
             appendix_num += 1
-            ch = load_chapter(child.path)
+            ch = load_chapter(child.path, slug_prefix: slug_prefix)
             letter = ("A".ord + appendix_num - 1).chr
             ch.appendix_letter = letter if @config.chapter_numbers
             StructNode.new(type: :chapter, chapter: ch)
@@ -90,11 +162,11 @@ module Ligarb
       end
     end
 
-    def load_chapter(path)
+    def load_chapter(path, slug_prefix: nil)
       unless File.exist?(path)
         abort "Error: chapter not found: #{path}"
       end
-      Chapter.new(path, @config.base_dir)
+      Chapter.new(path, @config.base_dir, slug_prefix: slug_prefix)
     end
 
     def collect_all_chapters(structure)

data/lib/ligarb/chapter.rb

@@ -14,7 +14,7 @@ module Ligarb
     IndexEntry = Struct.new(:term, :display_text, :chapter_slug, :anchor_id, keyword_init: true)
     CiteEntry = Struct.new(:key, :display_text, :chapter_slug, :anchor_id, keyword_init: true)
 
-    def initialize(path, base_dir)
+    def initialize(path, base_dir, slug_prefix: nil)
       @path     = path
       @base_dir = base_dir
       @source   = File.read(path)
@@ -24,7 +24,8 @@ module Ligarb
       @cover = false
 
       @relative_path = nil
-      @slug = File.basename(path, ".md").gsub(/[^a-zA-Z0-9_-]/, "-")
+      base_slug = File.basename(path, ".md").gsub(/[^a-zA-Z0-9_-]/, "-")
+      @slug = slug_prefix ? "#{slug_prefix}#{base_slug}" : base_slug
       parse!
     end
 
@@ -191,7 +192,8 @@ module Ligarb
       end
 
       # Convert $...$ to inline math (exclude $$, and $ followed/preceded by space)
-      result = protected.gsub(/(?<!\$)\$(?!\$)(?!\s)(.+?)(?<!\s)(?<!\$)\$(?!\$)/m) do
+      # Inline math must be on a single line (no /m flag) to avoid $200 etc. matching across lines
+      result = protected.gsub(/(?<!\$)\$(?!\$)(?!\s)(.+?)(?<!\s)(?<!\$)\$(?!\$)/) do
         raw = decode_entities($1)
         %(<span class="math-inline" data-math="#{encode_attr(raw)}"></span>)
       end

data/lib/ligarb/cli.rb

@@ -90,6 +90,7 @@ module Ligarb
           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
+          translations     (optional) Map of lang => config path for multi-language builds
 
         Example:
           ligarb build
@@ -194,8 +195,10 @@ module Ligarb
         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.
+        translations:    (optional) A mapping of language codes to config file paths.
+                         Enables multi-language support. See "Translations" section below.
         chapters:        (required) Book structure. An array that can contain:
-                         - A cover: a centered title/landing page
+                         - A cover: the landing page shown when the book is opened
                          - A string: a chapter Markdown file path (relative to book.yml)
                          - A part: groups chapters under a titled section
                          - An appendix: groups chapters with alphabetic numbering (A, B, C, ...)
@@ -204,7 +207,7 @@ module Ligarb
 
         1. Cover (object with 'cover' key):
                chapters:
-                 - cover: cover.md          # Markdown file: displayed as centered title page
+                 - cover: cover.md          # Markdown file: landing page shown when the book is opened
                                             # Not shown in the TOC sidebar.
 
         2. Plain chapter (string):
@@ -658,6 +661,8 @@ module Ligarb
         language:        (optional) Language. Default: "ja".
         audience:        (optional) Target audience (used in the prompt).
         notes:           (optional) Additional instructions for Claude (free text).
+        sources:         (optional) Reference files for AI context. Array of strings
+                         or {path:, label:} objects. Paths relative to brief.yml.
         author:          (optional) Passed through to book.yml.
         output_dir:      (optional) Passed through to book.yml.
         chapter_numbers: (optional) Passed through to book.yml.
@@ -668,6 +673,56 @@ module Ligarb
         Example: 'ligarb write ruby_book/brief.yml' creates files in ruby_book/.
 
         Requires the 'claude' CLI to be installed.
+
+        == Translations (Multi-Language) ==
+
+        ligarb supports building the same book in multiple languages. A parent
+        config file (hub) defines shared settings and points to per-language
+        config files.
+
+        Hub config (book.yml):
+
+            repository: "https://github.com/user/repo"
+            ai_generated: true
+            translations:
+              ja: book.ja.yml
+              en: book.en.yml
+
+        Per-language config (book.ja.yml):
+
+            title: "マニュアル"
+            language: "ja"
+            chapters:
+              - chapters/ja/01-intro.md
+
+        Per-language config (book.en.yml):
+
+            title: "Manual"
+            language: "en"
+            chapters:
+              - chapters/en/01-intro.md
+
+        Building the hub builds all translations:
+
+            ligarb build book.yml        # Builds all languages
+            ligarb build book.ja.yml     # Builds only Japanese (standalone)
+
+        Inheritance rules:
+        - The hub's settings (repository, style, ai_generated, etc.) are
+          inherited by each per-language config as defaults.
+        - Per-language configs can override any inherited setting.
+        - title, language, and chapters are always per-language (required in
+          each per-language config).
+
+        The hub config does not need 'title' or 'chapters' fields — it only
+        needs 'translations'. If the hub has no 'chapters', it is treated
+        purely as a translations hub.
+
+        Language switcher:
+        - When built via the hub, each output HTML includes a language switcher
+          in the sidebar header (e.g. [JA | EN]).
+        - Links use relative paths between output directories.
+        - The current language is highlighted; others are clickable links.
       SPEC
     end
 

data/lib/ligarb/config.rb

@@ -6,20 +6,56 @@ module Ligarb
   class Config
     REQUIRED_KEYS = %w[title chapters].freeze
 
+    # Keys that can be inherited from a parent (translations hub) config.
+    # output_dir is intentionally excluded — it always comes from the
+    # config file that was directly passed to `ligarb build`.
+    INHERITABLE_KEYS = %w[author language chapter_numbers style
+                          repository ai_generated footer bibliography].freeze
+
     # Represents a structural entry in the book
     StructEntry = Struct.new(:type, :path, :children, keyword_init: true)
     # type: :chapter, :part, or :appendix_group
     # path: markdown file path (for :chapter and :part), nil for :appendix_group
     # children: array of StructEntry (for :part and :appendix_group)
 
+    # Represents a translation entry
+    # output_path: absolute path to the translation's build directory (for link generation)
+    TranslationEntry = Struct.new(:lang, :config_path, :title, :language, :output_path, keyword_init: true)
+
     attr_reader :title, :author, :language, :output_dir, :base_dir,
                 :chapter_numbers, :structure, :style, :repository,
-                :ai_generated, :footer, :bibliography, :sources
+                :ai_generated, :footer, :bibliography, :sources,
+                :translations
 
-    def initialize(path)
+    def initialize(path, parent_data: nil)
       @base_dir = File.dirname(File.expand_path(path))
       data = YAML.safe_load_file(path)
 
+      # If this is a translations hub (has translations but no chapters), skip normal validation
+      if data.is_a?(Hash) && data.key?("translations") && !data.key?("chapters")
+        @translations_hub = true
+        @translations_data = data
+        load_translations_hub(data)
+        return
+      end
+
+      # Load inherit file if specified (for standalone builds of child configs)
+      if !parent_data && data.is_a?(Hash) && data.key?("inherit")
+        inherit_path = File.expand_path(data["inherit"], @base_dir)
+        if File.exist?(inherit_path)
+          parent_data = YAML.safe_load_file(inherit_path)
+        else
+          abort "Error: inherit config not found: #{inherit_path}"
+        end
+      end
+
+      # Merge parent (inheritable) keys as defaults
+      if parent_data
+        INHERITABLE_KEYS.each do |key|
+          data[key] = parent_data[key] if parent_data.key?(key) && !data.key?(key)
+        end
+      end
+
       validate!(data)
 
       @title           = data["title"]
@@ -34,6 +70,13 @@ module Ligarb
       @bibliography    = data.fetch("bibliography", nil)
       @sources         = parse_sources(data.fetch("sources", []))
       @structure       = parse_structure(data["chapters"])
+      @translations    = []
+
+      load_translations(data, path) if data.key?("translations")
+    end
+
+    def translations_hub?
+      @translations_hub == true
     end
 
     def output_path
@@ -137,6 +180,66 @@ module Ligarb
       collect_chapter_paths(entries)
     end
 
+    def load_translations(data, config_path)
+      trans = data["translations"]
+      return unless trans.is_a?(Hash)
+
+      trans.each do |lang, rel_path|
+        abs_path = File.expand_path(rel_path, @base_dir)
+        unless File.exist?(abs_path)
+          abort "Error: translation config not found: #{abs_path}"
+        end
+        child_data = YAML.safe_load_file(abs_path)
+        # Merge parent keys for output_dir resolution
+        INHERITABLE_KEYS.each do |key|
+          child_data[key] = data[key] if data.key?(key) && !child_data.key?(key)
+        end
+        child_title = child_data["title"] || @title
+        child_lang = child_data.fetch("language", lang)
+        child_base = File.dirname(abs_path)
+        child_output = File.join(child_base, child_data.fetch("output_dir", "build"))
+        @translations << TranslationEntry.new(
+          lang: lang,
+          config_path: abs_path,
+          title: child_title,
+          language: child_lang,
+          output_path: child_output
+        )
+      end
+    end
+
+    def load_translations_hub(data)
+      @title = data.fetch("title", "")
+      @translations = []
+
+      trans = data["translations"]
+      return unless trans.is_a?(Hash)
+
+      trans.each do |lang, rel_path|
+        abs_path = File.expand_path(rel_path, @base_dir)
+        unless File.exist?(abs_path)
+          abort "Error: translation config not found: #{abs_path}"
+        end
+        child_data = YAML.safe_load_file(abs_path)
+        # Merge inheritable keys from hub as defaults
+        merged = child_data.dup
+        INHERITABLE_KEYS.each do |key|
+          merged[key] = data[key] if data.key?(key) && !merged.key?(key)
+        end
+        child_title = merged["title"] || @title
+        child_lang = merged.fetch("language", lang)
+        child_base = File.dirname(abs_path)
+        child_output = File.join(child_base, merged.fetch("output_dir", "build"))
+        @translations << TranslationEntry.new(
+          lang: lang,
+          config_path: abs_path,
+          title: child_title,
+          language: child_lang,
+          output_path: child_output
+        )
+      end
+    end
+
     def validate!(data)
       unless data.is_a?(Hash)
         abort "Error: book.yml must be a YAML mapping"

data/lib/ligarb/review_store.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "json"
+require "time"
 require "securerandom"
 require "fileutils"
 

data/lib/ligarb/template.rb

@@ -35,6 +35,61 @@ module Ligarb
       b.local_variable_set(:footer, config.effective_footer)
       b.local_variable_set(:index_tree, build_index_tree(index_entries, chapters))
       b.local_variable_set(:bibliography, bibliography)
+      b.local_variable_set(:multilang, false)
+      b.local_variable_set(:langs, [])
+
+      ERB.new(template, trim_mode: "-").result(b)
+    end
+
+    # Render a single HTML with all languages, switchable via JS
+    def render_multilang(langs:, assets:, hub_data:)
+      css = File.read(@css_path)
+      template = File.read(@template_path)
+
+      first = langs.first
+      first_config = first[:config]
+
+      custom_css = if first_config.style_path && File.exist?(first_config.style_path)
+                     File.read(first_config.style_path)
+                   end
+
+      # Build per-language template data
+      lang_data = langs.map do |ld|
+        cfg = ld[:config]
+        {
+          lang: ld[:lang],
+          title: cfg.title,
+          author: cfg.author,
+          language: cfg.language,
+          chapters: ld[:chapters],
+          structure: ld[:structure],
+          repository: cfg.repository,
+          appendix_label: cfg.appendix_label,
+          ai_generated: cfg.ai_generated,
+          footer: cfg.effective_footer,
+          index_tree: build_index_tree(ld[:index_entries], ld[:chapters]),
+          bibliography: ld[:bibliography],
+        }
+      end
+
+      b = binding
+      # Use first language's values as defaults for shared template vars
+      b.local_variable_set(:title, first_config.title)
+      b.local_variable_set(:author, first_config.author)
+      b.local_variable_set(:language, first_config.language)
+      b.local_variable_set(:chapters, first[:chapters])
+      b.local_variable_set(:structure, first[:structure])
+      b.local_variable_set(:css, css)
+      b.local_variable_set(:custom_css, custom_css)
+      b.local_variable_set(:assets, assets)
+      b.local_variable_set(:repository, first_config.repository)
+      b.local_variable_set(:appendix_label, first_config.appendix_label)
+      b.local_variable_set(:ai_generated, first_config.ai_generated)
+      b.local_variable_set(:footer, first_config.effective_footer)
+      b.local_variable_set(:index_tree, build_index_tree(first[:index_entries], first[:chapters]))
+      b.local_variable_set(:bibliography, first[:bibliography])
+      b.local_variable_set(:multilang, true)
+      b.local_variable_set(:langs, lang_data)
 
       ERB.new(template, trim_mode: "-").result(b)
     end

data/lib/ligarb/version.rb

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

data/templates/book.html.erb

@@ -28,34 +28,151 @@
 <div class="sidebar" id="sidebar">
   <div class="sidebar-header">
     <div class="sidebar-header-top">
+<%- if multilang -%>
+  <%- langs.each do |ld| -%>
+      <%- ld_cover = ld[:chapters].find(&:cover?) -%>
+      <%- if ld_cover -%>
+      <h1 class="book-title lang-content" data-lang="<%= ld[:lang] %>"><a href="#<%= ld_cover.slug %>" onclick="showChapter('<%= ld_cover.slug %>'); return false;"><%= h(ld[:title]) %></a></h1>
+      <%- else -%>
+      <h1 class="book-title lang-content" data-lang="<%= ld[:lang] %>"><%= h(ld[:title]) %></h1>
+      <%- end -%>
+  <%- end -%>
+<%- else -%>
       <%- cover_chapter = chapters.find(&:cover?) -%>
       <%- if cover_chapter -%>
       <h1 class="book-title"><a href="#<%= cover_chapter.slug %>" onclick="showChapter('<%= cover_chapter.slug %>'); return false;"><%= h(title) %></a></h1>
       <%- else -%>
       <h1 class="book-title"><%= h(title) %></h1>
       <%- end -%>
+<%- end -%>
       <button class="theme-toggle" id="theme-toggle" aria-label="Toggle dark mode" title="Toggle dark mode">&#9790;</button>
     </div>
+<%- if multilang -%>
+  <%- langs.each do |ld| -%>
+    <%- unless ld[:author].empty? -%>
+    <p class="book-author lang-content" data-lang="<%= ld[:lang] %>"><%= h(ld[:author]) %></p>
+    <%- end -%>
+  <%- end -%>
+<%- else -%>
     <%- unless author.empty? -%>
     <p class="book-author"><%= h(author) %></p>
     <%- end -%>
+<%- end -%>
+<%- if multilang -%>
+  <%- if ai_generated -%>
+    <%- langs.each do |ld| -%>
+    <span class="ai-badge lang-content" data-lang="<%= ld[:lang] %>"><%= ld[:language] == 'ja' ? 'AI 生成' : 'AI Generated' %></span>
+    <%- end -%>
+  <%- end -%>
+<%- else -%>
     <%- if ai_generated -%>
     <span class="ai-badge"><%= language == 'ja' ? 'AI 生成' : 'AI Generated' %></span>
     <%- end -%>
+<%- end -%>
+<%- if multilang -%>
+    <div class="lang-switcher">
+    <%- langs.each do |ld| -%>
+      <button class="lang-link" data-lang="<%= ld[:lang] %>" onclick="switchLang('<%= ld[:lang] %>')"><%= h(ld[:lang].upcase) %></button>
+    <%- end -%>
+    </div>
+<%- end -%>
   </div>
   <div class="search-box">
     <input type="text" id="toc-search" placeholder="Search..." autocomplete="off">
     <button class="search-clear" id="search-clear" type="button" aria-label="Clear search">&times;</button>
   </div>
   <nav class="toc" id="toc">
+<%- if multilang -%>
+  <%- langs.each do |ld| -%>
+    <ul class="lang-content" data-lang="<%= ld[:lang] %>">
+      <li class="toc-chapter" data-chapter="<%= ld[:lang] %>--__toc__">
+        <a href="#<%= ld[:lang] %>--__toc__" class="toc-h1" onclick="showChapter('<%= ld[:lang] %>--__toc__')"><%= ld[:language] == 'ja' ? '目次' : 'Contents' %></a>
+      </li>
+      <%- ld[:structure].each do |node| -%>
+        <%- case node.type -%>
+        <%- when :cover -%>
+        <%- when :chapter -%>
+      <li class="toc-chapter" data-chapter="<%= node.chapter.slug %>">
+        <a href="#<%= node.chapter.slug %>" class="toc-h1" onclick="showChapter('<%= node.chapter.slug %>')"><%= h(node.chapter.display_title) %></a>
+        <%- sub_headings = node.chapter.headings.select { |h| h.level == 2 } -%>
+        <%- unless sub_headings.empty? -%>
+        <ul>
+          <%- sub_headings.each do |heading| -%>
+          <li>
+            <a href="#<%= node.chapter.slug %>--<%= heading.id %>" class="toc-h<%= heading.level %>" onclick="showChapterAndScroll('<%= node.chapter.slug %>', '<%= node.chapter.slug %>--<%= heading.id %>')"><%= h(heading.display_text) %></a>
+          </li>
+          <%- end -%>
+        </ul>
+        <%- end -%>
+      </li>
+        <%- when :part -%>
+      <li class="toc-part">
+        <a href="#<%= node.chapter.slug %>" class="toc-part-title" onclick="showChapter('<%= node.chapter.slug %>')"><%= h(node.chapter.title) %></a>
+        <ul>
+          <%- (node.children || []).each do |child| -%>
+          <li class="toc-chapter" data-chapter="<%= child.chapter.slug %>">
+            <a href="#<%= child.chapter.slug %>" class="toc-h1" onclick="showChapter('<%= child.chapter.slug %>')"><%= h(child.chapter.display_title) %></a>
+            <%- sub_headings = child.chapter.headings.select { |h| h.level == 2 } -%>
+            <%- unless sub_headings.empty? -%>
+            <ul>
+              <%- sub_headings.each do |heading| -%>
+              <li>
+                <a href="#<%= child.chapter.slug %>--<%= heading.id %>" class="toc-h<%= heading.level %>" onclick="showChapterAndScroll('<%= child.chapter.slug %>', '<%= child.chapter.slug %>--<%= heading.id %>')"><%= h(heading.display_text) %></a>
+              </li>
+              <%- end -%>
+            </ul>
+            <%- end -%>
+          </li>
+          <%- end -%>
+        </ul>
+      </li>
+        <%- when :appendix_group -%>
+      <li class="toc-appendix">
+        <span class="toc-appendix-title"><%= h(ld[:appendix_label]) %></span>
+        <ul>
+          <%- (node.children || []).each do |child| -%>
+          <li class="toc-chapter" data-chapter="<%= child.chapter.slug %>">
+            <a href="#<%= child.chapter.slug %>" class="toc-h1" onclick="showChapter('<%= child.chapter.slug %>')"><%= h(child.chapter.display_title) %></a>
+            <%- sub_headings = child.chapter.headings.select { |h| h.level == 2 } -%>
+            <%- unless sub_headings.empty? -%>
+            <ul>
+              <%- sub_headings.each do |heading| -%>
+              <li>
+                <a href="#<%= child.chapter.slug %>--<%= heading.id %>" class="toc-h<%= heading.level %>" onclick="showChapterAndScroll('<%= child.chapter.slug %>', '<%= child.chapter.slug %>--<%= heading.id %>')"><%= h(heading.display_text) %></a>
+              </li>
+              <%- end -%>
+            </ul>
+            <%- end -%>
+          </li>
+          <%- end -%>
+        </ul>
+      </li>
+        <%- end -%>
+      <%- end -%>
+      <%- unless ld[:bibliography].empty? -%>
+      <li class="toc-chapter" data-chapter="<%= ld[:lang] %>--__bibliography__">
+        <a href="#<%= ld[:lang] %>--__bibliography__" class="toc-h1" onclick="showChapter('<%= ld[:lang] %>--__bibliography__')"><%= ld[:language] == 'ja' ? '参考文献' : 'Bibliography' %></a>
+      </li>
+      <%- end -%>
+      <%- unless ld[:index_tree].empty? -%>
+      <li class="toc-chapter" data-chapter="<%= ld[:lang] %>--__index__">
+        <a href="#<%= ld[:lang] %>--__index__" class="toc-h1" onclick="showChapter('<%= ld[:lang] %>--__index__')"><%= ld[:language] == 'ja' ? '索引' : 'Index' %></a>
+      </li>
+      <%- end -%>
+    </ul>
+  <%- end -%>
+<%- else -%>
     <ul>
+      <li class="toc-chapter" data-chapter="__toc__">
+        <a href="#__toc__" class="toc-h1" onclick="showChapter('__toc__')"><%= language == 'ja' ? '目次' : 'Contents' %></a>
+      </li>
       <%- structure.each do |node| -%>
         <%- case node.type -%>
         <%- when :cover -%>
         <%- when :chapter -%>
       <li class="toc-chapter" data-chapter="<%= node.chapter.slug %>">
         <a href="#<%= node.chapter.slug %>" class="toc-h1" onclick="showChapter('<%= node.chapter.slug %>')"><%= h(node.chapter.display_title) %></a>
-        <%- sub_headings = node.chapter.headings.select { |h| h.level >= 2 } -%>
+        <%- sub_headings = node.chapter.headings.select { |h| h.level == 2 } -%>
         <%- unless sub_headings.empty? -%>
         <ul>
           <%- sub_headings.each do |heading| -%>
@@ -73,7 +190,7 @@
           <%- (node.children || []).each do |child| -%>
           <li class="toc-chapter" data-chapter="<%= child.chapter.slug %>">
             <a href="#<%= child.chapter.slug %>" class="toc-h1" onclick="showChapter('<%= child.chapter.slug %>')"><%= h(child.chapter.display_title) %></a>
-            <%- sub_headings = child.chapter.headings.select { |h| h.level >= 2 } -%>
+            <%- sub_headings = child.chapter.headings.select { |h| h.level == 2 } -%>
             <%- unless sub_headings.empty? -%>
             <ul>
               <%- sub_headings.each do |heading| -%>
@@ -94,7 +211,7 @@
           <%- (node.children || []).each do |child| -%>
           <li class="toc-chapter" data-chapter="<%= child.chapter.slug %>">
             <a href="#<%= child.chapter.slug %>" class="toc-h1" onclick="showChapter('<%= child.chapter.slug %>')"><%= h(child.chapter.display_title) %></a>
-            <%- sub_headings = child.chapter.headings.select { |h| h.level >= 2 } -%>
+            <%- sub_headings = child.chapter.headings.select { |h| h.level == 2 } -%>
             <%- unless sub_headings.empty? -%>
             <ul>
               <%- sub_headings.each do |heading| -%>
@@ -121,12 +238,176 @@
       </li>
       <%- end -%>
     </ul>
+<%- end -%>
   </nav>
 </div>
 
 <button class="sidebar-toggle" id="sidebar-toggle" aria-label="Toggle sidebar">&#9776;</button>
 
 <main class="content" id="content">
+<%- if multilang -%>
+  <%- langs.each do |ld| -%>
+  <section class="chapter toc-page" id="chapter-<%= ld[:lang] %>--__toc__" data-lang="<%= ld[:lang] %>" style="display: none;">
+    <h1><%= ld[:language] == 'ja' ? '目次' : 'Contents' %></h1>
+    <nav class="toc-full">
+    <%- ld[:structure].each do |node| -%>
+      <%- case node.type -%>
+      <%- when :cover -%>
+      <%- when :chapter -%>
+      <div class="toc-full-chapter">
+        <a href="#<%= node.chapter.slug %>" onclick="showChapter('<%= node.chapter.slug %>'); return false;"><%= h(node.chapter.display_title) %></a>
+        <%- sub = node.chapter.headings.select { |h| h.level >= 2 } -%>
+        <%- unless sub.empty? -%>
+        <ul><%- sub.each do |heading| -%>
+          <li class="toc-full-h<%= heading.level %>"><a href="#<%= node.chapter.slug %>--<%= heading.id %>" onclick="showChapterAndScroll('<%= node.chapter.slug %>', '<%= node.chapter.slug %>--<%= heading.id %>'); return false;"><%= h(heading.display_text) %></a></li>
+        <%- end -%></ul>
+        <%- end -%>
+      </div>
+      <%- when :part -%>
+      <div class="toc-full-part">
+        <a href="#<%= node.chapter.slug %>" onclick="showChapter('<%= node.chapter.slug %>'); return false;" class="toc-full-part-title"><%= h(node.chapter.title) %></a>
+        <%- (node.children || []).each do |child| -%>
+        <div class="toc-full-chapter">
+          <a href="#<%= child.chapter.slug %>" onclick="showChapter('<%= child.chapter.slug %>'); return false;"><%= h(child.chapter.display_title) %></a>
+          <%- sub = child.chapter.headings.select { |h| h.level >= 2 } -%>
+          <%- unless sub.empty? -%>
+          <ul><%- sub.each do |heading| -%>
+            <li class="toc-full-h<%= heading.level %>"><a href="#<%= child.chapter.slug %>--<%= heading.id %>" onclick="showChapterAndScroll('<%= child.chapter.slug %>', '<%= child.chapter.slug %>--<%= heading.id %>'); return false;"><%= h(heading.display_text) %></a></li>
+          <%- end -%></ul>
+          <%- end -%>
+        </div>
+        <%- end -%>
+      </div>
+      <%- when :appendix_group -%>
+      <div class="toc-full-part">
+        <span class="toc-full-part-title"><%= h(ld[:appendix_label]) %></span>
+        <%- (node.children || []).each do |child| -%>
+        <div class="toc-full-chapter">
+          <a href="#<%= child.chapter.slug %>" onclick="showChapter('<%= child.chapter.slug %>'); return false;"><%= h(child.chapter.display_title) %></a>
+          <%- sub = child.chapter.headings.select { |h| h.level >= 2 } -%>
+          <%- unless sub.empty? -%>
+          <ul><%- sub.each do |heading| -%>
+            <li class="toc-full-h<%= heading.level %>"><a href="#<%= child.chapter.slug %>--<%= heading.id %>" onclick="showChapterAndScroll('<%= child.chapter.slug %>', '<%= child.chapter.slug %>--<%= heading.id %>'); return false;"><%= h(heading.display_text) %></a></li>
+          <%- end -%></ul>
+          <%- end -%>
+        </div>
+        <%- end -%>
+      </div>
+      <%- end -%>
+    <%- end -%>
+    </nav>
+  </section>
+  <%- ld[:chapters].each_with_index do |chapter, idx| -%>
+  <section class="<%= chapter.cover? ? 'chapter cover-page' : 'chapter' %>" id="chapter-<%= chapter.slug %>" data-lang="<%= ld[:lang] %>" style="display: none;">
+    <%= chapter.html %>
+    <%- if ld[:repository] && !chapter.part_title? && !chapter.cover? -%>
+    <div class="edit-link">
+      <a href="<%= h(ld[:repository].chomp('/')) %>/blob/HEAD/<%= h(chapter.relative_path) %>" target="_blank" rel="noopener">View on GitHub</a>
+    </div>
+    <%- end -%>
+    <%- if ld[:footer] && !chapter.part_title? && !chapter.cover? -%>
+    <div class="chapter-footer"><%= h(ld[:footer]) %></div>
+    <%- end -%>
+    <%- unless chapter.cover? -%>
+    <nav class="chapter-nav">
+      <%- if idx > 0 -%>
+      <a href="#" class="nav-prev" onclick="showChapter('<%= ld[:chapters][idx-1].slug %>'); return false;">&larr; <%= h(ld[:chapters][idx-1].display_title) %></a>
+      <%- else -%>
+      <span></span>
+      <%- end -%>
+      <%- if idx < ld[:chapters].size - 1 -%>
+      <a href="#" class="nav-next" onclick="showChapter('<%= ld[:chapters][idx+1].slug %>'); return false;"><%= h(ld[:chapters][idx+1].display_title) %> &rarr;</a>
+      <%- end -%>
+    </nav>
+    <%- end -%>
+  </section>
+  <%- end -%>
+  <%- unless ld[:bibliography].empty? -%>
+  <section class="chapter bibliography-chapter" id="chapter-<%= ld[:lang] %>--__bibliography__" data-lang="<%= ld[:lang] %>" style="display: none;">
+    <h1><%= ld[:language] == 'ja' ? '参考文献' : 'Bibliography' %></h1>
+    <ul class="bibliography-list">
+      <%- ld[:bibliography].each do |entry| -%>
+      <li id="<%= ld[:lang] %>--bib-<%= h(entry[:key]) %>"><span class="bib-label">[<%= h(entry[:label]) %>]</span> <%= entry[:formatted_html] %></li>
+      <%- end -%>
+    </ul>
+  </section>
+  <%- end -%>
+  <%- unless ld[:index_tree].empty? -%>
+  <section class="chapter index-chapter" id="chapter-<%= ld[:lang] %>--__index__" data-lang="<%= ld[:lang] %>" style="display: none;">
+    <h1><%= ld[:language] == 'ja' ? '索引' : 'Index' %></h1>
+    <%- ld[:index_tree].keys.sort.each do |letter| -%>
+    <div class="index-group">
+      <h2 class="index-letter"><%= letter %></h2>
+      <dl class="index-entries">
+        <%- ld[:index_tree][letter].each do |item| -%>
+        <dt><%= h(item[:term]) %></dt>
+        <%- item[:refs].each do |ref| -%>
+        <dd><a href="#<%= ref[:anchor_id] %>" onclick="showChapterAndScroll('<%= ref[:chapter_slug] %>', '<%= ref[:anchor_id] %>'); return false;"><%= ref[:chapter_title] %></a></dd>
+        <%- end -%>
+        <%- item[:children].each do |child| -%>
+        <dt class="index-sub"><%= h(child[:term]) %></dt>
+        <%- child[:refs].each do |ref| -%>
+        <dd class="index-sub"><a href="#<%= ref[:anchor_id] %>" onclick="showChapterAndScroll('<%= ref[:chapter_slug] %>', '<%= ref[:anchor_id] %>'); return false;"><%= ref[:chapter_title] %></a></dd>
+        <%- end -%>
+        <%- end -%>
+        <%- end -%>
+      </dl>
+    </div>
+    <%- end -%>
+  </section>
+  <%- end -%>
+  <%- end -%>
+<%- else -%>
+  <section class="chapter toc-page" id="chapter-__toc__" style="display: none;">
+    <h1><%= language == 'ja' ? '目次' : 'Contents' %></h1>
+    <nav class="toc-full">
+    <%- structure.each do |node| -%>
+      <%- case node.type -%>
+      <%- when :cover -%>
+      <%- when :chapter -%>
+      <div class="toc-full-chapter">
+        <a href="#<%= node.chapter.slug %>" onclick="showChapter('<%= node.chapter.slug %>'); return false;"><%= h(node.chapter.display_title) %></a>
+        <%- sub = node.chapter.headings.select { |h| h.level >= 2 } -%>
+        <%- unless sub.empty? -%>
+        <ul><%- sub.each do |heading| -%>
+          <li class="toc-full-h<%= heading.level %>"><a href="#<%= node.chapter.slug %>--<%= heading.id %>" onclick="showChapterAndScroll('<%= node.chapter.slug %>', '<%= node.chapter.slug %>--<%= heading.id %>'); return false;"><%= h(heading.display_text) %></a></li>
+        <%- end -%></ul>
+        <%- end -%>
+      </div>
+      <%- when :part -%>
+      <div class="toc-full-part">
+        <a href="#<%= node.chapter.slug %>" onclick="showChapter('<%= node.chapter.slug %>'); return false;" class="toc-full-part-title"><%= h(node.chapter.title) %></a>
+        <%- (node.children || []).each do |child| -%>
+        <div class="toc-full-chapter">
+          <a href="#<%= child.chapter.slug %>" onclick="showChapter('<%= child.chapter.slug %>'); return false;"><%= h(child.chapter.display_title) %></a>
+          <%- sub = child.chapter.headings.select { |h| h.level >= 2 } -%>
+          <%- unless sub.empty? -%>
+          <ul><%- sub.each do |heading| -%>
+            <li class="toc-full-h<%= heading.level %>"><a href="#<%= child.chapter.slug %>--<%= heading.id %>" onclick="showChapterAndScroll('<%= child.chapter.slug %>', '<%= child.chapter.slug %>--<%= heading.id %>'); return false;"><%= h(heading.display_text) %></a></li>
+          <%- end -%></ul>
+          <%- end -%>
+        </div>
+        <%- end -%>
+      </div>
+      <%- when :appendix_group -%>
+      <div class="toc-full-part">
+        <span class="toc-full-part-title"><%= h(appendix_label) %></span>
+        <%- (node.children || []).each do |child| -%>
+        <div class="toc-full-chapter">
+          <a href="#<%= child.chapter.slug %>" onclick="showChapter('<%= child.chapter.slug %>'); return false;"><%= h(child.chapter.display_title) %></a>
+          <%- sub = child.chapter.headings.select { |h| h.level >= 2 } -%>
+          <%- unless sub.empty? -%>
+          <ul><%- sub.each do |heading| -%>
+            <li class="toc-full-h<%= heading.level %>"><a href="#<%= child.chapter.slug %>--<%= heading.id %>" onclick="showChapterAndScroll('<%= child.chapter.slug %>', '<%= child.chapter.slug %>--<%= heading.id %>'); return false;"><%= h(heading.display_text) %></a></li>
+          <%- end -%></ul>
+          <%- end -%>
+        </div>
+        <%- end -%>
+      </div>
+      <%- end -%>
+    <%- end -%>
+    </nav>
+  </section>
   <%- chapters.each_with_index do |chapter, idx| -%>
   <section class="<%= chapter.cover? ? 'chapter cover-page' : 'chapter' %>" id="chapter-<%= chapter.slug %>" style="display: none;">
     <%= chapter.html %>
@@ -186,38 +467,180 @@
     <%- end -%>
   </section>
   <%- end -%>
+<%- end -%>
 </main>
 
 <script>
 (function() {
-  var chapters = [<%= chapters.map { |c| "\"#{c.slug}\"" }.join(", ") %><%= ', "__bibliography__"' unless bibliography.empty? %><%= ', "__index__"' unless index_tree.empty? %>];
+<%- if multilang -%>
+  var langChapters = {
+  <%- langs.each do |ld| -%>
+    "<%= ld[:lang] %>": ["<%= ld[:lang] %>--__toc__", <%= ld[:chapters].map { |c| "\"#{c.slug}\"" }.join(", ") %><%= ", \"#{ld[:lang]}--__bibliography__\"" unless ld[:bibliography].empty? %><%= ", \"#{ld[:lang]}--__index__\"" unless ld[:index_tree].empty? %>],
+  <%- end -%>
+  };
+  var allLangs = [<%= langs.map { |ld| "\"#{ld[:lang]}\"" }.join(", ") %>];
+  var currentLang = localStorage.getItem('ligarb-lang') || allLangs[0];
+  if (allLangs.indexOf(currentLang) === -1) currentLang = allLangs[0];
+  var chapters = langChapters[currentLang];
+<%- else -%>
+  var chapters = ["__toc__", <%= chapters.map { |c| "\"#{c.slug}\"" }.join(", ") %><%= ', "__bibliography__"' unless bibliography.empty? %><%= ', "__index__"' unless index_tree.empty? %>];
+<%- end -%>
   var currentChapter = null;
 
   var navigating = false; // flag to suppress pushState during popstate/initial load
 
+  // Track the currently visible heading index and highlight TOC
+  var currentHeadingIndex = -1;
+  var headingObserver = null;
+
+  function setupHeadingObserver() {
+    if (headingObserver) headingObserver.disconnect();
+    if (!currentChapter) return;
+    var section = document.getElementById('chapter-' + currentChapter);
+    if (!section) return;
+    var headings = section.querySelectorAll('h1, h2, h3');
+    if (headings.length === 0) return;
+
+    headingObserver = new IntersectionObserver(function(entries) {
+      entries.forEach(function(entry) {
+        if (entry.isIntersecting) {
+          var idx = Array.prototype.indexOf.call(headings, entry.target);
+          if (idx !== -1) {
+            currentHeadingIndex = idx;
+            highlightTocHeading(entry.target);
+          }
+        }
+      });
+    }, { rootMargin: '0px 0px -70% 0px', threshold: 0 });
+
+    headings.forEach(function(h) { headingObserver.observe(h); });
+  }
+
+  function highlightTocHeading(heading) {
+    // Remove previous active-section highlights
+    document.querySelectorAll('.toc a.active-section').forEach(function(a) {
+      a.classList.remove('active-section');
+    });
+    // Find the TOC link matching this heading's ID
+    var hid = heading.id;
+    if (!hid) return;
+    var tocLink = document.querySelector('.toc a[href="#' + CSS.escape(hid) + '"]');
+    if (tocLink) tocLink.classList.add('active-section');
+  }
+
+<%- if multilang -%>
+
+  function switchLang(lang) {
+    // Remember current position: chapter base slug and heading index
+    var oldLang = currentLang;
+    var targetSlug = null;
+    var targetHeadingIdx = currentHeadingIndex;
+
+    if (currentChapter) {
+      // Strip lang prefix to get the base slug (e.g. "ja--03-book-yml" → "03-book-yml")
+      var baseSlug = currentChapter.replace(new RegExp('^' + oldLang + '--'), '');
+      targetSlug = lang + '--' + baseSlug;
+    }
+
+    currentLang = lang;
+    chapters = langChapters[lang];
+    localStorage.setItem('ligarb-lang', lang);
+
+    // Toggle lang-content elements (TOC, header)
+    document.querySelectorAll('.lang-content').forEach(function(el) {
+      el.style.display = el.dataset.lang === lang ? '' : 'none';
+    });
+
+    // Toggle lang-switcher buttons
+    document.querySelectorAll('.lang-link').forEach(function(btn) {
+      if (btn.dataset.lang === lang) {
+        btn.classList.add('lang-current');
+      } else {
+        btn.classList.remove('lang-current');
+      }
+    });
+
+    // Hide all chapter sections, then show first of current lang
+    document.querySelectorAll('main .chapter').forEach(function(el) {
+      el.style.display = 'none';
+    });
+
+    // Reset search cache
+    chapterTextCache = null;
+
+    // Navigate to the corresponding chapter in the new language
+    if (targetSlug && chapters.indexOf(targetSlug) !== -1) {
+      showChapter(targetSlug);
+      // Scroll to the corresponding heading by index
+      if (targetHeadingIdx >= 0) {
+        setTimeout(function() {
+          var section = document.getElementById('chapter-' + targetSlug);
+          if (!section) return;
+          var headings = section.querySelectorAll('h1, h2, h3');
+          if (targetHeadingIdx < headings.length) {
+            headings[targetHeadingIdx].scrollIntoView({ behavior: 'smooth' });
+          }
+        }, 50);
+      }
+    } else {
+      showChapter(chapters[0]);
+    }
+  }
+
+  // Initialize lang display
+  function initLang() {
+    document.querySelectorAll('.lang-content').forEach(function(el) {
+      el.style.display = el.dataset.lang === currentLang ? '' : 'none';
+    });
+    document.querySelectorAll('.lang-link').forEach(function(btn) {
+      if (btn.dataset.lang === currentLang) btn.classList.add('lang-current');
+    });
+  }
+
+  window.switchLang = switchLang;
+<%- end -%>
+
   function showChapter(slug, hash) {
     chapters.forEach(function(ch) {
       var el = document.getElementById('chapter-' + ch);
       if (el) el.style.display = (ch === slug) ? 'block' : 'none';
     });
 
-    // Update active state in TOC
+    // Update active state in TOC and scroll sidebar to show active item
+<%- if multilang -%>
+    var tocContainer = document.querySelector('.toc .lang-content[data-lang="' + currentLang + '"]');
+    var tocItems = tocContainer ? tocContainer.querySelectorAll('.toc-chapter') : [];
+<%- else -%>
     var tocItems = document.querySelectorAll('.toc-chapter');
+<%- end -%>
+    var activeItem = null;
     tocItems.forEach(function(item) {
       if (item.dataset.chapter === slug) {
         item.classList.add('active');
+        activeItem = item;
       } else {
         item.classList.remove('active');
       }
     });
+    if (activeItem) {
+      var tocNav = document.getElementById('toc');
+      var itemRect = activeItem.getBoundingClientRect();
+      var tocRect = tocNav.getBoundingClientRect();
+      if (itemRect.top < tocRect.top || itemRect.bottom > tocRect.bottom) {
+        activeItem.scrollIntoView({ block: 'center' });
+      }
+    }
 
     currentChapter = slug;
+    currentHeadingIndex = -1;
     var newHash = '#' + (hash || slug);
     if (!navigating) {
       history.pushState(null, '', newHash);
     }
     window.scrollTo(0, 0);
 
+    setupHeadingObserver();
+
     // Re-apply highlight if search is active
     if (searchInput && searchInput.value) {
       highlightContent(searchInput.value);
@@ -232,7 +655,21 @@
     if (!section) return;
     if (typeof mermaid !== 'undefined') {
       var unrendered = section.querySelectorAll('.mermaid:not([data-processed])');
-      if (unrendered.length > 0) mermaid.run({nodes: unrendered});
+      if (unrendered.length > 0) {
+        // Save original source for error recovery
+        var sources = {};
+        unrendered.forEach(function(el) { sources[el.id || el.textContent.slice(0, 50)] = el.textContent; });
+        mermaid.run({nodes: unrendered, suppressErrors: true}).catch(function() {}).finally(function() {
+          unrendered.forEach(function(el) {
+            // mermaid sets data-processed; if it's still text-only (no SVG), it failed
+            if (!el.querySelector('svg')) {
+              var src = sources[el.id || el.textContent.slice(0, 50)] || el.textContent;
+              el.innerHTML = '<pre style="color:#c00;border:1px solid #c00;padding:0.5em;white-space:pre-wrap">mermaid error:\n' +
+                src.replace(/</g, '&lt;') + '</pre>';
+            }
+          });
+        });
+      }
     }
     if (typeof katex !== 'undefined') {
       section.querySelectorAll('.math-block[data-math]').forEach(function(el) {
@@ -325,6 +762,7 @@
       if (target) {
         target.scrollIntoView({ behavior: 'smooth' });
         highlightElement(target);
+        highlightTocHeading(target);
       }
     }, 50);
   }
@@ -345,6 +783,14 @@
       return;
     }
 
+<%- if multilang -%>
+    // In multilang mode, detect language from hash prefix (e.g., "en--cover")
+    var langMatch = hash.match(/^([a-z]{2})--/);
+    if (langMatch && allLangs.indexOf(langMatch[1]) !== -1 && langMatch[1] !== currentLang) {
+      switchLang(langMatch[1]);
+    }
+<%- end -%>
+
     // Check if hash matches a chapter slug directly
     if (chapters.indexOf(hash) !== -1) {
       showChapter(hash);
@@ -352,7 +798,20 @@
       return;
     }
 
-    <%- unless bibliography.empty? -%>
+<%- if multilang -%>
+    // Check for bibliography entry (bib-KEY)
+    var bibMatch = hash.match(/^(?:([a-z]{2})--)?bib-(.+)/);
+    if (bibMatch) {
+      var bibLang = bibMatch[1] || currentLang;
+      showChapter(bibLang + '--__bibliography__', hash);
+      setTimeout(function() {
+        var target = document.getElementById(hash);
+        if (target) target.scrollIntoView({ behavior: 'smooth' });
+      }, 50);
+      navigating = false;
+      return;
+    }
+<%- elsif !bibliography.empty? -%>
     // Check for bibliography entry (bib-KEY)
     var bibMatch = hash.match(/^bib-(.+)/);
     if (bibMatch) {
@@ -364,7 +823,7 @@
       navigating = false;
       return;
     }
-    <%- end -%>
+<%- end -%>
 
     // Check for footnote links (fn: or fnref:)
     var fnMatch = hash.match(/^(?:fn|fnref):(.+?)--/);
@@ -382,12 +841,31 @@
     // Check for deep link (chapter--heading)
     var parts = hash.split('--');
     if (parts.length >= 2) {
+<%- if multilang -%>
+      // In multilang, slug is "lang--chapter" so join first two parts
+      var chSlug = parts[0] + '--' + parts[1];
+      if (chapters.indexOf(chSlug) !== -1) {
+        showChapterAndScroll(chSlug, hash);
+        navigating = false;
+        return;
+      }
+      // Try 3 parts: "lang--chapter--heading" → chapter is "lang--chapter"
+      if (parts.length >= 3) {
+        chSlug = parts[0] + '--' + parts[1];
+        if (chapters.indexOf(chSlug) !== -1) {
+          showChapterAndScroll(chSlug, hash);
+          navigating = false;
+          return;
+        }
+      }
+<%- else -%>
       var chSlug = parts[0];
       if (chapters.indexOf(chSlug) !== -1) {
         showChapterAndScroll(chSlug, hash);
         navigating = false;
         return;
       }
+<%- end -%>
     }
 
     // Fallback
@@ -429,8 +907,14 @@
     // Remove existing match count badges
     document.querySelectorAll('.search-match-count').forEach(function(el) { el.remove(); });
 
+<%- if multilang -%>
+    var tocContainer = document.querySelector('.toc .lang-content[data-lang="' + currentLang + '"]');
+    var items = tocContainer ? tocContainer.querySelectorAll('.toc-chapter') : [];
+    var partItems = tocContainer ? tocContainer.querySelectorAll('.toc-part, .toc-appendix') : [];
+<%- else -%>
     var items = document.querySelectorAll('.toc-chapter');
     var partItems = document.querySelectorAll('.toc-part, .toc-appendix');
+<%- end -%>
 
     if (!query || query.length < 2) {
       // Show all items when query is too short
@@ -597,6 +1081,9 @@
   window.renderSpecialBlocks = function() { if (currentChapter) renderSpecialBlocks(currentChapter); };
 
   // Initialize (replace initial entry so first back goes to previous page, not same page)
+<%- if multilang -%>
+  initLang();
+<%- end -%>
   navigating = true;
   handleHash();
   history.replaceState(null, '', location.hash || '#' + (chapters[0] || ''));

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ligarb
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - ligarb contributors
@@ -137,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Generate a single-page HTML book from Markdown files
 test_files: []