·
Across the Great Wall, we can reach every corner in the world.

Nextra 看起来不错,最近准备换文档系统,对比看看

Replies
5

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

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(文档结构同步、检查)