主题
多页生成与 SEO
为什么需要生成器
88 个工具 × 每个页面 10 多个 SEO 字段 = 手工维护必然出错。pc-web/scripts/gen-pages.mjs 从 src/data 读取定义,一次性生成:
- 每个工具的
index.html(含静态正文); - 栏目页、子栏目页(测算、教育);
- 首页、关于 / 隐私 / 免责、404;
robots.txt、sitemap.xml;WebApplication、FAQPage、BreadcrumbList结构化数据。
单页结构
html
<head>
<title>{seoTitle}</title>
<meta name="description" content="{seoDesc}" />
<meta name="keywords" content="{keywords}" />
<link rel="canonical" href="https://emphant.com/text/word-counter/" />
<meta property="og:title" content="..." />
<meta property="og:image" content="https://emphant.com/og-cover.png" />
<script type="application/ld+json">{"@context":"https://schema.org", ...}</script>
</head>
<body>
<div id="app"></div> <!-- Vue 只接管交互区 -->
<main class="static-content"> <!-- 静态正文,不依赖 JS -->
<h1>字数统计</h1>
<p>{desc}</p>
<h2>使用方法</h2><ol>...</ol>
<h2>常见问题</h2><dl>...</dl>
<h2>相关工具</h2><ul>...</ul>
</main>
</body>关键点:先有可读的 HTML,再有 Vue。搜索引擎与不执行 JS 的抓取工具读到的是完整正文,而不是空壳。
构建后的目录整理
Vite 多页构建会按 HTML 源文件位置输出:
dist/pages/text/word-counter/index.htmlpostbuild.mjs 把 dist/pages/* 整体提到 dist/,得到最终路径:
dist/text/word-counter/index.html → /text/word-counter/这样 URL 干净,且不需要 nginx 做额外 rewrite。
canonical 与重复内容
| 页面 | canonical |
|---|---|
| 工具页 | https://emphant.com/{cat}/{slug}/ |
| 栏目页 | https://emphant.com/{cat}/ |
| 手机版 | 不设 canonical,改用 X-Robots-Tag: noindex |
手机版全部标 noindex,避免同一内容在 /m/ 下被当成重复页面抢排名。手机 UA 访问工具页时 302 到手机版,但爬虫 UA 不跳转(见 nginx 与流量分流)。
sitemap 与 robots
sitemap.xml在构建时生成,包含全部工具页、栏目页、法务页;robots.txt允许全站抓取,声明 sitemap 地址;- 新增工具后 sitemap 自动包含,无需手工维护。
结构化数据
| 类型 | 用在哪 | 关键字段 |
|---|---|---|
WebApplication | 每个工具页 | name、url、applicationCategory、offers(免费) |
FAQPage | 每个工具页 | 与页面 FAQ 完全一致,不能编造 |
BreadcrumbList | 工具页 | 首页 → 栏目 → 工具 |
Article | 教育、随笔 | headline、datePublished、author |
结构化数据必须与页面可见内容一致,否则会被判为作弊。
文档站与随笔站的 SEO
两站都是 VitePress:
cleanUrls: true,URL 无.html;- 自动生成
sitemap.xml,hostname分别指向自己的子域; - 每页
title/description来自 frontmatter 或首段; - 随笔额外输出
rss.xml,供聚合器订阅。
常见问题
新增页面没被收录? 先确认 sitemap 里有没有,再看页面是否返回 200、canonical 是否正确,最后才是提交搜索引擎。
改了文案线上没变? 首页与文档页设置了 Cache-Control: no-cache,带 hash 的 /assets/ 才是长缓存。如果仍看到旧内容,检查是不是浏览器缓存了 HTML 或 CDN。