用途:使用 Nextra 与 Next.js 构建专业文档站点,适用于文档站、知识库、多语言文档门户和 API 参考文档。
主要能力:覆盖 Nextra 3.x 与 4.x 架构模式、Next.js 14/15 集成配置、通过 theme.config.tsx 或 Layout props 定制主题、FlexSearch 高级搜索、国际化支持、MDX 内容与 React 组件混用,以及 Nextra 4.x 的 App Router 与 Turbopack 兼容。内置主题含 nextra-theme-docs(推荐文档站)与 nextra-theme-blog。
使用方式:用 npx 的 create-nextra-app 命令并指定 docs 模板初始化项目。项目结构含 pages 目录(自定义 App 组件文件、首页 index MDX、各文档子目录),每个子目录含 MDX 内容与 _meta.json 导航配置。theme.config.tsx 导出配置对象,含 logo、project、docsRepositoryBase、useNextSeoProps 等属性,可配置品牌、导航、侧边栏折叠层级、目录与页脚。_meta.js 控制侧边栏排序与显示名,支持分隔线与外链。MDX 中可导入组件、使用 nextra/components 的 Callout。搜索与 SEO 通过主题配置和 head 属性设置。
部署:支持 Vercel(零配置,需全局安装 Vercel CLI 后运行 vercel 命令)、GitHub Pages、Netlify 及自定义服务器。
限制:详细模式见 modules 目录(configuration.md、mdx-components.md、i18n-setup.md、deployment.md)。版本 2.2.0 已移除代码块,示例改为叙述描述。具体收费与价格暂未提供。