Skip to content

Notemd 1.9.3

Latest

Choose a tag to compare

@Jacobinwwey Jacobinwwey released this 24 Jun 08:15
· 5 commits to main since this release

Notemd v1.9.3

Highlights

  • Slidev export is now a real multi-format workflow, not a demo-only path: HTML, standalone HTML, PDF, PNG, and PPTX are verified through the same source-preparation and rendered-convergence pipeline.
  • PPTX export now prioritizes visible native editability: normal slide text, code text, and table-cell text are emitted as visible Office-native objects instead of transparent selectable overlays.
  • The reported PPTX page 17-29 occlusion issue is fixed: code-background rectangles and other native shapes are sorted below visible text, so the editable text remains visible in PowerPoint.

Major Upgrades

  • Added the Slidev export workflow with environment probing, local Slidev fork detection, full Slidev skill reference loading, source preparation, layout audit, and per-format output routing.
  • Added standalone HTML bundling with offline file:// support, relative asset handling, Vue component transformation fixes, and maintainer acceptance evidence.
  • Added editable PPTX export with visible native text boxes, rich text runs, Office font policy reporting, paragraph spacing, code text extraction, hyperlink relationships, and native DrawingML tables.
  • Added PPTX report contracts for editable text coverage, table-cell rich text coverage, fallback-only element kinds, font portability, transparent overlay detection, and rendered-HTML visual reference checks.
  • Added layout-quality gates for overflowing content, tables, code fences, slot layouts, Mermaid source preservation, and rendered deck geometry.

Fixes And Robustness

  • Fixed the layer ordering bug that allowed code-background rectangles to sit above visible text in complex PPTX slides.
  • Removed the transparent-text fallback from the default visible-native PPTX route; editable text is now the displayed text.
  • Fixed table-cell rich text preservation and reporting so native table output can be verified independently from suppressed overlay text boxes.
  • Fixed table-owned decoration diagnostics so inline table decoration is reported as table-owned residue instead of an unsupported table root.
  • Hardened Slidev export verification so real architecture.zh-CN.md acceptance checks the local Slidev fork, full skill reference count, rendered visual gate, Mermaid source preservation, PPTX editability, and generated artifact ignore status.
  • Tightened release workflow contracts around numeric tags, required release assets, bilingual release notes, and reusable release helper scripts.

Comparative Summary

  • Before: the Slidev export buttons could produce HTML-like artifacts, but the workflow did not consistently prove environment readiness, full skill usage, standalone behavior, or PPTX quality.
  • After: the export path reports the installed tools, local Slidev fork, full skill root, skill reference count, output files, and PPTX quality metrics from the real vault source.
  • Before: PPTX editability was partly misleading because transparent text could be selectable while visible text remained image-owned.
  • After: visible slide text and table-cell text are emitted as native editable Office text; Mermaid/SVG geometry remains explicitly fallback-owned instead of being over-claimed.
  • Before: native code backgrounds could be written after text in PPTX XML, which made pages 17-29 visually hide text behind background rectangles.
  • After: background images, native shapes, native tables, and native text are sorted into deterministic layers, and the real deck XML gate shows zero code-background rectangles after text on pages 17-29.

Verification

  • runuser -u jacob -- env HOME=/home/jacob PLAYWRIGHT_BROWSERS_PATH=/home/jacob/.cache/ms-playwright bash -lc 'cd /home/jacob/obsidian-NotEMD && npm run verify:slidev-export -- --vault docs --source architecture.zh-CN.md --format pptx --output-subfolder export/test-slidev-1.9.3-layer-release --sample-slides all --timeout-ms 600000 --no-screenshots --require-pptx-visual-match --json'
  • PPTX XML inspection for slides 17-29:
    • totalCodeBackgroundAfterText = 0
    • totalNativeShapeAfterText = 0
    • totalTransparentishAlpha = 0
    • totalTableOverlayText = 0
  • npm run chronicle:sync-repo-saga
  • npm run chronicle:update -- --tag 1.9.3
  • npm run build
  • npm test -- --runInBand
  • npm run audit:i18n-ui
  • npm run audit:render-host
  • obsidian help
  • obsidian-cli help
  • git diff --check

Notemd v1.9.3

亮点

  • Slidev 导出现在是可验收的多格式工作流,而不是演示路径:HTML、standalone HTML、PDF、PNG 与 PPTX 都走同一套 source preparation 与 rendered convergence 管线。
  • PPTX 导出现在优先保证可见原生可编辑性:普通正文、代码文本与表格单元格文字会输出为可见的 Office 原生对象,而不是透明可选中 overlay。
  • 已修复第 17-29 页文字被遮挡的问题:代码背景矩形与其他原生 shape 会被排序到可见文字下方,PowerPoint 中的可编辑文字保持可见。

主要升级

  • 新增 Slidev 导出工作流,包含环境检测、本地 Slidev fork 识别、完整 Slidev skill reference 加载、源文件准备、布局审计与多格式输出路由。
  • 新增 standalone HTML bundle,支持离线 file://、相对资源处理、Vue component transformation 修复,并补充维护者验收证据。
  • 新增 editable PPTX 导出能力,包含可见原生文本框、rich text runs、Office 字体策略报告、段落间距、代码文本抽取、超链接关系与原生 DrawingML 表格。
  • 新增 PPTX 报告契约,覆盖可编辑文字、表格单元格 rich text、fallback-only 元素类型、字体可移植性、透明 overlay 检测与 rendered-HTML 视觉参考。
  • 新增布局质量门禁,覆盖内容溢出、表格、代码 fence、slot layout、Mermaid 源保留与渲染 deck 几何。

修复与鲁棒性

  • 修复了代码背景矩形在复杂 PPTX 页面中可能位于可见文字上方的层级排序问题。
  • 从默认 visible-native PPTX 路径移除透明文字 fallback;可编辑文字现在就是实际显示的文字。
  • 修复表格单元格 rich text 的保留与报告,使 native table 输出不再依赖被 suppress 的 overlay 文本框来证明。
  • 修复 table-owned decoration 诊断:表格内部 inline 装饰现在报告为 table-owned residue,而不是 unsupported table root。
  • 加强 Slidev 导出验证:真实 architecture.zh-CN.md 验收会检查本地 Slidev fork、完整 skill reference 数量、渲染视觉门禁、Mermaid 源保留、PPTX 可编辑性与生成产物 ignore 状态。
  • 收紧发布流程契约:numeric tag、必需 release assets、中英双语 release notes 与复用发布脚本均有测试覆盖。

对比摘要

  • 改动前:Slidev export 按钮可以产出类 HTML 文件,但没有稳定证明环境可用性、完整 skill 使用、standalone 行为或 PPTX 质量。
  • 改动后:导出路径会报告已安装工具、本地 Slidev fork、完整 skill root、skill reference 数量、输出文件与真实 vault 源文件的 PPTX 质量指标。
  • 改动前:PPTX 可编辑性存在误导,透明文字可能可选中,但实际显示文字仍由图片层承担。
  • 改动后:可见正文与表格单元格文字会输出为 Office 原生可编辑文字;Mermaid/SVG geometry 仍明确归属 fallback,不夸大为已完全原生可编辑。
  • 改动前:PPTX XML 中原生代码背景可能写在文字之后,导致第 17-29 页文字被背景矩形遮挡。
  • 改动后:background image、native shape、native table、native text 按确定性层级排序,真实 deck 的 XML gate 显示第 17-29 页没有任何 code background 位于文字之后。

验证

  • runuser -u jacob -- env HOME=/home/jacob PLAYWRIGHT_BROWSERS_PATH=/home/jacob/.cache/ms-playwright bash -lc 'cd /home/jacob/obsidian-NotEMD && npm run verify:slidev-export -- --vault docs --source architecture.zh-CN.md --format pptx --output-subfolder export/test-slidev-1.9.3-layer-release --sample-slides all --timeout-ms 600000 --no-screenshots --require-pptx-visual-match --json'
  • 第 17-29 页 PPTX XML 检查:
    • totalCodeBackgroundAfterText = 0
    • totalNativeShapeAfterText = 0
    • totalTransparentishAlpha = 0
    • totalTableOverlayText = 0
  • npm run chronicle:sync-repo-saga
  • npm run chronicle:update -- --tag 1.9.3
  • npm run build
  • npm test -- --runInBand
  • npm run audit:i18n-ui
  • npm run audit:render-host
  • obsidian help
  • obsidian-cli help
  • git diff --check