人生进阶指南双语内容门禁中英文对应页标题顺序与 updated 日期如何保持一致【免费下载链接】upAn advanced guide which might benefit you a lot . 韩先凯的人生进阶指南 人生进阶指南 离谱的人生 人生进阶 离谱的英语学习指南/英语学习教程/英语学习/学英语项目地址: https://gitcode.com/GitHub_Trending/en/up《人生进阶指南》up是一个中英双语内容仓库每个公开中文页面都必须有完整的英文对应页反之亦然。当你在 docs/ 下新增或改写章节时门禁脚本 check-content.mjs 会检查三件事对应页是否存在、两页一~六级标题的层级序列是否一致、两页 frontmatter 里的updated日期是否相同。任一项不满足npm run check阶段就会报错并退出码 1CI 与本地校验共用同一套规则见 MAINTENANCE.md 的“内容规则”一节。这篇文章说明如何在提交前让中英文对应页通过这两项检查。准备环境版本约束来自 package.json 的enginesnode 24 25以及.nvmrc、.node-version均为24nvm use # 或任意版本管理器切到 Node 24 npm ci # 首次安装依赖严格按 lock filenpm ci只安装依赖不改动仓库内容。后续所有校验命令都在仓库根目录运行。门禁实际检查什么以下行为以 scripts/check-content.mjs 的源码为准规则描述见 MAINTENANCE.md 的“内容规则”。对应页配对规则。脚本以docs/下除SUMMARY.md、docs/README.md之外的每个中文 Markdown 页为基准要求docs/en/下存在同相对路径的英文页反向也成立。路径完全镜像例如docs/threads/part-1/2-vocabulary.mddocs/en/threads/part-1/2-vocabulary.md首页单独按一对处理docs/README.md对docs/en/README.md。标题层级序列。对每一对都存在的页面脚本用headingShape依次收集两页中所有#至######标题的级别数字代码围栏内的#行被忽略不参与比对再把两个序列拼成字符串比较。注意它比较的是“级别序列”包含数量与顺序两页可以是 1,2,2,3也可以是 1,3,2但两页拼出的字符串必须逐位相同。标题文字本身翻译可以不同结构和顺序不能漂移。updated日期。checkUpdatedParity对每一对已存在的页面读取 frontmatter 的updated只要两边都写了且不相等就报错。updated必须写成YYYY-MM-DD不能晚于当天它表示稿件版本同步不代替 AI 页面sources_checked的外部资料核验日期两者定义见 MAINTENANCE.md 的“外链与日期策略”。frontmatter 本身另有要求title、description、updated三个字段必须齐全description少于 24 字符会报“过短”。保持两项一致的写法以仓库里真实的一对页面 docs/threads/part-1/2-vocabulary.md 与其英文页为例两页 frontmatter 都是--- title: 词汇篇从“认识单词”到“能在语境中使用” description: 用词族、接受性与产出性词汇、语料覆盖率、主动回忆和动态间隔建立可迁移的词汇系统。 updated: 2026-09-01 ---英文页的title与description是英文译文但updated与中文页完全相同2026-09-01。对照这个样例改写或新增页面时按下面操作先保证路径镜像。中文页在docs/相对路径.md英文页必须落在docs/en/同一相对路径.md只有一侧存在时门禁报“缺少对应页”标题与日期检查对缺失的一侧不会执行。同步章节结构。在中文页调整章节新增、删除、升降标题级别时对英文页做同样的结构改动翻译措辞不受限制。如果某个#出现在代码块内例如引文示例它不算标题不需要在另一页镜像。统一updated。稿件文字被修改时把两页的updated同时改成同一天的YYYY-MM-DD日期不能写成未来日期。可选分支AI 页面。路径命中7-ai、1-ai-learning、2-ai-development-and-resource-layer的页面还必须在 frontmatter 写sources_checked同样YYYY-MM-DD且距校验时刻不超过 120 天否则报“AI 产品资料超过 120 天未核验”。这不是updated的替代品两者语义分开维护。SUMMARY.md文件不参与上述 frontmatter、标题与日期检查它们由导航同步生成不要在导航改动后手动维护。运行校验并解读结果完整校验入口是npm run check它按序执行check:navigation、check:readme、check:content、check:format脚本定义见 package.json。只针对双语门禁本身时直接跑npm run check:content通过时输出其中文件数为当次实际扫描的 Markdown 数量以下为脚本实际输出格式✓ 内容校验通过123 个 Markdown 文件双语、链接、元数据与隐私检查正常。失败时退出码为 1并在 stderr 逐条打印文件:行号 原因。与本文主题相关的消息及对应处理报错消息脚本原文含义处理缺少英文对应页: docs/en/.../缺少中文对应页: ...只有一侧页面存在补齐缺失一侧路径与已有页镜像中英文标题层级不一致: 1,2,2 vs 1,2两页标题级别序列不同按中文页结构对齐英文页或反之只改结构不改语义中英文稿件 updated 日期不一致: 2026-09-01 vs 2026-08-30两页updated不同两页改为同一日期frontmatter 缺少 updated缺少必填字段补上updated: YYYY-MM-DDupdated 必须使用 YYYY-MM-DD日期格式错误改为四位年-两位月-两位日updated 不能晚于当前日期日期写到了未来改为实际修改日期AI 页面缺少 sources_checked/AI 产品资料超过 120 天未核验仅 AI 三个页面补写或重新核验并更新sources_checked报错行号对 frontmatter 与双语一致性检查固定为 1错误定位到文件头链接与图片 alt 类检查才给出具体行号。提交前的完整门禁与限制修改导航、中文首页或词表时还要先生成文件再校验顺序固定为见 MAINTENANCE.md 的“章节发布门禁”npm run sync npm run check npm run docs:build npm run test:smokenpm run sync会重新生成根目录与docs/下的SUMMARY.md、根目录README.md、英文词表镜像和分享图CI.github/workflows/ci.yml在跑完校验后会再次执行npm run sync并用git diff --exit-code拦截未提交的生成文件差异。烟测test:smoke从docs/.vitepress/navigation.mjs的 source 自动生成中英文路由逐一渲染新增页面需要先进导航才能被覆盖。限制方面updated与sources_checked不可互相替代改了外部资料核验不意味着updated该动门禁只保证结构同步翻译质量本身不在脚本判断范围内。校验通过后按 MAINTENANCE.md 的发布流程在拉取请求的site-preview产物中确认站点再合并部署。【免费下载链接】upAn advanced guide which might benefit you a lot . 韩先凯的人生进阶指南 人生进阶指南 离谱的人生 人生进阶 离谱的英语学习指南/英语学习教程/英语学习/学英语项目地址: https://gitcode.com/GitHub_Trending/en/up创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考