比较
Fumadocs 与其他现有框架有什么不同？
Nextra
Fumadocs 深受 Nextra 的启发。例如，路由约定。这就是为什么 meta.json 也存在于 Fumadocs 中的原因。
🌐 Fumadocs is highly inspired by Nextra. For example, the Routing Conventions. That is why
meta.json also exists in Fumadocs.
与 Fumadocs 相比，Nextra 更加有自己的观点，因此作为副作用，你必须手动配置一些东西，而不是简单地编辑一个配置文件。
🌐 Nextra is more opinionated than Fumadocs, as a side effect, you have to configure things manually compared to simply editing a configuration file.
如果你想对所有内容有更多控制，比如将其添加到现有代码库或实现高级路由，Fumadocs 会非常适合。
🌐 Fumadocs works great if you want more control over everything, such as adding it to an existing codebase or implementing advanced routing.
功能表
🌐 Feature Table
| Feature | Fumadocs | Nextra |
|---|---|---|
| Static Generation | Yes | Yes |
| Cached | Yes | Yes |
| Light/Dark Mode | Yes | Yes |
| Syntax Highlighting | Yes | Yes |
| Table of Contents | Yes | Yes |
| Full-text Search | Yes | Yes |
| i18n | Yes | Yes |
| Last Git Edit Time | Yes | Yes |
| Page Icons | Yes | Yes, via _meta.js files |
| RSC | Yes | Yes |
| Remote Source | Yes | Yes |
| SEO | Via Metadata | Yes |
| Built-in Components | Yes | Yes |
| RTL Layout | Yes | Yes |
附加功能
🌐 Additional Features
通过像 TypeDoc 这样的第三方库支持的功能不会在此列出。
🌐 Features supported via 3rd party libraries like TypeDoc will not be listed here.
| 特性 | Fumadocs | Nextra |
|---|---|---|
| OpenAPI 集成 | 是 | 否 |
| TypeScript 文档生成 | 是 | 否 |
| TypeScript Twoslash | 是 | 是 |
Mintlify
Mintlify 是一项文档服务，与 Fumadocs 相比，它提供免费层，但并非完全免费和开源。
🌐 Mintlify is a documentation service, as compared to Fumadocs, it offers a free tier but isn't completely free and open source.
Fumadocs 不如 Mintlify 强大，例如，Mintlify 的 OpenAPI 集成功能。 作为 Fumadocs 的创建者，如果你对当前构建文档的方式感到满意，我不建议你从 Mintlify 转向 Fumadocs。 然而，我认为 Fumadocs 是一个适合所有希望拥有优雅文档的 React.js 开发者的工具。
🌐 Fumadocs is not as powerful as Mintlify, for example, the OpenAPI integration of Mintlify. As the creator of Fumadocs, I wouldn't recommend switching to Fumadocs from Mintlify if you're satisfied with the current way you build docs. However, I believe Fumadocs is a suitable tool for all React.js developers who want to have elegant docs.
Docusaurus
Docusaurus 是一个基于 React.js 的强大框架。它通过插件和自定义主题提供了许多非常棒的功能。
🌐 Docusaurus is a powerful framework based on React.js. It offers many cool features with plugins and custom themes.
较低复杂性
🌐 Lower Complexity
由于 Fumadocs 设计为与 React 框架集成，你可能需要更多的 React.js 知识才能入门。作为回报，Fumadocs 拥有更好的可定制性。
🌐 As Fumadocs is designed to integrate with React frameworks, you may need more knowledge of React.js to get started. In return, Fumadocs have better customizability.
对于简单的文档，如果你不需要任何特定于框架的功能，Docusaurus 可能是更好的选择。
🌐 For a simple docs, Docusaurus might be a better choice if you don't need any framework-specific functionality.
插件
🌐 Plugins
你可以通过插件轻松实现许多功能，它们的生态系统确实更大，并且由许多贡献者维护。
🌐 You can easily achieve many things with plugins, their ecosystem is indeed larger and maintained by many contributors.
相比之下，Fumadocs 的灵活性允许你自己进行实现，但可能需要更长时间来调试到满意的状态。
🌐 In comparison, the flexibility of Fumadocs allows you to implement them on your own, it may take longer to tune it to your satisfaction.
Last updated on