React 全新文档上线！

转载

wx61dea0a827cf2 2022-08-01 17:10:37

文章标签 中文文档二维码微信 文章分类 代码人生

React 官方文档改版耗时 1 年，今天已完成站点相关改版，部分文档已初步上线。

改版是因为现在文档代码和文档内容都已过于陈旧，而且大部分文档还是基于 class components 进行的讲解，这次进行了全面 Hook 化。

既然要改，就彻底一点！

关于新文档讨论的 Issue：https://github.com/reactjs/reactjs.org/issues/3308
PR 地址：https://github.com/reactjs/reactjs.org/pull/3965

React 全新文档上线！_二维码

访问地址：https://beta.reactjs.org

长按识别二维码查看原文

https://beta.reactjs.org

React 全新文档上线！_微信_02

今天从中文文档维护者的角度和你聊聊，官方文档的变化。

分为以下几个部分：

站点更新
文档内容
关于中文文档

站点更新

先来聊聊变化：

官网将使用框架从Gatsby 替换为了 Next.js
引入了tailwind
去除Flow，全面 TypeScript 化
全新的交互设计
暗黑主题

先说框架切换，我认为这是必然结果。尽管 Gatsby 本身是静态站点的理想选择，但 Next 在服务端渲染方面表现更为出色，同时 Next 可以在运行时生成 HTML/CSS/JS，而 Gatsby 只能在构建时生成。

再来聊聊样式，旧版文档是自行编写的样式，而新版文档采用了 tailwind 来编写。尽管 CSS-in-JS 真香，但从性能层面来考量，还是差强人意。

类型检查也属于现在项目的标配了，而 Flow 是 Facebook 早期的产物，其作用也是对 JS 进行类型化，无论从设计还是使用层面，Flow 都逊色于 TypeScript。存在即合理，没有 TypeScript 的时代，Flow 也曾顶起了半边天。现在 Flow 已经完成了它的历史使命。

React 文档的技术选型，我们也可以借鉴一二，毕竟官方团队都在用。????

新的交互整体看起来非常清爽，给官方点赞！

React 全新文档上线！_中文文档_03

暗黑主题就不多说了，基本上是现在 Web 应用标配。

React 全新文档上线！_微信_04

文档内容

上午对所有文档进行了整理，官方重写了除了博客以外的全部文档，很彻底。

从文档技术上来看，和 webpack 文档一样采用了 MDX 的形式进行文档编写，使得文档变得更加灵活。

同时，将教程与 API 部分进行了分成了独立的 Tab。

从官方给出的数据来看，目前文档部分完成度：

Learn 部分：70%
API 部分：5%

关于新站点的建议，大家可以去 reddit 上发表你的看法。

长按识别二维码查看原文

https://www.reddit.com/r/reactjs/comments/qd5ky3/new_react_docs_beta_is_live_covers_function/

React 全新文档上线！_二维码_05

关于中文文档

由于文档内容部分，并未完全稳定。官方暂时不推荐进行翻译工作。

中文文档会选择性的对已稳定的部分进行翻译。

中文文档也拉取了新的 beta 分支，会每天与官方的 beta 分支进行同步。

新的文档地址会尽快同步给大家，作为正式发布前的尝鲜版本，敬请期待。

相关进展会定期在印记中文公众号进行同步，欢迎关注。

收获

看了文档站点的更新，聊聊我的收获。

官方利用 patch-package 魔改了 google-analytics 的包。

当项目中使用到的 package 不符合预期/存在 bug 时，我们通常有几种方案：

clone 项目，换个名字，发到 npm/tnpm/cnpm 上去
copy 到项目中，魔改
使用patch-package 对使用到的 package 进行 diff 调整。

贴一段 patch 的代码

-        src={`https://www.googletagmanager.com/gtag/js?id=${process.env.GA_TRACKING_ID}`}
+        src={`https://www.googletagmanager.com/gtag/js?id=${process.env.NEXT_PUBLIC_GA_TRACKING_ID}`}