bindery-cli 0.1.1 → 0.2.1

data/lib/bindery/generators/book_generator.rb

@@ -1,28 +1,44 @@
+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 })
+        template("book", "chapters/chapter-0001.md", locals: { title: title })
       end
     end
   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> <数量>
+    # 在指定书籍里批量创建章节文件，编号自动接续已有章节（chapter-0001.md 之后是 chapter-0002.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("chapter-%04d.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
+
+      # 扫描已有章节文件名中的编号（chapter-0001），返回下一个可用编号
+      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[/\Achapter-(\d+)/, 1]
+          max = n.to_i if n && n.to_i > 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/chapters/{01-chapter.md.erb → chapter-0001.md.erb}

@@ -1,6 +1,7 @@
-# 第一章
+### 第一章
 
 《<%= title %>》正文从这里开始……
 
+标题层级约定：书名 = h1（由 metadata 提供），卷名 = h2，章名 = h3。
 在 chapters/ 目录下按顺序添加更多章节文件（如 02-xxx.md, 03-xxx.md），
 文件名的字典序决定了它们在成书中的先后顺序。

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,22 @@
 ## 常用命令
 
 ```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> <数量>
+
+# 按标题自动更新章节文件名（chapter-0001-标题.md）
+bindery rename chapters <书籍ID>
+
+# 单独生成封面
+bindery cover <书籍ID>
 
 # 构建一本书
 bindery build <书籍ID>
@@ -16,8 +28,27 @@ bindery build <书籍ID>
 # 批量构建全部
 bindery build --all
 
+# 构建前校验（不实际构建）
+bindery validate <书籍ID>
+bindery build <书籍ID> --check
+
+# 构建后用 epubcheck 校验
+bindery build <书籍ID> --epubcheck
+
 # 查看所有书籍状态
 bindery status
+
+# 监听书籍目录，改动自动重建
+bindery watch
+
+# 本地启动书库站点
+bindery serve
+
+# 打开 Web 封面生成器（自动填充书籍信息）
+bindery web
+
+# 清理构建产物
+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,62 @@
+require "fileutils"
+require_relative "base"
+
+module Bindery
+  module Generators
+    # bindery new volume <book-id> <卷名> [--chapters N]
+    # 在书籍下创建一个平铺卷文件（卷01-学而.md），卷结构由标题层级定义：
+    #   ## 卷名（h2）
+    #   ### 第1章（h3）
+    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?
+
+        chapters_dir = book.chapters_dir
+        FileUtils.mkdir_p(chapters_dir) unless chapters_dir.directory?
+
+        n = next_volume_number(chapters_dir)
+        file = chapters_dir + format("卷%02d-%s.md", n, volume_name)
+        raise Bindery::Error, "卷文件已存在: #{file}" if file.exist?
+
+        chapters = chapters.to_i
+        raise Bindery::Error, "章节数必须是正整数" if chapters.negative?
+
+        content = +"## #{volume_name}\n\n"
+        chapters.times do |i|
+          content << "### 第#{i + 1}章\n\n"
+        end
+        file.write(content)
+
+        puts "创建卷: #{volume_name}"
+        say_rel(file)
+        puts ""
+        summary = chapters.positive? ? "，含 #{chapters} 章" : ""
+        puts "完成！已创建卷 #{format('%02d', n)}（#{volume_name}）#{summary}"
+      end
+
+      def self.next_volume_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"
+
+          m = f.basename.to_s[/\A卷(\d+)/, 1]
+          max = m.to_i if m && m.to_i > max
+        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/renamer.rb

@@ -0,0 +1,57 @@
+module Bindery
+  # 根据章节 md 里的首个标题，自动把文件名更新为 chapter-xxxx-标题.md
+  module Renamer
+    module_function
+
+    # 返回重命名的文件数
+    def rename_chapters(book)
+      dir = book.chapters_dir
+      return 0 unless dir.directory?
+
+      renamed = 0
+      dir.children.select { |f| f.file? && f.extname == ".md" }.sort.each do |f|
+        base = f.basename.to_s
+        m = base.match(/\A(chapter-\d+)(?:-.*)?\.md\z/)
+        next unless m
+
+        title = extract_title(f)
+        next if title.nil? || title.empty?
+
+        safe = sanitize(title)
+        new_name = "#{m[1]}-#{safe}.md"
+        next if new_name == base
+
+        new_path = f.dirname + new_name
+        raise Bindery::Error, "目标文件已存在: #{new_path}" if new_path.exist?
+
+        File.rename(f, new_path)
+        renamed += 1
+        puts "  rename  #{base} -> #{new_name}"
+      end
+      renamed
+    end
+
+    # 取文件里的首个 ATX 标题文本
+    def extract_title(path)
+      path.each_line do |line|
+        next unless line =~ /^(\#{1,6})\s+(.+)$/
+
+        title = Regexp.last_match(2).sub(/\s*#+\s*$/, "").strip
+        return title unless title.empty?
+      end
+      nil
+    end
+
+    # 清理标题里的非法文件名字符，跨平台安全（Windows 也兼容）
+    def sanitize(text)
+      s = text
+        .gsub(/[\\\/:*?"<>|\r\n\t]/, "-")
+        .gsub(/\s+/, "-")
+        .gsub(/-+/, "-")
+        .gsub(/\A-+|-\z/, "")
+        .gsub(/\A\.+|\.+\z/, "")
+      s = "章节" if s.empty?
+      s[0, 40]
+    end
+  end
+end

data/lib/bindery/server.rb

@@ -0,0 +1,238 @@
+require "socket"
+require "uri"
+require "json"
+require "yaml"
+require "base64"
+require "pathname"
+
+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
+
+    # 封面编辑器页面（随 gem 一起打包）
+    ASSETS_DIR = Pathname.new(__dir__) + "assets"
+
+    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(" ")
+      # 读取请求头，POST 需要 Content-Length
+      content_length = 0
+      while (line = client.gets)
+        break if line.nil? || line == "\r\n" || line == "\n"
+        if line =~ /\AContent-Length:\s*(\d+)/i
+          content_length = Regexp.last_match(1).to_i
+        end
+      end
+
+      path = (URI::DEFAULT_PARSER.unescape(raw_path.split("?").first) rescue raw_path)
+      path = "/" if path.nil? || path.empty?
+      path = path.gsub("..", "") # 防目录穿越
+
+      if method == "POST" && path == "/cover/save"
+        save_cover(client, content_length)
+        return
+      end
+      return unless method == "GET" || method == "HEAD"
+
+      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 "/cover"
+        serve_file(client, ASSETS_DIR + "index.html", MIME[".html"], 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: 102px; 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
+
+    # 保存封面编辑器生成的 PNG 到书籍目录，并更新 metadata 的 cover 字段
+    def save_cover(client, content_length)
+      body = client.read(content_length).to_s
+      return send_json(client, 400, { ok: false, error: "请求体为空" }) if body.empty?
+
+      data = JSON.parse(body)
+      book_id = data["book"].to_s
+      data_url = data["data"].to_s
+
+      book_dir = Project.books_dir(@project_root) + book_id
+      return send_json(client, 404, { ok: false, error: "书籍不存在: #{book_id}" }) unless book_dir.directory?
+
+      b64 = data_url.sub(/\Adata:image\/\w+;base64,/, "")
+      png = Base64.decode64(b64)
+      path = book_dir + "cover.png"
+      path.binwrite(png)
+
+      meta_file = book_dir + "metadata.yaml"
+      if 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
+
+      send_json(client, 200, { ok: true, path: "books/#{book_id}/cover.png" })
+    rescue JSON::ParserError => e
+      send_json(client, 400, { ok: false, error: "JSON 解析失败: #{e.message}" })
+    end
+
+    def send_json(client, status, hash)
+      send_response(client, status, MIME[".json"], JSON.generate(hash), "POST")
+    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