release: 发布 v0.5.1

新增能力：内置 4 套红头、3 套正式文档和 3 套标书主题，支持主题推荐页边距、页面装饰、页眉页脚和页码；增加结构化公文、项目报告及标书 Front Matter，内置 Fandol 中文字体、两份教程和 14 份主题示例。桌面工作流：重组更多菜单，增加新建、保存、另存为快捷键和未保存确认；另存为后跟随新路径，主题示例自动切换主题，Desktop 发行包完整携带教程、示例与字体。问题修复：修正红头标题居中与正式文档字体；围栏代码按正文宽度自动换行，长内容安全断行，至少两行即可在当前页分页，并统一保留 8px 左侧内容留白；Docker Web 镜像正确打包 samples。兼容与部署：未声明主题推荐设置时继续使用 16mm 默认页边距；Web 隐藏不适用的另存为。正式镜像 yixiong/md-to-pdf:v0.5.1 内容 ID 为 sha256:72f519a69bfd6cb2f6df30c2be938e58ceb6f20e4748a32551874de3d436b276，Compose 健康运行。验证结果：最终修复前 65 个测试文件、286 项测试通过，最终代码块与主题定向测试 27 项通过；全项目类型检查、生产构建和 git diff --check 通过。容器检出 14 套主题、17 份 Markdown，代码块回归 PDF 为 2 页且无越界。NSIS SHA-256 为 676CCE73D782B0B15AC6BC68F253CFBC4740383583E4DAA98F746EDF9999C5CC，ZIP SHA-256 为 82BF6ADF1200604F145CC86FA3ED193955CF6741EBEE3DF8953483515CFF621F。
2026-07-29 16:58:17 +08:00
parent 58087d0c7e
commit 83e6559c2c
111 changed files with 8274 additions and 173 deletions
@@ -0,0 +1,141 @@
+// @vitest-environment happy-dom
+
+import { describe, expect, it } from "vitest";
+import { prepareCodeBlockPagination } from "../src/code-block-pagination.js";
+
+function createRoot(codeHtml: string) {
+  const root = document.createElement("article");
+  root.innerHTML = `<pre class="md-fences"><code>${codeHtml}</code></pre>`;
+  return root;
+}
+
+function getGroups(root: ParentNode) {
+  return Array.from(
+    root.querySelectorAll<HTMLElement>(".md-code-line-group")
+  );
+}
+
+function getLines(root: ParentNode) {
+  return Array.from(
+    root.querySelectorAll<HTMLElement>(".md-code-line")
+  );
+}
+
+function getChunks(root: ParentNode) {
+  return Array.from(
+    root.querySelectorAll<HTMLElement>(".md-code-pagination-chunk")
+  );
+}
+
+describe("代码块分页预处理", () => {
+  it("偶数行按两行分组", () => {
+    const root = createRoot("line-1\nline-2\nline-3\nline-4\n");
+
+    prepareCodeBlockPagination(root);
+
+    expect(getGroups(root).map((group) => group.children.length)).toEqual([
+      2,
+      2
+    ]);
+    expect(getLines(root).map((line) => line.textContent)).toEqual([
+      "line-1",
+      "line-2",
+      "line-3",
+      "line-4"
+    ]);
+    expect(
+      getChunks(root).map((chunk) =>
+        chunk.getAttribute("data-code-pagination-position")
+      )
+    ).toEqual(["first", "last"]);
+  });
+
+  it("奇数行将最后三行合组并保留单行代码块", () => {
+    const oddRoot = createRoot(
+      "line-1\nline-2\nline-3\nline-4\nline-5\n"
+    );
+    const singleRoot = createRoot("only-line\n");
+
+    prepareCodeBlockPagination(oddRoot);
+    prepareCodeBlockPagination(singleRoot);
+
+    expect(
+      getGroups(oddRoot).map((group) => group.children.length)
+    ).toEqual([2, 3]);
+    expect(
+      getGroups(singleRoot).map((group) => group.children.length)
+    ).toEqual([1]);
+    expect(
+      getChunks(singleRoot)[0]?.getAttribute(
+        "data-code-pagination-position"
+      )
+    ).toBe("only");
+  });
+
+  it("跨行克隆语法高亮结构并保留空行", () => {
+    const root = createRoot(
+      '<span class="hljs-string">first\nsecond</span>\n\n' +
+        '<span class="hljs-keyword">return</span> value;\n'
+    );
+
+    prepareCodeBlockPagination(root);
+
+    const lines = getLines(root);
+    expect(lines.map((line) => line.textContent)).toEqual([
+      "first",
+      "second",
+      "",
+      "return value;"
+    ]);
+    expect(
+      lines[0]?.querySelector(".hljs-string")?.textContent
+    ).toBe("first");
+    expect(
+      lines[1]?.querySelector(".hljs-string")?.textContent
+    ).toBe("second");
+    expect(
+      lines[3]?.querySelector(".hljs-keyword")?.textContent
+    ).toBe("return");
+  });
+
+  it("重复调用不会再次包装已经准备的代码块", () => {
+    const root = createRoot("line-1\nline-2\n");
+
+    prepareCodeBlockPagination(root);
+    const firstHtml = root.innerHTML;
+    prepareCodeBlockPagination(root);
+
+    expect(root.innerHTML).toBe(firstHtml);
+    expect(root.querySelector("pre.md-fences")).toBeNull();
+    const paginationChunks = getChunks(root);
+    expect(paginationChunks).toHaveLength(1);
+    expect(
+      paginationChunks[0]?.classList.contains("md-fences")
+    ).toBe(true);
+    expect(
+      paginationChunks[0]?.getAttribute(
+        "data-code-pagination-prepared"
+      )
+    ).toBe("true");
+  });
+
+  it("复制代码元素属性并把每个双行组拆成同级分页片段", () => {
+    const root = document.createElement("article");
+    root.innerHTML =
+      '<pre class="md-fences custom" data-source="demo">' +
+      '<code class="hljs language-js" data-language="js">' +
+      "line-1\nline-2\nline-3\nline-4\n" +
+      "</code></pre>";
+
+    prepareCodeBlockPagination(root);
+
+    const chunks = getChunks(root);
+    expect(chunks).toHaveLength(2);
+    expect(Array.from(root.children)).toEqual(chunks);
+    expect(chunks[0]?.classList.contains("custom")).toBe(true);
+    expect(chunks[1]?.getAttribute("data-source")).toBe("demo");
+    expect(
+      chunks[1]?.querySelector("code")?.getAttribute("data-language")
+    ).toBe("js");
+  });
+});