·
17 岁高三学生 | 业余前端｜React & Nextjs | UI & UX 设计

不过Nextra目前有不少痛点...拓展性谈不上好，API文档又有点简陋（甚至还少了点），很多东西不方便修改或者嵌入。还有现在的新的nextra都在npm的@alpha标签下，这是需要注意的，因为稳定版的那个实在是有点简陋。 worried

Replies
4

neutral_face 这样啊，我在找一个文档系统，主要是做 API 相关的，把黑客说的 API 开放出来，要比 swagger 好用，支持国际化

单纯 API 文档的话我感觉Nextra是可以胜任的，只是如果需要动到Nextra本身渲染的部分就难一些（可能需要重写主题），其他的可以通过MDX导入react组件来拓展，问题不大

Nextra最难受还是因为它的i18n是完全使用Next.js的i18n路由的，文档一多实在是会眼花缭乱，因为目录一致，用[name].[lang].{js,tsx,md,mdx}来区分实在是一言难尽，两个语言还好，再多一点就真的伤脑筋。如果要用目录定义语言那估计还得重写中间件来拦截Nextra的默认语言切换行为 no_mouth

nextjs 的 i18n 路由是为了 seo，每种语言都有一个单独的页面，这样就很难做到 typesafe（文档结构同步、检查）