ligarb 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e697032ff94ff3c4a910343f29d6a977bd386afaa92dbcf4dbb0ca0108e70b2
-  data.tar.gz: d142ecba5fb0cb7287f2206e31309c40dff8016b216f79053669f5fa8bc59c47
+  metadata.gz: 9771ee497c353bffb143092dae4b8631c72587e264ca3e6081e614e582de9d1b
+  data.tar.gz: 1def484d79741c7e88d657c485799762e7bf6909cd3bf9a3118aac00ac3cf32f
 SHA512:
-  metadata.gz: 6a24c126ae03426cd2361885244882a08b5e666cd112fa77b437225a48d954adb0ec2ea59d3c620b317a9549ea78efa17bfcde367c8aed9bd69be79f6b7f45b9
-  data.tar.gz: b77a95db5ec9f3541349d999b9c936ddad7b65df844a3ec15f0059698e05f8973cabde8ac2b3fe60598acfa43ab866c70162bee0c1ce46bc7350be41ec195253
+  metadata.gz: 8f7902c30dbc242df9605bfc95995a01c6a23729e1c7079811b0ff9e7a7545d534225c3216cce46c6619a073d215a728dd24a1ab6fb2011206887180ed786c03
+  data.tar.gz: 720e0fc0a1433537e956987edc1e2656931b5fb01ceb22dd57ee6b537451ab69c30c34d671ad16c3985f60d5f00ee8ddab4028c8fb4c17527b57b5d8724d70a7

data/assets/review.css

@@ -203,6 +203,23 @@
   margin-top: 4px;
 }
 
+.ligarb-file-path {
+  font-size: 10px;
+  color: var(--color-text-muted, #999);
+  margin-top: 2px;
+}
+
+.ligarb-file-path summary {
+  cursor: pointer;
+  opacity: 0.5;
+}
+
+.ligarb-file-path code {
+  font-size: 10px;
+  word-break: break-all;
+  user-select: all;
+}
+
 /* ── Messages ── */
 
 .ligarb-messages {

data/assets/review.js

@@ -269,9 +269,11 @@
 
   function renderReview(review) {
     var ctx = review.context || {};
+    var filePath = review.file_path ? '<details class="ligarb-file-path"><summary>debug</summary><code>' + escapeHTML(review.file_path) + '</code></details>' : '';
     panel.querySelector('.ligarb-context').innerHTML =
       '<div class="ligarb-selected-text">"' + escapeHTML(ctx.selected_text || '') + '"</div>' +
-      '<div class="ligarb-meta">Chapter: ' + escapeHTML(ctx.chapter_slug || '') + '</div>';
+      '<div class="ligarb-meta">Chapter: ' + escapeHTML(ctx.chapter_slug || '') + '</div>' +
+      filePath;
 
     var msgsEl = panel.querySelector('.ligarb-messages');
     msgsEl.innerHTML = '';
@@ -331,7 +333,7 @@
     var patches = '';
 
     parts.forEach(function(part) {
-      var m = part.match(/<patch(?:\s+file="([^"]*)")?>[\s\S]*?<<<\n([\s\S]*?)\n===\n([\s\S]*?)\n>>>\s*<\/patch>/);
+      var m = part.match(/<patch(?:\s+file="([^"]*)")?>\s*<<<[ \t]*\r?\n([\s\S]*?)\r?\n===[ \t]*\r?\n([\s\S]*?)\r?\n>>>[ \t]*\s*<\/patch>/);
       if (m) {
         hasPatch = true;
         var fileLabel = m[1] ? '<div class="ligarb-patch-file">' + escapeHTML(m[1]) + '</div>' : '';
@@ -505,6 +507,7 @@
       }
 
       body.innerHTML = '';
+      reviews.reverse();
       reviews.forEach(function(r) {
         var item = document.createElement('div');
         item.className = 'ligarb-list-item ligarb-list-' + r.status;

data/assets/serve.js

@@ -53,6 +53,39 @@
             });
           }
           window.scrollTo(0, scrollY);
+
+          // Re-initialize syntax highlighting and special blocks
+          if (typeof hljs !== 'undefined') hljs.highlightAll();
+          if (typeof mermaid !== 'undefined') {
+            var unrendered = oldMain.querySelectorAll('.mermaid:not([data-processed])');
+            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) {
+              if (el.childNodes.length === 0) {
+                try { katex.render(el.getAttribute('data-math'), el, {displayMode: true, throwOnError: false}); }
+                catch(e) { el.textContent = el.getAttribute('data-math'); }
+              }
+            });
+            oldMain.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'); }
+              }
+            });
+          }
         }
         refreshing = false;
         hideReloadButton();

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);
@@ -447,6 +452,7 @@ mark.search-highlight {
   --color-accent-light: #1c3a5c;
   --color-code-bg: #0f172a;
   --color-code-border: #2d3748;
+  --color-highlight: rgba(255, 243, 205, 0.15);
 }
 
 [data-theme="dark"] .admonition-note {
@@ -658,6 +664,17 @@ mark.search-highlight {
   text-decoration: underline;
 }
 
+.ligarb-highlight {
+  border-radius: 4px;
+  padding: 4px 6px;
+  animation: ligarb-highlight-fade 3s ease-out forwards;
+}
+
+@keyframes ligarb-highlight-fade {
+  0% { background: var(--color-highlight, #fff3cd); }
+  100% { background: transparent; }
+}
+
 .cite-ref {
   font-size: 0.8em;
 }
@@ -757,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;
@@ -765,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,
@@ -815,3 +923,27 @@ mark.search-highlight {
     }
   }
 }
+
+/* === Mermaid source toggle === */
+details.mermaid-source {
+  margin-top: 0.3em;
+  font-size: 0.8em;
+}
+details.mermaid-source summary {
+  cursor: pointer;
+  color: #888;
+  user-select: none;
+}
+details.mermaid-source pre {
+  margin-top: 0.3em;
+  padding: 0.5em;
+  background: #f5f5f5;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  overflow-x: auto;
+  white-space: pre-wrap;
+}
+.dark-mode details.mermaid-source pre {
+  background: #2a2a2a;
+  border-color: #444;
+}

data/lib/ligarb/asset_manager.rb

@@ -9,7 +9,7 @@ module Ligarb
   class AssetManager
     ASSETS = {
       highlight: {
-        fence_pattern: /language-(?!mermaid|math)(\w+)/,
+        fence_pattern: /language-(?!mermaid|math|functionplot)(\w+)/,
         files: {
           "js/highlight.min.js" => "https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/highlight.min.js",
           "css/highlight.css" => "https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/styles/github.min.css",
@@ -28,6 +28,13 @@ module Ligarb
           "css/katex.min.css" => "https://cdn.jsdelivr.net/npm/katex@0.16/dist/katex.min.css",
         },
       },
+      functionplot: {
+        fence_pattern: /class="functionplot"/,
+        files: {
+          "js/d3.min.js" => "https://cdn.jsdelivr.net/npm/d3@7/dist/d3.min.js",
+          "js/function-plot.min.js" => "https://cdn.jsdelivr.net/npm/function-plot@1/dist/function-plot.js",
+        },
+      },
     }.freeze
 
     def initialize(output_path)
@@ -60,6 +67,8 @@ module Ligarb
 
     private
 
+    MAX_ASSET_SIZE = 5 * 1024 * 1024 # 5MB
+
     def download(url, dest)
       FileUtils.mkdir_p(File.dirname(dest))
       $stderr.print "Downloading #{File.basename(dest)}... "
@@ -68,6 +77,9 @@ module Ligarb
       response = fetch_with_redirects(uri)
 
       if response.is_a?(Net::HTTPSuccess)
+        if response.body.bytesize > MAX_ASSET_SIZE
+          abort "Error: downloaded file too large: #{File.basename(dest)} (#{response.body.bytesize} bytes, limit #{MAX_ASSET_SIZE})"
+        end
         File.write(dest, response.body)
         $stderr.puts "done"
       else
@@ -77,11 +89,14 @@ module Ligarb
 
     def fetch_with_redirects(uri, limit = 5)
       raise "Too many redirects" if limit == 0
+      raise "Only HTTPS URLs are supported for asset downloads" unless uri.scheme == "https"
 
       response = Net::HTTP.get_response(uri)
       case response
       when Net::HTTPRedirection
-        fetch_with_redirects(URI(response["location"]), limit - 1)
+        new_uri = URI(response["location"])
+        raise "Redirect to non-HTTPS URL: #{new_uri}" unless new_uri.scheme == "https"
+        fetch_with_redirects(new_uri, limit - 1)
       else
         response
       end

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
 
@@ -166,14 +167,18 @@ module Ligarb
     end
 
     def convert_special_code_blocks(html)
-      html.gsub(%r{<pre><code class="language-(mermaid|math)">(.*?)</code></pre>}m) do
+      html.gsub(%r{<pre><code class="language-(mermaid|math|functionplot)">(.*?)</code></pre>}m) do
         lang = $1
         raw = decode_entities($2)
         case lang
         when "mermaid"
-          %(<div class="mermaid">\n#{raw}</div>)
+          escaped = raw.gsub("&", "&amp;").gsub("<", "&lt;").gsub(">", "&gt;")
+          %(<div class="mermaid">\n#{raw}</div>) +
+            %(<details class="mermaid-source"><summary>mermaid source</summary><pre>#{escaped}</pre></details>)
         when "math"
           %(<div class="math-block" data-math="#{encode_attr(raw)}"></div>)
+        when "functionplot"
+          %(<div class="functionplot" data-plot="#{encode_attr(raw)}"></div>)
         end
       end
     end
@@ -187,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