教程统一格式 — 补充记录与待定事项
本次按「每篇文章 Frontmatter 含 title/description/keywords/author/date/lastmod/canonical/Article Schema/FAQ Schema + 正文含 TL;DR/FAQ/优缺点/适合人群/作者信息」的格式,对
tutorials/全部文章做了补充。 下面是实施时做出的默认取舍,以及需要你来决定的疑问点。
一、已按默认方案完成的点(若不同意可改)
| 项 | 默认做法 | 影响范围 |
|---|---|---|
keywords 字段 | 每篇 Frontmatter 增加 keywords(3–6 个搜索词,插在 description 后) | 36 篇全部补齐 |
| Article Schema / FAQ Schema | 不写裸 JSON-LD。站点由 .vitepress/config.mts 的 transformHead 自动生成:Article 用 date/lastmod/author/categories/tags/canonical,FAQPage 用 faq 数组。本次只保证这些驱动字段齐全 | 已构建验证:新增 faq 的文章均正确输出 FAQPage + Article schema |
| 作者信息块 | 正文末尾、相关阅读前统一加「## 关于作者」:UPGPTs 团队简介 + 链接教程中心/FAQ/联系 | 36 篇全部补齐 |
缺 faq 的文章 | 补 faq Frontmatter(从正文常见问题提炼)+ 正文用 <ArticleFaq /> 渲染 | 9 篇:codex-skin、gpt-5.6、claude-save-chat-history、claude 注册、grok 注册、hermes×2、edu-email、markitdown |
缺 FAQ 正文但有 faq 的文章 | 加 ## 常见问题 + <ArticleFaq /> | codex-limits、codex-pet、supergrok 等 |
| 缺 TL;DR 的文章 | 用 > **TL;DR:** 引用块,放 H1 后的引言附近 | 各篇按需补 |
| 缺优缺点/适合人群的文章 | 新增 ## 优缺点 / ## 适合人群 小节,内容严格取自原文事实,不新造外部信息 | 各篇按需补 |
二、待你决定的疑问点
keywords目前只写进了 Frontmatter,构建并未输出<meta name="keywords">。 现有.vitepress/config.mts只在 Article Schema 里用categories + tags拼 keywords,没有按页输出 keywords meta,也没有读取keywords字段。需要的话我可以改 config:让每页输出<meta name="keywords">,并让 Article Schema 优先取keywords字段。不改则当前 keywords 只是内容源、不影响线上。Article/FAQ Schema 的实现方式。 当前是构建自动生成(推荐,单一数据源)。如果你希望文章里手写 JSON-LD,请注意:在 Frontmatter
head里放application/ld+json会触发hasJsonLd守卫、禁用自动生成的 Article Schema。两者取其一。「优缺点」对步骤类教程的定位。 对「如何注册/如何安装」类文章,我把它写成了「这套方法/这个工具的优点与不足」。如果你希望这类文章改成对比两个方案(比如"官方渠道 vs 第三方代充"),告诉我,我按统一口径重写。
「适合人群」章节名不统一。 多数文章用了
## 适合人群,但有 6 篇用的是更贴合内容的标题:chatgpt-business.md→## 六、谁适合开 Businesschatgpt-plus-vs-pro.md→## 那我到底该选哪个?按人群对号入座chatgpt-pro5x-vs-pro20x.md→## Pro 5x 和 Pro 20x 怎么选(适合人群)how-to-subscribe-claude-pro.md→## 四、订阅前你需要知道的事(含适合/不适合场景)how-to-use-claude-5.md→> **适用人群**引用块 + 方案表grok-vs-chatgpt.md→**适合人群**行内 +## 选型建议:按职业来是否要全部改成字面## 适合人群?我倾向保留现有更生动的标题,避免为统一而牺牲表达。
TL;DR 的命名不统一。 现在有
TL;DR:、先看结论、先说结论、一句话结论、摘要、核心结论等多种写法(都是引言区结论块)。是否统一成TL;DR:一种?(grok-build 用的是一句话)FAQ 正文的两种呈现。 有的文章用
<ArticleFaq />(数据源 = Frontmatterfaq,唯一),有的保留手写「常见问题」小节(数据可能与 Frontmatter 重复)。是否统一?我建议:已有手写 FAQ 的文章保留手写;新增的用<ArticleFaq />。how-to-check-subscription.md仍是占位页(无 Frontmatter,只有 CTA + 相关阅读)。是否要我把它写成一篇正式文章(比如"如何查看 ChatGPT 订阅套餐")?还是保留占位?en/tutorials/英文镜像未动。 本次只处理了tutorials/中文目录。英文版 42 个文件需要同一套补齐,工作量约翻倍。是否现在同步?index.md分类页未动。 各子目录的index.md(如chatgpt/index.md)是分类入口页,已含 适合人群/先看结论,未按文章格式补 Article Schema/FAQ/作者。是否也要补?日期类字段。 本次未改动任何
date/lastmod。如果某篇内容有实质更新(如新增了优缺点/TL;DR),是否要把lastmod更新到今天(2026-08-15)?我默认没动,避免误改。
三、本次统计
- 处理文章数:36 篇(
tutorials/下除index.md与占位页外) - 新增
keywords:34 篇(chatgpt-business 原本已有,合计 35 篇具备;占位页除外) - 新增
关于作者块:35 篇(how-to-check-subscription 占位页除外) - 新增/补齐
faq(Frontmatter):9 篇 - 新增 TL;DR / 优缺点 / 适合人群 / FAQ 正文:按各篇缺口补充
- 已
vitepress build验证通过,Article + FAQPage Schema 均正确生成
