Skip to content

多页生成与 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.html

postbuild.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。

文档随仓库一起更新,站点内容全部在浏览器本地运行。