返回文档首页

内置 Docs 系统说明

说明 web-nuxt 当前基于 Nuxt Content 的站内文档能力,以及如何继续扩展。

站内 Docs 现在已经改成基于 Nuxt Content 的内容流,不再依赖自定义 marked 解析管线。

当前包含的部分

  • /docs/docs/[slug] 路由
  • 存放在 content/docs/ 下的 markdown 文件
  • content.config.ts 里定义的英文与简体中文 docs collections
  • 已接入 SEO metadata 和 prerender
  • 由同一内容源生成的侧边栏导航

语言策略

当前公开站点首发只提供英文与简体中文,docs 内容也遵循同样的范围:英文始终可用,已翻译的页面再补简体中文,其余已收口的 locale 路由会重定向回英文或简体中文 canonical。

如何新增页面

  1. content/docs/en/ 下新增 markdown 文件
  2. 如果需要中文版本,再在 content/docs/zh/ 下补对应文件
  3. 通过 frontmatter 配置 titlelabeldescriptionorder
---
title: 账单指南
label: Billing
description: 说明套餐、发票和积分。
order: 4
---

## 概览

在这里写正文。

下一步怎么升级

如果文档规模继续增长,下一步可以继续在 Nuxt Content 这一套上叠加搜索、导航 metadata 或远程内容源,而不是再换一套内容栈。