Docusaurus 2.0 正式发布,Facebook 开源的静态网站生成器

Docusaurus 2.0 已正式发布

Docusaurus 是 Facebook(现更名为 Meta)开源的静态网站生成器。它将你的网站构建成一个单页面应用程序 (single-page application),具有快速的客户端导航功能并充分利用了 React 的强大能力,为网站赋予更好地交互性。虽然 Docusaurus 是为文档功能而生的,但是也可以用来构建任何类型的网站(个人站点、产品介绍、博客、营销页面等)。

发布公告称,新一代的 Docusaurus 历经 4 年的开发,期间发布了 75 个 alpha 和 22 个 beta 版本。未来将会遵循语义化版本管理 (Semantic Versioning),并更快地发布重大更新版本。

Docusaurus 2.0 正式发布,Facebook 开源的静态网站生成器

Docusaurus 2.0 主要变化

  • React 既支持服务器端也支持客户端,可实现现代单页应用程序导航
  • 提供深色主题、更好的 UI 和 UX
  • 支持插件,插件使社区能够以第三方软件包的形式提供有用的功能
  • 通过themeConfig 配置项可灵活更换主题
  • 文档版本控制基于快照,并提供灵活的插件选项,以适应开发者工作流程
  • TypeScript 支持配置文件、插件、自定义页面和主题作者
  • Markdown 支持数学方程式、实时代码块
  • 支持 PWA

在 Docusaurus 2 中,现在支持通过 MDX 在 Markdown 中插入 React 组件,轻松构建交互式文档。

示例:

docs/my-document.mdx

  ### Give it a try: press that button!    import ColorModeToggle from '@theme/ColorModeToggle';    <ColorModeToggle/>

虽然 Docusaurus 2 现在才正式发布,但它早已处于稳定状态,并被广泛使用,因此 Docusaurus 2 在 npm 的下载量很快就超过了 Docusaurus 1:

Docusaurus 2.0 正式发布,Facebook 开源的静态网站生成器

使用案例

  • redocusaurus:与 OpenAPI 和 Redoc 无缝集成

Docusaurus 2.0 正式发布,Facebook 开源的静态网站生成器

Docusaurus 2.0 正式发布,Facebook 开源的静态网站生成器

展开阅读全文
发表评论

相关文章