如何离线查看组件的 MUI 库和 API？

Question

我希望在离线时能够在 mac 上查看 MUI 的组件库和 api 文档。 MUI 支持人员向我提供了以下说明

这是我输入终端的内容。

git clone https://github.com/mui-org/material-ui.git
cd material-ui
yarn
yarn docs:build
yarn docs:start

这就是我从中得到的 my terminal

apple2@apple2s-iMac material-ui % yarn docs:start
yarn run v1.22.10
$ yarn workspace docs start
$ next start
Error: listen EADDRINUSE: address already in use 0.0.0.0:3000
    at Server.setupListenHandle [as _listen2] (node:net:1330:16)
    at listenInCluster (node:net:1378:12)
    at doListen (node:net:1516:7)
    at processTicksAndRejections (node:internal/process/task_queues:84:21) {
  code: 'EADDRINUSE',
  errno: -48,
  syscall: 'listen',
  address: '0.0.0.0',
  port: 3000
}
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
error Command failed.
Exit code: 1
Command: /usr/local/Cellar/node/17.3.0/bin/node
Arguments: /Users/apple2/Desktop/Code/material-ui/.yarn/releases/yarn-1.22.10.js start
Directory: /Users/apple2/Desktop/Code/material-ui/docs
Output:

info Visit https://yarnpkg.com/en/docs/cli/workspace for documentation about this command.
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
apple2@apple2s-iMac material-ui %

我应该为每个命令输入添加终端输出吗？（纱线docs:build为大量线数）

Answer 1

错误消息 EADDRINUSE 告诉您您已经在端口 3000 上侦听了一些东西。您需要停止 process/application 当前正在使用端口 3000 以便您可以运行 MUI 文档或告诉 MUI 文档使用另一个端口。

您可以执行以下操作之一：

告诉 MUI 文档运行在不同的端口：yarn docs:start --port=3001（这可能是你最好的选择。）
查找应用程序（可能是另一个终端 window -- 你的另一个 React 应用程序？）并停止它 (Ctrl + C)
重启你的机器并确保没有任何东西开始监听端口 3000。
在终端中找到进程ID并手动杀死它。

要在终端中找到进程 ID 并手动终止它，请在 Mac 上打开终端并键入以下命令：

获取侦听端口 3000 的所有进程的列表（sudo 将要求您输入密码）

sudo lsof -i :3000

将显示当前侦听端口 3000 的进程列表。例如：

COMMAND   PID           USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
node    53763 [your username]   28u  IPv4 0x6c9dbf461b729ff1      0t0  TCP *:hbci (LISTEN)

在列表中找到您要终止的进程的进程 ID (PID)——在上面的示例中，进程 ID 是“53763”。

终止进程：

kill -9 53763

现在尝试 re-run MUI 文档：

yarn docs:start

如何离线查看组件的 MUI 库和 API？

How can I view MUI library of components and API's offline?

terminal

material-ui

material-components

material-components-ios