跳转至主内容
Version: 2.0.0-alpha.75

设计理念

注意

此章节尚未完成。

  • 简单易用 - Docusaurus 应简单易用,暴露最少限度的 API。 即使需要花大量时间写更多代码,大多数功能应仍可由用户完成。 没有抽象比错误抽象更好,我们不希望用户去捣鼓错误的抽象。 必看讲座 - 最少限度的 API 表面.
  • 自然直观 - 用户查看 Docusaurus 项目目录或添加新特性时不会感到头昏脑胀。 软件应简单直观,用户则可轻松扩展。
  • 分层架构 - 软件栈的分层(内容/主题/样式)应一目了然 - 充分抽象并模块化。
  • 智能默认 - 为用户自动完成常见、热门的性能优化选项,并提供手动覆盖的方式。
  • 不受约束 - 用户无需使用默认插件或 CSS(虽然强烈推荐)。 由于我们进行了默认的性能优化,部分如 React Loadable、React Router 的低级组件无法被替换。 但包括 Markdown 引擎、CSS 框架及方法在内的高层级的组件完全由您掌控。

Docusaurus 是如何工作的#

我们作为开发者相信,了解一个库的运作方式可以让我们更加得心应手地使用它。 因此,我们致力于诠释 Docusaurus 的架构及多个组件,希望用户能更深入地了解并熟练使用此工具。