Improve code quality and translations

Author: yeasy

cmd/chapter_pipeline.go

@@ -412,7 +412,7 @@ func (p *ChapterPipeline) ProcessWithOptions(ctx context.Context, options Chapte
 			Content:      htmlContent,
 			ChapterIndex: i,
 			ChapterFile:  chDef.File,
-			Metadata:     make(map[string]interface{}),
+			Metadata:     make(map[string]any),
 		}
 		if err := p.PluginManager.RunHook(hookCtx); err != nil {
 			p.Logger.Warn("AfterParse plugin hook failed", slog.String("file", chDef.File), slog.String("error", err.Error()))

cmd/root.go

@@ -13,7 +13,7 @@ import (
 
 var (
 	// Version is overridden at build time via -ldflags.
-	Version = "0.6.1"
+	Version = "0.6.2"
 	// BuildTime is overridden at build time via -ldflags.
 	BuildTime = "unknown"
 	// rootCmd is the root command for the mdpress application.

examples/chapter01/README.md

@@ -1,73 +1,65 @@
-# 第一章 快速开始 / Chapter 1: Quick Start
+# Chapter 1: Quick Start
 
-本章将帮助你快速上手 mdpress，从安装到生成第一本 PDF 图书。
+This chapter helps you get started with mdpress, from installation to generating your first PDF book.
 
-*This chapter helps you get started with mdpress, from installation to generating your first PDF book.*
+## 1.1 Installation
 
-## 1.1 安装 / Installation
+### Install with Go
 
-### 使用 Go 安装 / Install with Go
-
-确保你已安装 Go 1.21 或更高版本，然后运行：
-
-*Ensure you have Go 1.21 or later installed, then run:*
+Ensure you have Go 1.25 or later installed, then run:
 
 ```bash
 go install github.com/yeasy/mdpress@latest
 ```
 
-### 从源码编译 / Build from Source
+### Build from Source
 
 ```bash
 git clone https://github.com/yeasy/mdpress.git
 cd mdpress
 make build
 ```
 
-### 前置依赖 / Prerequisites
-
-mdpress 使用 Chromium 进行 PDF 渲染，请确保系统中已安装：
+### Prerequisites
 
-*mdpress uses Chromium for PDF rendering. Ensure the following is installed:*
+mdpress uses Chromium for PDF rendering. Ensure the following is installed:
 
-- **macOS**: `brew install chromium` 或安装 Google Chrome / or install Google Chrome
+- **macOS**: `brew install chromium` or install Google Chrome
 - **Ubuntu/Debian**: `apt install chromium-browser`
-- **Windows**: 安装 Google Chrome / Install Google Chrome
+- **Windows**: Install Google Chrome
 
-## 1.2 初始化项目 / Initialize a Project
+## 1.2 Initialize a Project
 
-在你的图书目录下运行 / Run in your book directory:
+Run in your book directory:
 
 ```bash
 mdpress init
 ```
 
-这将创建以下文件结构 / This creates the following file structure:
+This creates the following file structure:
 
 ```
 my-book/
-├── book.yaml          # 配置文件 / Config file
-├── preface.md         # 前言 / Preface
+├── book.yaml          # Config file
+├── preface.md         # Preface
 └── chapter01/
-    └── README.md      # 第一章 / Chapter 1
+    └── README.md      # Chapter 1
 ```
 
-## 1.3 编写内容 / Write Content
+## 1.3 Write Content
 
-使用你喜欢的编辑器编辑 Markdown 文件。mdpress 完整支持 GitHub Flavored Markdown（GFM），包括：
+Edit Markdown files with your favorite editor. mdpress fully supports GitHub Flavored Markdown (GFM), including:
 
-*Edit Markdown files with your favorite editor. mdpress fully supports GFM, including:*
+### Tables
 
-### 表格 / Tables
+| Feature | Supported | Description |
+|---------|-----------|-------------|
+| Tables | ✅ | GFM table syntax |
+| Task lists | ✅ | `- [x]` syntax |
+| Footnotes | ✅ | `[^1]` syntax |
+| Code highlighting | ✅ | Multi-language support |
 
-| 功能 / Feature | 支持 / Supported | 说明 / Description |
-|------|---------|------|
-| 表格 / Tables | ✅ | GFM 表格语法 / GFM table syntax |
-| 任务列表 / Task lists | ✅ | `- [x]` 语法 / `- [x]` syntax |
-| 脚注 / Footnotes | ✅ | `[^1]` 语法 / `[^1]` syntax |
-| 代码高亮 / Code highlighting | ✅ | 多语言支持 / Multi-language support |
-
-### 代码高亮 / Code Highlighting
+### Code Highlighting
 
 ```go
 package main
@@ -81,37 +73,33 @@ func main() {
 
 ```python
 def hello():
-    """mdpress 支持多种编程语言的语法高亮 / mdpress supports syntax highlighting for many languages"""
+    """mdpress supports syntax highlighting for many languages"""
     print("Hello, mdpress!")
 ```
 
-### 任务列表 / Task Lists
+### Task Lists
 
-- [x] 安装 mdpress / Install mdpress
-- [x] 创建项目结构 / Create project structure
-- [ ] 编写内容 / Write content
-- [ ] 生成 PDF / Generate PDF
+- [x] Install mdpress
+- [x] Create project structure
+- [ ] Write content
+- [ ] Generate PDF
 
-## 1.4 生成 PDF / Generate PDF
+## 1.4 Generate PDF
 
-一切就绪后，运行构建命令 / When everything is ready, run:
+When everything is ready, run:
 
 ```bash
 mdpress build
 ```
 
-或指定配置文件 / Or specify a config file:
+Or specify a config file:
 
 ```bash
 mdpress build --config path/to/book.yaml
 ```
 
-生成的 PDF 文件将保存到配置文件中 `output.filename` 指定的路径。
-
-*The generated PDF will be saved to the path specified in `output.filename` in the config file.*
-
-## 1.5 小结 / Summary
+The generated PDF will be saved to the path specified in `output.filename` in the config file.
 
-恭喜！你已经成功生成了第一本 PDF 图书。接下来，请阅读第二章了解更多进阶功能。
+## 1.5 Summary
 
-*Congratulations! You have successfully generated your first PDF book. Read Chapter 2 for more advanced features.*
+Congratulations! You have successfully generated your first PDF book. Read Chapter 2 for more advanced features.

examples/chapter02/README.md

@@ -1,27 +1,25 @@
-# 第二章 进阶用法 / Chapter 2: Advanced Usage
+# Chapter 2: Advanced Usage
 
-本章介绍 mdpress 的高级功能，帮助你打造专业级的 PDF 图书。
+This chapter covers advanced mdpress features for creating professional-grade PDF books.
 
-*This chapter covers advanced mdpress features for creating professional-grade PDF books.*
+## 2.1 Custom Themes
 
-## 2.1 自定义主题 / Custom Themes
+mdpress comes with three built-in themes:
 
-mdpress 内置三套主题 / mdpress comes with three built-in themes:
+- **technical**: Technical docs style, ideal for programming books
+- **elegant**: Elegant literary style, ideal for literary works
+- **minimal**: Minimalist style, ideal for notes and memos
 
-- **technical**：技术文档风格，适合编程书籍 / Technical docs style, ideal for programming books
-- **elegant**：优雅文学风格，适合文学作品 / Elegant literary style, ideal for literary works
-- **minimal**：极简风格，适合笔记和备忘录 / Minimalist style, ideal for notes and memos
-
-在 `book.yaml` 中切换主题 / Switch themes in `book.yaml`:
+Switch themes in `book.yaml`:
 
 ```yaml
 style:
   theme: "elegant"
 ```
 
-### 创建自定义主题 / Creating Custom Themes
+### Creating Custom Themes
 
-你也可以创建自己的主题文件（YAML 格式）/ You can create your own theme file (YAML format):
+You can create your own theme file (YAML format):
 
 ```yaml
 name: my-theme
@@ -34,32 +32,32 @@ colors:
   link: "#2980b9"
 ```
 
-## 2.2 交叉引用 / Cross References
+## 2.2 Cross References
 
-mdpress 支持图表和章节的交叉引用。/ mdpress supports cross-referencing of figures, tables, and sections.
+mdpress supports cross-referencing of figures, tables, and sections.
 
-### 图片引用 / Figure References
+### Figure References
 
 ```markdown
-![图片标题 / Figure caption](image.png){#fig:architecture}
+![Figure caption](image.png){#fig-architecture}
 
-如 {{ref:fig:architecture}} 所示... / As shown in {{ref:fig:architecture}}...
+As shown in {{ref:fig-architecture}}...
 ```
 
-### 表格引用 / Table References
+### Table References
 
 ```markdown
-| 列1 / Col1 | 列2 / Col2 |
-|-----|-----|
-| a   | b   |
-{#tab:comparison}
+| Col1 | Col2 |
+|------|------|
+| a    | b    |
+{#tab-comparison}
 
-详见 {{ref:tab:comparison}}。/ See {{ref:tab:comparison}}.
+See {{ref:tab-comparison}}.
 ```
 
-## 2.3 多文件组织 / Multi-file Organization
+## 2.3 Multi-file Organization
 
-对于大型图书项目，建议按章节组织文件 / For large book projects, organize files by chapter:
+For large book projects, organize files by chapter:
 
 ```
 my-book/
@@ -79,38 +77,34 @@ my-book/
     └── references.md
 ```
 
-## 2.4 页眉页脚 / Headers & Footers
+## 2.4 Headers & Footers
 
-自定义页眉页脚支持模板变量 / Custom headers and footers support template variables:
+Custom headers and footers support template variables:
 
-| 变量 / Variable | 说明 / Description |
-|------|------|
-| `{{.Book.Title}}` | 书名 / Book title |
-| `{{.Book.Author}}` | 作者 / Author |
-| `{{.Chapter.Title}}` | 当前章节标题 / Current chapter title |
-| `{{.PageNum}}` | 当前页码 / Current page number |
+| Variable | Description |
+|----------|-------------|
+| `{{.Book.Title}}` | Book title |
+| `{{.Book.Author}}` | Author |
+| `{{.Chapter.Title}}` | Current chapter title |
+| `{{.PageNum}}` | Current page number |
 
-配置示例 / Configuration example:
+Configuration example:
 
 ```yaml
 style:
   header:
     left: "{{.Book.Title}}"
     right: "{{.Chapter.Title}}"
   footer:
-    center: "第 {{.PageNum}} 页 / Page {{.PageNum}}"
+    center: "Page {{.PageNum}}"
 ```
 
-## 2.5 脚注 / Footnotes[^1]
-
-mdpress 完整支持 Markdown 脚注语法，脚注会自动编号并在页面底部或章节末尾显示。
-
-*mdpress fully supports Markdown footnote syntax. Footnotes are automatically numbered and displayed at the bottom of the page or end of the chapter.*
+## 2.5 Footnotes[^1]
 
-[^1]: 这是一个脚注示例。/ This is a footnote example.
+mdpress fully supports Markdown footnote syntax. Footnotes are automatically numbered and displayed at the bottom of the page or end of the chapter.
 
-## 2.6 小结 / Summary
+[^1]: This is a footnote example.
 
-通过本章的学习，你已经掌握了 mdpress 的大部分高级功能。更多详细信息请参阅项目文档。
+## 2.6 Summary
 
-*After this chapter, you have mastered most of the advanced features of mdpress. For more details, refer to the project documentation.*
+After this chapter, you have mastered most of the advanced features of mdpress. For more details, refer to the project documentation.

examples/plugins/word-count/main.go

@@ -29,12 +29,12 @@ import (
 
 // Request mirrors plugin.ExternalPluginRequest.
 type Request struct {
-	Phase        string                 `json:"phase"`
-	Content      string                 `json:"content"`
-	ChapterIndex int                    `json:"chapter_index"`
-	ChapterFile  string                 `json:"chapter_file"`
-	Config       map[string]interface{} `json:"config"`
-	Metadata     map[string]interface{} `json:"metadata"`
+	Phase        string         `json:"phase"`
+	Content      string         `json:"content"`
+	ChapterIndex int            `json:"chapter_index"`
+	ChapterFile  string         `json:"chapter_file"`
+	Config       map[string]any `json:"config"`
+	Metadata     map[string]any `json:"metadata"`
 }
 
 // Response mirrors plugin.ExternalPluginResponse.

internal/config/bookjson.go

@@ -14,14 +14,14 @@ import (
 // bookJSON is the raw structure of a GitBook book.json file.
 // Only fields relevant to mdPress are decoded; unknown fields are silently ignored.
 type bookJSON struct {
-	Title       string                            `json:"title"`
-	Author      jsonStringOrSlice                 `json:"author"`
-	Description string                            `json:"description"`
-	Language    string                            `json:"language"`
-	GitBook     string                            `json:"gitbook"`
-	Plugins     []string                          `json:"plugins"`
-	PluginsCfg  map[string]map[string]interface{} `json:"pluginsConfig"`
-	Structure   bookJSONStructure                 `json:"structure"`
+	Title       string                    `json:"title"`
+	Author      jsonStringOrSlice         `json:"author"`
+	Description string                    `json:"description"`
+	Language    string                    `json:"language"`
+	GitBook     string                    `json:"gitbook"`
+	Plugins     []string                  `json:"plugins"`
+	PluginsCfg  map[string]map[string]any `json:"pluginsConfig"`
+	Structure   bookJSONStructure         `json:"structure"`
 }
 
 // bookJSONStructure holds optional overrides for well-known GitBook file paths.
@@ -208,7 +208,7 @@ func normalizeLanguage(lang string) string {
 
 // convertBookJSONPlugins maps GitBook plugin entries to PluginConfig values.
 // Entries prefixed with "-" are disabled in GitBook and are skipped here.
-func convertBookJSONPlugins(names []string, cfgs map[string]map[string]interface{}) []PluginConfig {
+func convertBookJSONPlugins(names []string, cfgs map[string]map[string]any) []PluginConfig {
 	if len(names) == 0 {
 		return nil
 	}
@@ -221,7 +221,7 @@ func convertBookJSONPlugins(names []string, cfgs map[string]map[string]interface
 		p := PluginConfig{Name: name}
 		if cfgs != nil {
 			if extra, ok := cfgs[name]; ok {
-				p.Config = make(map[string]interface{}, len(extra))
+				p.Config = make(map[string]any, len(extra))
 				for k, v := range extra {
 					p.Config[k] = v
 				}

internal/config/discover.go

@@ -367,7 +367,7 @@ func ExtractReadmeMetadata(ctx context.Context, path string) ReadmeMetadata {
 	content := allText.String()
 
 	// Determine book title: try to find a meaningful title that is NOT just
-	// a generic heading like "前言" or "Preface".
+	// a generic heading like "Preface" or "Introduction".
 	meta.Title = inferBookTitle(h1Title, content, filepath.Dir(path))
 
 	// Detect language from content.

internal/config/summary.go

@@ -1,14 +1,14 @@
 // summary.go parses chapter structure from SUMMARY.md.
 // SUMMARY.md uses Markdown link lists to define chapter order in a GitBook-compatible format.
 //
-// 格式示例：
+// Format example:
 //
 //	# Summary
 //
-//	* [前言](preface.md)
-//	* [第一章](chapter01/README.md)
-//	  * [1.1 小节](chapter01/section01.md)
-//	* [第二章](chapter02/README.md)
+//	* [Preface](preface.md)
+//	* [Chapter 1](chapter01/README.md)
+//	  * [Section 1.1](chapter01/section01.md)
+//	* [Chapter 2](chapter02/README.md)
 package config
 
 import (