html-to-pptx-converter
下载
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
data-i18n需覆盖所有可翻译属性并显式标注后缀，lang必须逐层设置不可继承，dom嵌套深度超6层会导致漏翻译，动态内容需立即翻译，语言包须扁平结构、bcp 47命名且fallback闭环。
data-i18n标记必须覆盖所有可翻译属性，不只是textContent
只给 <h1 data-i18n="title"></h1> 加标记，切换语言后 placeholder、alt、title 还是英文——这是最常被忽略的漏点。浏览器不会自动把 data-i18n 的值映射到属性上。
实操建议：
- 显式添加带后缀的属性：
data-i18n-placeholder、data-i18n-alt、data-i18n-title、data-i18n-aria-label -
value属性一般不翻译（属于用户输入数据），但<button></button>和<input type="submit">的显示文案建议统一用textContent更新，避免提交时意外发英文值 - 含 HTML 结构的文案（如“请阅读服务条款”）必须用
innerHTML替换，且语言包里对应值要是可信纯 HTML 片段——不能拼接用户输入，否则有 XSS 风险
lang 属性必须逐层显式设置，不能依赖继承
执行 document.documentElement.lang = 'zh-Hans' 后，页面文字没变、屏幕阅读器仍读错、顿号间距乱、中文字体覆盖代码块——这不是国际化失败，是根本没生效。浏览器和辅助技术按每个元素自身的 lang 属性决定语音、字体回退、标点渲染规则，不继承父级。
实操建议：
- 所有含文本的语义化标签（
<h1></h1>、<p></p>、<section></section>、<footer></footer>等）都必须显式写lang，值与当前语言包一致（如lang="zh-Hans"） - 已带
lang的特殊元素（如<pre class="brush:php;toolbar:false;" lang="bash"></pre>、<code lang="sql">）切换语言时保留原值，这是合法的多语言混排场景 - 切换语言前，先收集所有已设
lang的元素：document.querySelectorAll('[lang]')，再对每个匹配元素执行el.lang = newLang
DOM 深度超 6 层会导致 data-i18n 节点漏翻译
当 data-i18n 嵌套在 <div><div><div><div><div><p data-i18n="msg"></p></div></div></div></div></div> 这类纯 CSS 堆叠结构里时，JS 遍历逻辑可能因深度截断或性能阈值跳过最内层节点——结果是中文页正常，切换英文后那段文字仍显示中文，且控制台无报错。
实操建议：
- 用浏览器 Elements 面板右键 → “Reveal in Elements panel”，手动数路径层级：从
到目标data-i18n元素，必须 ≤6 - 把冗余
<div> 替换为语义标签：<code><main></main>、<section></section>，天然中断嵌套深度，同时支持 i18n 工具自动识别作用域 - 动态插入内容（如弹窗、AJAX 表格行）必须在
appendChild()后立即调用翻译函数，不能依赖全局扫描 - 每个语言一个独立文件，路径统一为
./locales/${lang}.json，例如./locales/zh-Hans.json、./locales/en-US.json - 结构必须扁平，键名严格一致：所有文件字段完全对齐，某语言暂未翻译也要保留键，设为空字符串：
"btn_submit": "" - 加载时用
fetch()，加try/catch包裹；fallback 顺序必须是：先试完整码（如zh-HK），再截主语言（zh），最后退到默认语言（如en） - 服务器返回 JSON 时，
Content-Type必须是application/json，否则fetch可能静默失败
JSON 语言包结构扁平 + BCP 47 命名 + fallback 必须闭环
语言包键名不一致、文件路径混乱、加载失败静默留白——这些都会让整页文案消失。不是 JS 写错了，是语言包本身不可靠。
实操建议：
data-i18n，而是忘了 lang 要逐层同步、DOM 深度会截断遍历、以及语言包加载失败时没人兜底。这三处不处理，切换语言就等于在赌运气。
