用途:使用 Nextra 与 Next.js 构建专业文档站点,适合文档站、知识库、多语言文档门户、自定义文档主题及技术文档中的交互示例。
主要能力:覆盖 Nextra 3.x 与 4.x 架构模式、Next.js 14 与 15 集成配置、通过 theme.config.tsx 或 Layout props 定制主题、FlexSearch 高级搜索、国际化、支持 React 组件的 MDX 内容,以及 Nextra 4.x 的 App Router 与 Turbopack 兼容。内置主题含 nextra-theme-docs(文档站推荐)和 nextra-theme-blog。
使用方式:用 create-nextra-app 命令配合 npx 指定 docs 模板初始化项目。项目结构含 pages 目录(含自定义 App 组件、首页 index MDX 及各栏目 MDX 与 _meta.json)。theme.config.tsx 导出配置,含 logo、project、docsRepositoryBase、useNextSeoProps 等。_meta.js 控制侧边栏排序与显示名,分隔线用三个短横线作键、空字符串为值,外链用含 title、href、newWindow 的嵌套对象配置。MDX 支持在文件顶部导入组件并内联使用,也可在文件内自定义导出组件,nextra/components 提供 Callout 提示框。SEO 通过 head 属性配置 Open Graph 等元信息。
部署:支持 Vercel(零配置,全局安装 Vercel CLI 后运行 vercel 命令)、GitHub Pages、Netlify 及自定义服务器。
限制:资料未提供具体收费、价格与效果数据;详细模式见 modules 目录下的 configuration.md、mdx-components.md、i18n-setup.md、deployment.md。