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

局
 
发布于 2022年08月02日
收藏 12

Docusaurus 2.0 已正式发布

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

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

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:

使用案例

  • redocusaurus:与 OpenAPI 和 Redoc 无缝集成

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。
转载请注明:文章转载自 开源中国社区 [http://www.oschina.net]
本文标题:Docusaurus 2.0 正式发布,Facebook 开源的静态网站生成器
加载中
返回顶部
顶部