修复 README 中翻译进度描述的笔误

.github/workflows/pages.yaml

@@ -4,7 +4,7 @@ name: Deploy Hugo site to Pages
 on:
   # Runs on pushes targeting the default branch
   push:
-    branches: ["hugo"]
+    branches: ["main"]
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
@@ -31,7 +31,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      HUGO_VERSION: 0.147.7
+      HUGO_VERSION: 0.155.3
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -41,7 +41,7 @@ jobs:
       - name: Setup Go
         uses: actions/setup-go@v5
         with:
-          go-version: '1.24'
+          go-version: '1.26'
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v4

.gitignore

@@ -5,4 +5,9 @@ __pycache__/
 tmp/
 output/
 public/
-.hugo_build.lock
+.hugo_build.lock
+.claude
+CLAUDE.md
+content/cn/
+zh.md
+en.md

assets/css/custom.css

@@ -0,0 +1,49 @@
+/* 调整左侧导航栏的宽度 */
+/* 增加宽度以确保文本不换行 */
+
+/* 左侧导航栏宽度调整 - 增加到 28rem 以避免换行 */
+.hextra-sidebar {
+  width: 28rem !important;
+  min-width: 28rem !important;
+}
+
+/* 确保导航内容正确显示 */
+.hextra-sidebar nav {
+  width: 100%;
+}
+
+/* 防止导航项文字换行 */
+.hextra-sidebar li {
+  white-space: nowrap;
+}
+
+.sidebar-container {
+    width: 20rem !important;
+    white-space: nowrap;
+}
+
+/* 确保导航链接不换行 */
+.hextra-sidebar a {
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  display: block;
+}
+
+/* 调整右侧页内目录（On This Page）的宽度 */
+/* Hextra 默认宽度约为 16rem (256px)，增加 1.5 倍变为 24rem (384px) */
+
+/* 右侧目录的宽度 */
+.hextra-toc {
+  width: 24rem !important;
+}
+
+/* 确保目录内容正确显示 */
+.hextra-toc nav {
+  width: 100%;
+}
+
+/* 调整目录项的文字换行以适应更宽的空间 */
+.hextra-toc li {
+  word-wrap: break-word;
+}

assets/css/example.css

@@ -0,0 +1,7 @@
+.md-example { margin: 1.25rem 0; padding: 1rem; border: 1px solid var(--border); border-radius: .75rem; }
+.md-example__caption { display: flex; gap: .5rem; align-items: baseline; margin-bottom: .5rem; }
+.md-example__label { font-weight: 600; opacity: .85; }
+.md-example__title { font-weight: 600; }
+.md-example__anchor { margin-left: auto; text-decoration: none; opacity: .6; }
+.md-example__anchor:hover { opacity: 1; }
+.md-example__note { margin-top: .5rem; font-size: .95em; opacity: .85; }

bin/epub

@@ -1,12 +1,20 @@
 #!/usr/bin/env bash
 
+set -e
+
 # Set the directory containing Markdown files
 SCRIPT_DIR=$(dirname "$0")
 INPUT_DIR=$(cd "$(dirname "$SCRIPT_DIR")" && pwd)
 OUTPUT_DIR="$INPUT_DIR/output"
+TEMP_DIR="$OUTPUT_DIR/temp"
 
 # Create output directory if it doesn't exist
 mkdir -p "$OUTPUT_DIR"
+mkdir -p "$TEMP_DIR"
+
+# Preprocess Markdown files to convert Hugo shortcodes
+echo "Preprocessing Markdown files..."
+python3 "${SCRIPT_DIR}/preprocess-epub.py" "${INPUT_DIR}/content/zh" "$TEMP_DIR"
 
 convert_to_epub() {
 	# convert all EPUB files into a single EPUB book
@@ -24,28 +32,32 @@ convert_to_epub() {
 		--css="$css_file" \
 		--webtex \
 		--wrap=preserve \
-		"${INPUT_DIR}"/SUMMARY.md \
-		"${INPUT_DIR}"/README.md \
-		"${INPUT_DIR}"/preface.md \
-		"${INPUT_DIR}"/part-i.md \
-		"${INPUT_DIR}"/ch1.md \
-		"${INPUT_DIR}"/ch2.md \
-		"${INPUT_DIR}"/ch3.md \
-		"${INPUT_DIR}"/ch4.md \
-		"${INPUT_DIR}"/part-ii.md \
-		"${INPUT_DIR}"/ch5.md \
-		"${INPUT_DIR}"/ch6.md \
-		"${INPUT_DIR}"/ch7.md \
-		"${INPUT_DIR}"/ch8.md \
-		"${INPUT_DIR}"/ch9.md \
-		"${INPUT_DIR}"/part-iii.md \
-		"${INPUT_DIR}"/ch10.md \
-		"${INPUT_DIR}"/ch11.md \
-		"${INPUT_DIR}"/ch12.md \
-		"${INPUT_DIR}"/colophon.md \
-		"${INPUT_DIR}"/glossary.md
+		"${TEMP_DIR}"/_index.md \
+		"${TEMP_DIR}"/preface.md \
+		"${TEMP_DIR}"/part-i.md \
+		"${TEMP_DIR}"/ch1.md \
+		"${TEMP_DIR}"/ch2.md \
+		"${TEMP_DIR}"/ch3.md \
+		"${TEMP_DIR}"/ch4.md \
+		"${TEMP_DIR}"/part-ii.md \
+		"${TEMP_DIR}"/ch5.md \
+		"${TEMP_DIR}"/ch6.md \
+		"${TEMP_DIR}"/ch7.md \
+		"${TEMP_DIR}"/ch8.md \
+		"${TEMP_DIR}"/ch9.md \
+		"${TEMP_DIR}"/part-iii.md \
+		"${TEMP_DIR}"/ch10.md \
+		"${TEMP_DIR}"/ch11.md \
+		"${TEMP_DIR}"/ch12.md \
+		"${TEMP_DIR}"/ch13.md \
+		"${TEMP_DIR}"/ch14.md \
+		"${TEMP_DIR}"/colophon.md \
+		"${TEMP_DIR}"/glossary.md
 
 	echo "Converted EPUB book created at $OUTPUT_BOOK."
 }
 
 convert_to_epub
+
+# Clean up temporary files
+rm -rf "$TEMP_DIR"

bin/preprocess-epub.py

@@ -0,0 +1,111 @@
+#!/usr/bin/env python3
+"""
+预处理 Markdown 文件，将 Hugo shortcode 转换为 Pandoc 可识别的格式
+
+处理两种 shortcode：
+1. {{< figure src="/fig/xxx.png" caption="xxx" >}} → ![xxx](static/fig/xxx.png)
+2. {{< figure ... >}} (无 src) → 移除（通常用于代码示例）
+"""
+
+import os
+import re
+import sys
+from pathlib import Path
+
+FIGURE_SHORTCODE_RE = re.compile(r"\{\{<\s*figure\b(.*?)>\}\}", re.DOTALL)
+ATTR_RE = re.compile(r'([\w-]+)="([^"]*)"')
+ABS_IMAGE_RE = re.compile(r'!\[([^\]]*)\]\(/(?!static/)([^)]+)\)')
+
+
+def _escape_alt_text(text):
+    """Escape `]` in alt text to avoid breaking Markdown image syntax."""
+    return text.replace("]", r"\]")
+
+
+def convert_markdown(text):
+    """
+    转换 Hugo figure shortcode 和绝对路径图片引用。
+
+    Args:
+        text: Markdown 文本内容
+
+    Returns:
+        转换后的文本
+    """
+    def replace_figure_shortcode(match):
+        attrs_text = match.group(1)
+        attrs = dict(ATTR_RE.findall(attrs_text))
+        src = attrs.get("src")
+
+        # 没有 src 的 figure 一般是代码示例占位，直接移除
+        if not src:
+            return ""
+
+        # 绝对路径资源转为相对 static 路径，便于 Pandoc 打包
+        if src.startswith('/'):
+            src = 'static' + src
+
+        # 优先 caption，fallback 到 title，至少保证图片可渲染
+        alt = _escape_alt_text(attrs.get("caption") or attrs.get("title") or "")
+        return f'![{alt}]({src})'
+
+    text = FIGURE_SHORTCODE_RE.sub(replace_figure_shortcode, text)
+
+    # 把 Markdown 里的绝对路径图片 ![](/map/ch01.png) 转为 static/map/ch01.png
+    text = ABS_IMAGE_RE.sub(r'![\1](static/\2)', text)
+
+    return text
+
+def process_file(input_path, output_path):
+    """
+    处理单个 Markdown 文件
+
+    Args:
+        input_path: 输入文件路径
+        output_path: 输出文件路径
+    """
+    with open(input_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+
+    # 转换内容
+    converted_content = convert_markdown(content)
+
+    # 写入输出文件
+    os.makedirs(os.path.dirname(output_path), exist_ok=True)
+    with open(output_path, 'w', encoding='utf-8') as f:
+        f.write(converted_content)
+
+    print(f"Processed: {input_path} -> {output_path}")
+
+def main():
+    """主函数"""
+    if len(sys.argv) < 2:
+        print("Usage: preprocess.py <input_file> [output_file]")
+        print("   or: preprocess.py <input_dir> <output_dir>")
+        sys.exit(1)
+
+    input_path = sys.argv[1]
+
+    if os.path.isfile(input_path):
+        # 处理单个文件
+        output_path = sys.argv[2] if len(sys.argv) > 2 else input_path
+        process_file(input_path, output_path)
+    elif os.path.isdir(input_path):
+        # 处理目录
+        output_dir = sys.argv[2]
+        input_dir = Path(input_path)
+
+        # 获取所有 .md 文件
+        md_files = sorted(input_dir.glob('*.md'))
+
+        for md_file in md_files:
+            output_file = os.path.join(output_dir, md_file.name)
+            process_file(str(md_file), output_file)
+
+        print(f"\nTotal processed: {len(md_files)} files")
+    else:
+        print(f"Error: {input_path} is not a valid file or directory")
+        sys.exit(1)
+
+if __name__ == '__main__':
+    main()