bindery-cli 0.1.1 → 0.2.0

data/lib/bindery/cover.rb

@@ -0,0 +1,135 @@
+require "zlib"
+require "digest"
+
+module Bindery
+  # 纯 Ruby 生成装饰性封面 PNG：配色由书名稳定派生，不含文字（文字渲染需要字体光栅化，超出标准库能力）
+  module Cover
+    WIDTH  = 600
+    HEIGHT = 800
+
+    module_function
+
+    # 为书籍生成 cover.png，并把 metadata.yaml 的 cover 字段指向它；返回文件路径
+    def generate(book)
+      png = encode_png(WIDTH, HEIGHT, build_pixels(WIDTH, HEIGHT, book.title))
+      path = book.dir + "cover.png"
+      path.binwrite(png)
+      update_metadata_cover(book)
+      path
+    end
+
+    def update_metadata_cover(book)
+      meta_file = book.metadata_file
+      return unless meta_file.file?
+
+      text = meta_file.read
+      text = if text =~ /^cover:.*$/
+               text.sub(/^cover:.*$/, "cover: cover.png")
+             else
+               text.chomp + "\ncover: cover.png\n"
+             end
+      meta_file.write(text)
+    end
+
+    # 逐像素生成 RGB 位图，返回行数组（每行是一串 RGB 字节）
+    def build_pixels(width, height, title)
+      hue = Digest::MD5.hexdigest(title).to_i(16) % 360
+      top    = hsl_to_rgb(hue, 0.45, 0.92)
+      bottom = hsl_to_rgb(hue, 0.60, 0.28)
+      accent = hsl_to_rgb((hue + 40) % 360, 0.55, 0.50)
+      frame  = hsl_to_rgb(hue, 0.50, 0.18)
+
+      margin = 44
+      thickness = 4
+
+      (0...height).map do |y|
+        t = y.to_f / (height - 1)
+        base = lerp(top, bottom, t)
+        row = (+"").b
+        (0...width).each do |x|
+          c =
+            if border?(x, y, width, height, margin, thickness)
+              frame
+            elsif ring?(x, y, width, height)
+              accent
+            else
+              base
+            end
+          row << c.pack("C3")
+        end
+        row
+      end
+    end
+
+    def border?(x, y, w, h, margin, thickness)
+      in_x = x >= margin && x < w - margin
+      in_y = y >= margin && y < h - margin
+      return false unless in_x && in_y
+
+      near_x = (x - margin).abs < thickness || (x - (w - margin - 1)).abs < thickness
+      near_y = (y - margin).abs < thickness || (y - (h - margin - 1)).abs < thickness
+      near_x || near_y
+    end
+
+    # 居中的方框纹样（外方框 + 内镂空）
+    def ring?(x, y, w, h)
+      cx = w / 2
+      cy = h / 2
+      outer = 220
+      inner = 150
+      dx = (x - cx).abs
+      dy = (y - cy).abs
+      in_outer = dx <= outer / 2 && dy <= outer / 2
+      in_inner = dx <= inner / 2 && dy <= inner / 2
+      in_outer && !in_inner
+    end
+
+    def lerp(c1, c2, t)
+      [
+        c1[0] + (c2[0] - c1[0]) * t,
+        c1[1] + (c2[1] - c1[1]) * t,
+        c1[2] + (c2[2] - c1[2]) * t,
+      ].map(&:round)
+    end
+
+    def hsl_to_rgb(h, s, l)
+      h = (h % 360) / 360.0
+      if s.zero?
+        r = g = b = l
+      else
+        q = l < 0.5 ? l * (1 + s) : l + s - l * s
+        p = 2 * l - q
+        r = hue_to_rgb(p, q, h + 1 / 3.0)
+        g = hue_to_rgb(p, q, h)
+        b = hue_to_rgb(p, q, h - 1 / 3.0)
+      end
+      [(r * 255).round, (g * 255).round, (b * 255).round]
+    end
+
+    def hue_to_rgb(p, q, t)
+      t += 1 if t.negative?
+      t -= 1 if t > 1
+      if t < 1 / 6.0
+        p + (q - p) * 6 * t
+      elsif t < 1 / 2.0
+        q
+      elsif t < 2 / 3.0
+        p + (q - p) * (2 / 3.0 - t) * 6
+      else
+        p
+      end
+    end
+
+    def encode_png(width, height, rows)
+      sig = "\x89PNG\r\n\x1a\n".b
+      ihdr = [width, height, 8, 2, 0, 0, 0].pack("N2C5")
+      raw = rows.map { |row| "\x00".b + row }.join
+      idat = Zlib::Deflate.deflate(raw, 9)
+      sig + chunk("IHDR", ihdr) + chunk("IDAT", idat) + chunk("IEND", "")
+    end
+
+    def chunk(type, data)
+      [data.bytesize].pack("N") + type + data + [Zlib.crc32(type + data)].pack("N")
+    end
+  end
+end

data/lib/bindery/generators/book_generator.rb

@@ -1,26 +1,42 @@
+require "securerandom"
 require_relative "base"
 
 module Bindery
   module Generators
-    # bindery generate book <id> <title> [--author] [--dynasty] [--category]
+    # bindery new book <title> [--author] [--dynasty] [--category] [--translator] [--isbn] [--id]
     class BookGenerator < Base
-      def self.call(id, title, author:, dynasty:, category:, project_root: Project.root!)
+      # 根据书名自动生成书籍 ID（目录名）：英文/数字转 slug，纯中文等回退为随机 ID
+      def self.auto_id(title)
+        slug = title.to_s.downcase.gsub(/[^a-z0-9]+/, "-").gsub(/\A-+|-+\z/, "")
+        slug.empty? ? "book-#{SecureRandom.hex(4)}" : slug
+      end
+
+      def self.call(id, title, author:, dynasty:, category:, translator: "", isbn: "", project_root: Project.root!)
         dest = Project.books_dir(project_root) + id
         raise Bindery::Error, "书籍目录已存在: #{dest}" if dest.exist?
 
+        config = Project.config(project_root)
         puts "创建书籍: #{id}"
-        new(dest).generate(id: id, title: title, author: author, dynasty: dynasty, category: category)
+        new(dest).generate(
+          id: id, title: title, author: author, dynasty: dynasty, category: category,
+          translator: translator, isbn: isbn,
+          lang: config["lang"] || "zh-CN",
+          publisher: config["publisher"] || "再读经典",
+          rights: config["rights"] || "公共领域"
+        )
         Bindery::Index.rebuild(project_root)
         puts ""
         puts "完成！接下来编辑 #{dest}/chapters/ 下的章节文件，然后："
         puts "  bindery build #{id}"
       end
 
-      def generate(id:, title:, author:, dynasty:, category:)
+      def generate(id:, title:, author:, dynasty:, category:, translator:, isbn:, lang:, publisher:, rights:)
         empty_directory("chapters")
 
         template("book", "metadata.yaml", locals: {
           id: id, title: title, author: author, dynasty: dynasty, category: category,
+          translator: translator, isbn: isbn,
+          lang: lang, publisher: publisher, rights: rights,
         })
         template("book", "chapters/01-chapter.md", locals: { title: title })
       end

data/lib/bindery/generators/chapter_generator.rb

@@ -0,0 +1,49 @@
+require "fileutils"
+require_relative "base"
+
+module Bindery
+  module Generators
+    # bindery new chapter <book-id> <数量>
+    # 在指定书籍里批量创建章节文件，编号自动接续已有章节（01-chapter.md 之后是 02-chapter.md…）
+    class ChapterGenerator < Base
+      def self.call(book_id, count, project_root: Project.root!)
+        book = Bindery::Book.find(book_id, project_root)
+        count = count.to_i
+        raise Bindery::Error, "章节数量必须是正整数" unless count.positive?
+
+        chapters_dir = book.chapters_dir
+        FileUtils.mkdir_p(chapters_dir) unless chapters_dir.directory?
+
+        start = next_number(chapters_dir)
+        puts "创建章节: #{book.id}"
+        count.times do |i|
+          n = start + i
+          file = chapters_dir + format("%02d-chapter.md", n)
+          file.write("# 第#{n}章\n\n")
+          rel = begin
+            file.relative_path_from(Pathname.pwd)
+          rescue StandardError
+            file
+          end
+          puts "  create  #{rel}"
+        end
+        puts ""
+        puts "完成！已创建 #{count} 个章节（从第 #{start} 章开始）"
+      end
+
+      # 扫描已有章节文件名开头的数字，返回下一个可用编号
+      def self.next_number(chapters_dir)
+        max = 0
+        return max + 1 unless chapters_dir.directory?
+
+        chapters_dir.children.each do |f|
+          next unless f.file? && f.extname == ".md"
+
+          n = f.basename.to_s[/\A(\d+)/, 1].to_i
+          max = n if n > max
+        end
+        max + 1
+      end
+    end
+  end
+end

data/lib/bindery/generators/project_generator.rb

@@ -2,23 +2,29 @@ require_relative "base"
 
 module Bindery
   module Generators
-    # bindery new <项目名>
-    # 生成一整套项目骨架：books/、templates/（样式+字体说明）、output/、
+    # bindery init
+    # 在当前目录就地生成一整套项目骨架：books/、templates/（样式）、output/、
     # config/bindery.yml（项目标记文件）、README、.gitignore、GitHub Actions
     class ProjectGenerator < Base
-      def self.call(project_name)
-        dest = Pathname.pwd + project_name
-        if dest.exist?
-          raise Bindery::Error, "目录已存在: #{dest}"
+      def self.call(project_name = Pathname.pwd.basename.to_s)
+        dest = Pathname.pwd
+        if (dest + "config/bindery.yml").file?
+          raise Bindery::Error, "当前目录已经是 bindery 项目（已存在 config/bindery.yml）"
         end
 
-        puts "创建项目: #{project_name}"
+        conflicts = ["books", "templates", "output", "README.md", ".gitignore",
+                     ".github/workflows/build.yml"]
+        existing = conflicts.select { |f| (dest + f).exist? }
+        unless existing.empty?
+          raise Bindery::Error, "以下文件/目录已存在，为避免覆盖，无法初始化：#{existing.join('、')}"
+        end
+
+        puts "初始化项目: #{project_name}"
         new(dest).generate(project_name)
         puts ""
         puts "完成！接下来："
-        puts "  cd #{project_name}"
-        puts "  bindery generate book lunyu \"论语\" --author \"孔子及弟子\""
-        puts "  bindery build lunyu"
+        puts "  bindery new book \"论语\" --author \"孔子及弟子\" --dynasty \"先秦\""
+        puts "  bindery build --all"
       end
 
       def generate(project_name)

data/lib/bindery/generators/templates/book/metadata.yaml.erb

@@ -1,9 +1,11 @@
 id: <%= id.inspect %>
 title: <%= title.inspect %>
 author: <%= author.inspect %>
-lang: zh-CN
+translator: <%= translator.inspect %>
+lang: <%= lang.inspect %>
 dynasty: <%= dynasty.inspect %>
 category: <%= category.inspect %>
-rights: 公共领域
-publisher: 再读经典
+isbn: <%= isbn.inspect %>
+rights: <%= rights.inspect %>
+publisher: <%= publisher.inspect %>
 cover: cover.jpg

data/lib/bindery/generators/templates/project/README.md.erb

@@ -5,10 +5,19 @@
 ## 常用命令
 
 ```bash
-# 新建一本书
-bindery generate book <书籍ID> "<书名>" --author "<作者>"
-# 简写
-bindery g book <书籍ID> "<书名>"
+# 新建一本书（ID 自动生成，可用 --id 指定；可带译者 / ISBN；--cover 自动生成封面）
+bindery new book "<书名>" --author "<作者>" --translator "<译者>" --isbn "<ISBN>" --cover
+# 一步到位建好章节（N = 正文章节数，封面/目录由构建自动生成）
+bindery new book "<书名>" chapter 20 --author "<作者>"
+
+# 卷式结构：每个卷在 EPUB 中独立成页（h2=卷名，h3=章名）
+bindery new volume <书籍ID> "<卷名>" --chapters <数量>
+
+# 单独批量创建章节（编号自动接续已有章节）
+bindery new chapter <书籍ID> <数量>
+
+# 单独生成封面
+bindery cover <书籍ID>
 
 # 构建一本书
 bindery build <书籍ID>
@@ -16,8 +25,24 @@ bindery build <书籍ID>
 # 批量构建全部
 bindery build --all
 
+# 构建前校验（不实际构建）
+bindery validate <书籍ID>
+bindery build <书籍ID> --check
+
+# 构建后用 epubcheck 校验
+bindery build <书籍ID> --epubcheck
+
 # 查看所有书籍状态
 bindery status
+
+# 监听书籍目录，改动自动重建
+bindery watch
+
+# 本地启动书库站点
+bindery serve
+
+# 清理构建产物
+bindery clean --all
 ```
 
 ## 目录结构

data/lib/bindery/generators/templates/project/gitignore

@@ -1,3 +1,2 @@
 /output/
-books.json
 .DS_Store

data/lib/bindery/generators/volume_generator.rb

@@ -0,0 +1,66 @@
+require "fileutils"
+require_relative "base"
+
+module Bindery
+  module Generators
+    # bindery new volume <book-id> <卷名> [--chapters N]
+    # 在书籍下创建一个卷目录（编号自动接续），可选批量创建卷内章节
+    class VolumeGenerator < Base
+      def self.call(book_id, volume_name, chapters: 0, project_root: Project.root!)
+        book = Bindery::Book.find(book_id, project_root)
+        volume_name = volume_name.to_s.strip
+        raise Bindery::Error, "卷名不能为空" if volume_name.empty?
+
+        if book.volumes.empty? && book.chapters.any?
+          warn "注意：chapters/ 下已有平铺章节文件（#{book.chapters.size} 个），卷式书构建时会忽略它们"
+        end
+
+        chapters_dir = book.chapters_dir
+        FileUtils.mkdir_p(chapters_dir) unless chapters_dir.directory?
+
+        n = next_volume_number(chapters_dir)
+        vol_dir = chapters_dir + format("%02d-%s", n, volume_name)
+        raise Bindery::Error, "卷目录已存在: #{vol_dir}" if vol_dir.exist?
+
+        chapters = chapters.to_i
+        raise Bindery::Error, "章节数必须是正整数" if chapters.negative?
+
+        FileUtils.mkdir_p(vol_dir)
+        puts "创建卷: #{volume_name}"
+        say_rel(vol_dir, trailing: "/")
+
+        chapters.times do |i|
+          file = vol_dir + format("%02d.md", i + 1)
+          file.write("# 第#{i + 1}章\n\n")
+          say_rel(file)
+        end
+
+        puts ""
+        summary = chapters.positive? ? "，含 #{chapters} 章" : ""
+        puts "完成！已创建卷 #{format('%02d', n)}（#{volume_name}）#{summary}"
+      end
+
+      def self.next_volume_number(chapters_dir)
+        max = 0
+        if chapters_dir.directory?
+          chapters_dir.children.each do |d|
+            next unless d.directory?
+
+            m = d.basename.to_s[/\A(\d+)/, 1]
+            max = m.to_i if m && m.to_i > max
+          end
+        end
+        max + 1
+      end
+
+      def self.say_rel(path, trailing: "")
+        rel = begin
+          path.relative_path_from(Pathname.pwd)
+        rescue StandardError
+          path
+        end
+        puts "  create  #{rel}#{trailing}"
+      end
+    end
+  end
+end

data/lib/bindery/image.rb

@@ -0,0 +1,64 @@
+module Bindery
+  # 读取 JPEG/PNG 图片尺寸（纯标准库实现，不依赖第三方 gem）
+  module Image
+    module_function
+
+    # 返回 [width, height]；无法识别格式时返回 nil
+    def dimensions(path)
+      return nil unless path.file?
+
+      head = path.binread(24)
+      if png?(head)
+        width  = head.byteslice(16, 4).unpack1("N")
+        height = head.byteslice(20, 4).unpack1("N")
+        [width, height]
+      elsif jpeg?(head)
+        jpeg_dimensions(path)
+      end
+    rescue StandardError
+      nil
+    end
+
+    def png?(head)
+      head.byteslice(0, 8) == "\x89PNG\r\n\x1a\n".b
+    end
+
+    def jpeg?(head)
+      head.byteslice(0, 2) == "\xFF\xD8".b
+    end
+
+    def jpeg_dimensions(path)
+      File.open(path, "rb") do |f|
+        f.read(2) # SOI
+        loop do
+          marker = f.read(2)
+          return nil if marker.nil? || marker.bytesize < 2
+          return nil unless marker.getbyte(0) == 0xFF
+
+          code = marker.getbyte(1)
+          # 跳过 0xFF 填充字节
+          while code == 0xFF
+            next_byte = f.read(1)
+            return nil if next_byte.nil?
+            code = next_byte.getbyte(0)
+          end
+
+          # SOF 段携带图片尺寸
+          if (0xC0..0xCF).cover?(code) && ![0xC4, 0xC8, 0xCC].include?(code)
+            f.read(2) # length
+            f.read(1) # precision
+            height = f.read(2).unpack1("n")
+            width  = f.read(2).unpack1("n")
+            return [width, height]
+          else
+            length = f.read(2).unpack1("n")
+            return nil if length.nil? || length < 2
+            f.read(length - 2)
+          end
+        end
+      end
+    rescue StandardError
+      nil
+    end
+  end
+end

data/lib/bindery/project.rb

@@ -1,4 +1,5 @@
 require "pathname"
+require "yaml"
 
 module Bindery
   # 负责在目录树中定位 bindery 项目根目录（含 config/bindery.yml 标记文件的目录）
@@ -21,7 +22,7 @@ module Bindery
       root(start_dir) || raise(
         Bindery::ProjectNotFoundError,
         "找不到 bindery 项目（未发现 #{MARKER}）。请在项目目录内执行，" \
-        "或先用 `bindery new <项目名>` 创建一个新项目。"
+        "或先用 `bindery init` 初始化一个项目。"
       )
     end
 
@@ -40,5 +41,14 @@ module Bindery
     def index_file(project_root = root!)
       project_root + "books.json"
     end
+
+    # 读取项目配置 config/bindery.yml（即项目标记文件本身），返回 Hash
+    # 文件缺失或解析失败时返回空 Hash，由调用方提供默认值
+    def config(project_root = root!)
+      path = project_root + MARKER
+      return {} unless path.file?
+
+      YAML.safe_load(path.read, permitted_classes: [Symbol]) || {}
+    end
   end
 end

data/lib/bindery/server.rb

@@ -0,0 +1,185 @@
+require "socket"
+require "uri"
+require "json"
+require "yaml"
+
+module Bindery
+  # 极简静态服务器：展示书库并提供 EPUB 下载。
+  # 仅用标准库 socket 实现（Ruby 3.0 起 WEBrick 已移出标准库）。
+  class Server
+    MIME = {
+      ".html" => "text/html; charset=utf-8",
+      ".json" => "application/json; charset=utf-8",
+      ".epub" => "application/epub+zip",
+      ".css"  => "text/css; charset=utf-8",
+      ".jpg"  => "image/jpeg",
+      ".jpeg" => "image/jpeg",
+      ".png"  => "image/png",
+      ".svg"  => "image/svg+xml",
+    }.freeze
+
+    def initialize(project_root, host: "127.0.0.1", port: 8000)
+      @project_root = project_root
+      @host = host
+      @port = port
+    end
+
+    def start
+      server = TCPServer.new(@host, @port)
+      puts "服务已启动: http://#{@host}:#{@port} （Ctrl-C 退出）"
+      loop do
+        client = server.accept
+        begin
+          respond(client)
+        rescue StandardError => e
+          warn "请求处理失败: #{e.message}"
+        ensure
+          begin
+            client.close
+          rescue StandardError
+            nil
+          end
+        end
+      end
+    rescue Interrupt
+      puts "\n服务已停止"
+    ensure
+      begin
+        server.close
+      rescue StandardError
+        nil
+      end
+    end
+
+    private
+
+    def respond(client)
+      request_line = client.gets
+      return unless request_line
+
+      method, raw_path, = request_line.split(" ")
+      # 丢弃其余请求头
+      while (line = client.gets)
+        break if line.nil? || line == "\r\n" || line == "\n"
+      end
+      return unless method == "GET" || method == "HEAD"
+
+      path = (URI::DEFAULT_PARSER.unescape(raw_path.split("?").first) rescue raw_path)
+      path = "/" if path.nil? || path.empty?
+      path = path.gsub("..", "") # 防目录穿越
+
+      case path
+      when "/", "/index.html"
+        body = index_html
+        send_response(client, 200, MIME[".html"], body, method)
+      when "/books.json"
+        serve_file(client, Project.index_file(@project_root), MIME[".json"], method)
+      when %r{\A/epub/([\w\-.]+\.epub)\z}
+        serve_file(client, Project.output_dir(@project_root) + "epub" + Regexp.last_match(1), MIME[".epub"], method)
+      when %r{\A/cover/([\w\-]+)\z}
+        serve_cover(client, Regexp.last_match(1), method)
+      else
+        not_found(client, method)
+      end
+    end
+
+    def index_html
+      index_file = Project.index_file(@project_root)
+      data = if index_file.file?
+               JSON.parse(index_file.read)
+             else
+               Bindery::Index.rebuild(@project_root)
+             end
+      books = data["books"] || []
+
+      rows = books.map do |b|
+        id = escape_html(b["id"].to_s)
+        title = escape_html(b["title"].to_s)
+        author = escape_html(b["author"].to_s)
+        epub_link = if b["epub"]
+                      %(<a href="/epub/#{id}.epub" download>下载 EPUB</a>)
+                    else
+                      "<em>未构建</em>"
+                    end
+        cover = %(<img src="/cover/#{id}" class="cover" alt="">)
+        "<li class=\"book\">#{cover}<div class=\"info\"><h2>#{title}</h2><p class=\"author\">#{author}</p>#{epub_link}</div></li>"
+      end.join("\n")
+
+      <<~HTML
+        <!doctype html>
+        <html lang="zh-CN">
+        <head>
+          <meta charset="utf-8">
+          <meta name="viewport" content="width=device-width, initial-scale=1">
+          <title>#{escape_html(@project_root.basename.to_s)} · 书库</title>
+          <style>
+            body { font-family: system-ui, -apple-system, sans-serif; max-width: 720px; margin: 2em auto; padding: 0 1em; color: #222; }
+            h1 { font-size: 1.6em; border-bottom: 1px solid #eee; padding-bottom: .4em; }
+            ul { list-style: none; padding: 0; }
+            .book { display: flex; gap: 1em; padding: 1em 0; border-bottom: 1px solid #f0f0f0; }
+            .cover { width: 64px; height: 96px; object-fit: cover; background: #f5f5f5; border-radius: 4px; }
+            .info h2 { margin: 0; font-size: 1.1em; }
+            .author { color: #666; margin: .3em 0 .5em; }
+            a { color: #b45309; }
+            em { color: #999; }
+          </style>
+        </head>
+        <body>
+          <h1>#{escape_html(@project_root.basename.to_s)} · 书库</h1>
+          <p>共 #{books.size} 本书</p>
+          <ul>#{rows}</ul>
+        </body>
+        </html>
+      HTML
+    end
+
+    def serve_cover(client, id, method)
+      book_dir = Project.books_dir(@project_root) + id
+      return not_found(client, method) unless book_dir.directory?
+
+      name = "cover.jpg"
+      meta_file = book_dir + "metadata.yaml"
+      if meta_file.file?
+        begin
+          meta = YAML.safe_load(meta_file.read, permitted_classes: [Symbol]) || {}
+          name = meta["cover"] || "cover.jpg"
+        rescue StandardError
+          nil
+        end
+      end
+
+      path = book_dir + name
+      path = (book_dir + "cover.jpg") unless path.file?
+      path = (book_dir + "cover.png") unless path.file?
+
+      serve_file(client, path, nil, method)
+    end
+
+    def serve_file(client, path, content_type, method)
+      return not_found(client, method) unless path.file?
+
+      body = path.binread
+      content_type ||= MIME[path.extname.downcase] || "application/octet-stream"
+      send_response(client, 200, content_type, body, method)
+    end
+
+    def not_found(client, method)
+      body = "<h1>404 Not Found</h1>"
+      send_response(client, 404, MIME[".html"], body, method)
+    end
+
+    def send_response(client, status, content_type, body, method)
+      reason = { 200 => "OK", 404 => "Not Found" }[status] || "OK"
+      headers = "HTTP/1.1 #{status} #{reason}\r\n" \
+                "Content-Type: #{content_type}\r\n" \
+                "Content-Length: #{body.bytesize}\r\n" \
+                "Connection: close\r\n\r\n"
+      client.write(headers)
+      client.write(body) unless method == "HEAD"
+    end
+
+    def escape_html(str)
+      str.gsub("&", "&amp;").gsub("<", "&lt;").gsub(">", "&gt;").gsub('"', "&quot;")
+    end
+  end
+end