1 post tagged with "docusaurus"

最近几天使用 Docusaurus v2 搭建了这个文档站点， 真心不错，很容易上手，教程也比较全面。现在感觉不爽的就是 Docusaurus 这个单词太难记了。

之所以选择 Docusaurus，很大一部分原因在于浏览 React Native 生态圈的文档多了。 这些产品都是 facebook 生态圈的兄弟姐妹，大家相互扶持也算正常， 至少免去了一些版权之类的潜在纠纷。

之前也用过 docsify（当然现在也还在用），感觉 docsify 的上手要麻烦一些，尤其是不想花很多精力的情况下。

总结了一下，使用 Docusaurus 有几个优点：

1. 容易，直接通过命令建立脚手架工程，然后根据需要来调整修改，省不少功夫；
2. 使用 Markdown 语法，这个谈不上优点，但是对于熟悉 Markdown 的人来说还是很不错的；
3. 整个工程打包为静态文件，方便在不同的地方部署，自己搭建服务器，或者托管第三方服务器都很方便， 现在通过 Github Pages 部署，非常省时省力。

现在还是初体验，高级功能还没机会尝试，根据 Docu.. 的文档，可以在页面里添加 React 组件， 还有 MDX 等，这些给扩展空间留下了无限的可能性。

慢慢来吧，现在的主要任务是完善文档内容...