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。
This commit is contained in:
SkyJourney
@@ -37,7 +37,13 @@ async function createThemeFixture() {
|
||||
const bundledRoot = join(temporaryDirectory, "bundled");
|
||||
const localRoot = join(temporaryDirectory, "local");
|
||||
const themeRoot = join(bundledRoot, "test-theme");
|
||||
const sharedFontRoot = join(
|
||||
bundledRoot,
|
||||
"_shared",
|
||||
"official-fonts"
|
||||
);
|
||||
await mkdir(join(themeRoot, "fonts"), { recursive: true });
|
||||
await mkdir(sharedFontRoot, { recursive: true });
|
||||
await mkdir(localRoot, { recursive: true });
|
||||
await writeFile(
|
||||
join(themeRoot, "theme.json"),
|
||||
@@ -53,6 +59,14 @@ async function createThemeFixture() {
|
||||
domPreset: "typora",
|
||||
defaultFontSize: "16px",
|
||||
supportedFeatures: ["code", "table"],
|
||||
pageDefaults: {
|
||||
margins: {
|
||||
top: "37mm",
|
||||
right: "26mm",
|
||||
bottom: "35mm",
|
||||
left: "28mm"
|
||||
}
|
||||
},
|
||||
bundled: true
|
||||
}),
|
||||
"utf8"
|
||||
@@ -64,6 +78,10 @@ async function createThemeFixture() {
|
||||
" font-family: Test;",
|
||||
" src: url('./fonts/test.woff2') format('woff2');",
|
||||
"}",
|
||||
"@font-face {",
|
||||
" font-family: SharedTest;",
|
||||
" src: url('theme-shared:official-fonts/shared.woff2') format('woff2');",
|
||||
"}",
|
||||
"#write { font-family: Test; }"
|
||||
].join("\n"),
|
||||
"utf8"
|
||||
@@ -72,6 +90,10 @@ async function createThemeFixture() {
|
||||
join(themeRoot, "fonts", "test.woff2"),
|
||||
Buffer.from([0, 1, 2, 3])
|
||||
);
|
||||
await writeFile(
|
||||
join(sharedFontRoot, "shared.woff2"),
|
||||
Buffer.from([4, 5, 6, 7])
|
||||
);
|
||||
return { bundledRoot, localRoot };
|
||||
}
|
||||
|
||||
@@ -147,6 +169,16 @@ describe("共享应用服务", () => {
|
||||
themes: [
|
||||
expect.objectContaining({
|
||||
id: "test-theme",
|
||||
category: "general",
|
||||
compatibleProfiles: [],
|
||||
pageDefaults: {
|
||||
margins: {
|
||||
top: "37mm",
|
||||
right: "26mm",
|
||||
bottom: "35mm",
|
||||
left: "28mm"
|
||||
}
|
||||
},
|
||||
bundled: true,
|
||||
source: "bundled"
|
||||
})
|
||||
@@ -157,6 +189,11 @@ describe("共享应用服务", () => {
|
||||
).resolves.toContain(
|
||||
"mdpdf://theme/test-theme/fonts/test.woff2"
|
||||
);
|
||||
await expect(
|
||||
service.getThemeCss("test-theme")
|
||||
).resolves.toContain(
|
||||
"mdpdf://theme/_shared/official-fonts/shared.woff2"
|
||||
);
|
||||
});
|
||||
|
||||
it("安全读取主题二进制资源", async () => {
|
||||
@@ -172,6 +209,18 @@ describe("共享应用服务", () => {
|
||||
await expect(
|
||||
service.getThemeAsset("test-theme", "../test.woff2")
|
||||
).rejects.toThrow("主题资源路径不安全");
|
||||
await expect(
|
||||
service.getThemeAsset(
|
||||
"_shared",
|
||||
"official-fonts/shared.woff2"
|
||||
)
|
||||
).resolves.toEqual({
|
||||
contentType: "font/woff2",
|
||||
content: Buffer.from([4, 5, 6, 7])
|
||||
});
|
||||
await expect(
|
||||
service.getThemeAsset("_shared", "../shared.woff2")
|
||||
).rejects.toThrow("主题资源路径不安全");
|
||||
});
|
||||
|
||||
it("内置主题优先于同 ID 的旧本地副本", async () => {
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
import { readFile } from "node:fs/promises";
|
||||
import { readFile, readdir } from "node:fs/promises";
|
||||
import { fileURLToPath } from "node:url";
|
||||
import { describe, expect, it } from "vitest";
|
||||
|
||||
@@ -6,10 +6,65 @@ const bundledThemeNames = {
|
||||
"typora-github": "Typora Github",
|
||||
"typora-pixyll": "Typora Pixyll",
|
||||
"typora-whitey": "Typora whitey",
|
||||
"typora-like": "Typora Clean"
|
||||
"typora-like": "Typora Clean",
|
||||
"gov-red-standard": "政企红头·标准文件",
|
||||
"gov-red-letter": "政企红头·标准信函",
|
||||
"enterprise-red-simple": "政企红头·企业简版",
|
||||
"red-briefing": "政企红头·纪要简报",
|
||||
"formal-report": "政企正式·工作报告",
|
||||
"formal-regulation": "政企正式·规章制度",
|
||||
"formal-feasibility": "政企正式·可研报告",
|
||||
"tender-classic": "标书正式·经典黑白",
|
||||
"tender-business-blue": "标书正式·商务蓝",
|
||||
"tender-blind": "标书正式·技术暗标"
|
||||
} as const;
|
||||
|
||||
describe("内置主题清单", () => {
|
||||
it("每个内置主题都有同名 Markdown 示例", async () => {
|
||||
const samplesRoot = fileURLToPath(
|
||||
new URL("../../../samples/themes/", import.meta.url)
|
||||
);
|
||||
const sampleFiles = (await readdir(samplesRoot))
|
||||
.filter((fileName) => fileName.endsWith(".md"))
|
||||
.sort();
|
||||
const expectedFiles = Object.keys(bundledThemeNames)
|
||||
.map((id) => `${id}.md`)
|
||||
.sort();
|
||||
|
||||
expect(sampleFiles).toEqual(expectedFiles);
|
||||
expect(sampleFiles).not.toContain("_shared.md");
|
||||
for (const fileName of sampleFiles) {
|
||||
const markdown = await readFile(
|
||||
`${samplesRoot}${fileName}`,
|
||||
"utf8"
|
||||
);
|
||||
expect(markdown.length).toBeGreaterThan(300);
|
||||
expect(markdown).toMatch(/^---[\s\S]+---/u);
|
||||
}
|
||||
});
|
||||
|
||||
it("提供可随桌面发行包分发的内置教程", async () => {
|
||||
const tutorialsRoot = fileURLToPath(
|
||||
new URL("../../../samples/tutorials/", import.meta.url)
|
||||
);
|
||||
const tutorialFiles = (await readdir(tutorialsRoot))
|
||||
.filter((fileName) => fileName.endsWith(".md"))
|
||||
.sort();
|
||||
|
||||
expect(tutorialFiles).toEqual([
|
||||
"echarts-tutorial.md",
|
||||
"formal-document-tutorial.md"
|
||||
]);
|
||||
for (const fileName of tutorialFiles) {
|
||||
const markdown = await readFile(
|
||||
`${tutorialsRoot}${fileName}`,
|
||||
"utf8"
|
||||
);
|
||||
expect(markdown.startsWith("---")).toBe(true);
|
||||
expect(markdown.length).toBeGreaterThan(1_000);
|
||||
}
|
||||
});
|
||||
|
||||
it("使用稳定主题 ID 和面向用户的显示名称", async () => {
|
||||
const themesRoot = fileURLToPath(
|
||||
new URL("../../../themes/", import.meta.url)
|
||||
@@ -27,4 +82,175 @@ describe("内置主题清单", () => {
|
||||
expect(manifest.name).toBe(name);
|
||||
}
|
||||
});
|
||||
|
||||
it("为红头主题声明分类与兼容的结构化文档", async () => {
|
||||
const themesRoot = fileURLToPath(
|
||||
new URL("../../../themes/", import.meta.url)
|
||||
);
|
||||
const expectedProfiles = {
|
||||
"gov-red-standard": "official",
|
||||
"gov-red-letter": "official",
|
||||
"enterprise-red-simple": "official",
|
||||
"red-briefing": "briefing"
|
||||
} as const;
|
||||
|
||||
for (const [id, profile] of Object.entries(expectedProfiles)) {
|
||||
const manifest = JSON.parse(
|
||||
await readFile(`${themesRoot}${id}/theme.json`, "utf8")
|
||||
) as {
|
||||
category?: unknown;
|
||||
compatibleProfiles?: unknown;
|
||||
};
|
||||
|
||||
expect(manifest.category).toBe("red-letter");
|
||||
expect(manifest.compatibleProfiles).toContain(profile);
|
||||
}
|
||||
});
|
||||
|
||||
it("标准信函主题提供首页版头和末页底部红色双线", async () => {
|
||||
const [themeCss, printCss] = await Promise.all([
|
||||
readFile(
|
||||
new URL(
|
||||
"../../../themes/gov-red-letter/theme.css",
|
||||
import.meta.url
|
||||
),
|
||||
"utf8"
|
||||
),
|
||||
readFile(
|
||||
new URL(
|
||||
"../../../themes/gov-red-letter/print.css",
|
||||
import.meta.url
|
||||
),
|
||||
"utf8"
|
||||
)
|
||||
]);
|
||||
|
||||
expect(themeCss).toContain(".doc-masthead-official::after");
|
||||
expect(printCss).toContain(
|
||||
".pagedjs_pages > .pagedjs_page:last-child .pagedjs_pagebox::after"
|
||||
);
|
||||
expect(printCss).toContain("bottom: 20mm");
|
||||
});
|
||||
|
||||
it("为正式文档与标书主题声明正确分类", async () => {
|
||||
const themesRoot = fileURLToPath(
|
||||
new URL("../../../themes/", import.meta.url)
|
||||
);
|
||||
const expectedThemes = {
|
||||
"formal-report": {
|
||||
category: "formal",
|
||||
profile: undefined
|
||||
},
|
||||
"formal-regulation": {
|
||||
category: "formal",
|
||||
profile: undefined
|
||||
},
|
||||
"formal-feasibility": {
|
||||
category: "formal",
|
||||
profile: "project-report"
|
||||
},
|
||||
"tender-classic": {
|
||||
category: "tender",
|
||||
profile: "tender"
|
||||
},
|
||||
"tender-business-blue": {
|
||||
category: "tender",
|
||||
profile: "tender"
|
||||
},
|
||||
"tender-blind": {
|
||||
category: "tender",
|
||||
profile: "tender"
|
||||
}
|
||||
} as const;
|
||||
|
||||
for (const [id, expected] of Object.entries(expectedThemes)) {
|
||||
const manifest = JSON.parse(
|
||||
await readFile(`${themesRoot}${id}/theme.json`, "utf8")
|
||||
) as {
|
||||
category?: unknown;
|
||||
compatibleProfiles?: unknown[];
|
||||
};
|
||||
|
||||
expect(manifest.category).toBe(expected.category);
|
||||
if (expected.profile) {
|
||||
expect(manifest.compatibleProfiles).toContain(
|
||||
expected.profile
|
||||
);
|
||||
} else {
|
||||
expect(manifest.compatibleProfiles).toEqual([]);
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
it("技术暗标主题隐藏结构化身份字段", async () => {
|
||||
const css = await readFile(
|
||||
new URL(
|
||||
"../../../themes/tender-blind/theme.css",
|
||||
import.meta.url
|
||||
),
|
||||
"utf8"
|
||||
);
|
||||
|
||||
expect(css).toMatch(
|
||||
/\.doc-cover-bidder,[\s\S]*\.doc-cover-representative\s*\{[\s\S]*display:\s*none\s*!important;/u
|
||||
);
|
||||
});
|
||||
|
||||
it("正式主题声明符合用途的推荐页边距", async () => {
|
||||
const themesRoot = fileURLToPath(
|
||||
new URL("../../../themes/", import.meta.url)
|
||||
);
|
||||
const expectedMargins = {
|
||||
"gov-red-standard": ["37mm", "26mm", "35mm", "28mm"],
|
||||
"gov-red-letter": ["37mm", "26mm", "35mm", "28mm"],
|
||||
"enterprise-red-simple": ["25mm", "25mm", "25mm", "28mm"],
|
||||
"red-briefing": ["25mm", "25mm", "25mm", "25mm"],
|
||||
"formal-report": ["37mm", "26mm", "35mm", "28mm"],
|
||||
"formal-regulation": ["37mm", "26mm", "35mm", "28mm"],
|
||||
"formal-feasibility": ["25mm", "20mm", "25mm", "30mm"],
|
||||
"tender-classic": ["25mm", "25mm", "25mm", "30mm"],
|
||||
"tender-business-blue": ["25mm", "25mm", "25mm", "30mm"],
|
||||
"tender-blind": ["25.4mm", "25.4mm", "25.4mm", "31.7mm"]
|
||||
} as const;
|
||||
|
||||
for (const [id, expected] of Object.entries(expectedMargins)) {
|
||||
const manifest = JSON.parse(
|
||||
await readFile(`${themesRoot}${id}/theme.json`, "utf8")
|
||||
) as {
|
||||
pageDefaults?: {
|
||||
margins?: Record<"top" | "right" | "bottom" | "left", string>;
|
||||
};
|
||||
};
|
||||
const margins = manifest.pageDefaults?.margins;
|
||||
|
||||
expect([
|
||||
margins?.top,
|
||||
margins?.right,
|
||||
margins?.bottom,
|
||||
margins?.left
|
||||
]).toEqual(expected);
|
||||
}
|
||||
});
|
||||
|
||||
it("红头机关名称不继承正文首行缩进", async () => {
|
||||
const themesRoot = fileURLToPath(
|
||||
new URL("../../../themes/", import.meta.url)
|
||||
);
|
||||
|
||||
for (const id of [
|
||||
"gov-red-standard",
|
||||
"gov-red-letter",
|
||||
"enterprise-red-simple"
|
||||
]) {
|
||||
const css = await readFile(
|
||||
`${themesRoot}${id}/theme.css`,
|
||||
"utf8"
|
||||
);
|
||||
|
||||
expect(css).toMatch(
|
||||
/#write \.doc-issuer\s*\{[^}]*text-align:\s*center;[^}]*text-indent:\s*0;/su
|
||||
);
|
||||
}
|
||||
});
|
||||
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user