dumi 2.0 RC feedback

[PeachScript]

欢迎在此处讨论 beta 版的使用反馈，可以是：

1. Bug Report
2. Feature Request
3. DX Enhancement

[wkylin]

文案问题：
"由于 dumi 2.0 尚不问题"??? 应是 "尚不完善“吧

[PeachScript]

感谢反馈，已更正

[Jairwin-L]

现在移动端页面展示还没处理：

[PeachScript]

是的，响应式支持会在 RC 阶段加上

[BugCreators]

运行脚手架模板页面报错

npx create-dumi

npm start

[BugCreators]

npm

[NickJiangDev]

yarn也是同样的问题

[PeachScript]

@BugCreators @NickJiangDev 这两个我都试过了，可以运行，我的步骤：

$ npx create-dumi # 选 Static Site
$ npm i --registry=镜像源 or yarn --registry=镜像源
$ npm start

$ npm -v
8.15.0

$ yarn -v
1.22.18

[BugCreators]

@PeachScript 我没有装pnpm，尝试切换了npm版本后依旧不行，下载使用pnpm页面正常

$ npm -v
6.14.7 # 此版本下创建的模板页面报错

$ nvm use 16.18.1

$ npm -v
8.19.2 # 此版本创建的模板依旧报错

$ npm i -g pnpm

$ npx create-dumi # npm client 选 pnpm
$ npm start # 页面正常

[PeachScript]

好的，可以先 mfsu: false 绕过这个问题，我再复现看看

[zantop]

默认示例路由不对哦

[PeachScript]

👍太棒了，我修复下

[PeachScript]

• dumi@2.0.0-rc.11 有空帮忙验证下是否修复

[zantop]

可以了👍

[zantop]

API自动生成是不是还没OK

[PeachScript]

解析是需要时间的，pnpm 之类隔离幽灵依赖的仓库目前会非常慢

[zhouzyc]

路由id生成规则感觉有点问题，在Monorepo使用下，如果我每个包下面都有一个index.md，就只会出现一个。
是否能ID成才规则前在进行一定的唯一区别下，比如加上包路径，

[PeachScript]

应该是 bug，有兴趣可以来个 PR？

[zhouzyc]

应该是 bug，有兴趣可以来个 PR？

有兴趣，我fork一下，研究研究

[PeachScript]

推测关键代码在这里：

dumi/src/features/routes.ts

Line 212 in 5f90fd9

const routeId = createRouteId(file);

修改后的本地验证可以选择在 monorepo 的项目里执行 node /path/to/dumi/bin/dumi.js setup，然后查看 .dumi/tmp/core/route.ts 里的 id 是否符合预期，这样不需要等 dev 编译，等路由都 OK 了再验证 dev 即可

[yimingbot]

dev/build 时终端输出的info，可以提供配置去掉吗

info - [你知道吗？] 如果你有 MPA（多页应用）需求，可尝试新出的 mpa 配置项，详见 https://umijs.org/docs/guides/mpa

[yimingbot]

试了下base还是不对，
好像是这里basename拼接 前后都少了'/'
3d71a04#diff-8947d9a735796dce4a999c699fd6ded34f03f818151750d13c7cf68d950eea9eR54

[PeachScript]

basename 的配置项应该包含前后的 /，比如 base: '/abc/'

[PeachScript]

想问下有配置关闭“在独立页面打开”吗，这样构建产物会少一些

暂不支持，多出的只是 HTML，只能配置 exportStatic: false 把所有子页面的输出都关闭

[yimingbot]

试了下，只配置exportStatic的话，入口还是存在，点击demo会404。构建产物确实减少了

[yimingbot]

我先通过这个配置加自定义style解决啦 感谢

[Jairwin-L]

主体内容展示有图片的情况，会超出有滚动条，好像是没有宽度

[PeachScript]

的确漏掉了，有兴趣欢迎提交 PR 帮忙完善

[Jairwin-L]

有点小想法[衰]需要研究研究

[Jairwin-L]

的确漏掉了，有兴趣欢迎提交 PR 帮忙完善

请 @PeachScript pr：#1283

[Jairwin-L]

奇怪 @PeachScript 2.0.3已经发布了，但是master上好像没有这个变更？

[FangyimingLode]

现在不需要生成 .umi 的缓存了吗

[yimingbot]

https://next.d.umijs.org/guide/upgrading#%E6%9B%B4%E6%96%B0-gitignore
换文件夹了 .dumi

[FangyimingLode]

好的 谢谢

[FangyimingLode]

现在 API 表格不好使吗

这里的 components 的值是 null

[yimingbot]

开启hash路由配合base配置似乎有问题，页面渲染不出来。去掉base配置正常

  base: `/${docPath}/`,
  history: {
    type: 'hash',
  },

dev 模式下有个告警
<Router basename="/xxx"> is not able to match the URL "/" because it does not start with the basename, so the <Router> won't render anything.

[PeachScript]

这个是正常的，react-router@6 不会再 fallback basename，所以访问路径要带上 base 才能正确匹配；不过 dumi 应该很多逻辑不兼容 hash 路由，比如锚点，所以不建议使用 hash 路由

[yimingbot]

访问路径有带上base的。
还是想试试hash模式，主要是为了减少构建产物数量。

[shaodahong]

前提 Monorepo 仓库，十几个 package

dumi version 2.0.2

1. resolve.excludes 2.0 好像没有可以替换的，有些 md 或者目录不想解析的没办法自定义控制，试了 conventionRoutes 好像不顶用
2. mode: 'doc' 不支持感觉升级后想要回到 doc 模式似乎只能自己写 theme 了，现在都堆在顶部 nav 导致出现很长的滚动条
3. docDirs 和 atomDirs 似乎没感觉区别，十几个 package 文档用 docDirs 完全是错乱的，atomDirs 好像只解析第一层的 md

[PeachScript]

dumi 2 x monorepo 最佳实践还没有，问题应该会比较多，但精力关系 monorepo 短时间内还是不会有很好的支持，先回答下上面的几个问题：

1. resolve.excludes 打算变成 docDirs/atomDirs 子项下的 exclude 配置项，计划在后续版本支持
2. mode 会增加维护成本和默认主题复杂度，要回到原模式的确只能自己写 theme 了，要是能发展成主题生态也是非常好的
3. docDirs 会多层解析 + 默认不加前缀，如果 monorepo 的 doc 要加路由前缀也是可以的：dirDocs: [{ type: 'util-doc', dir: './packages/utils/docs' }]，这样所有路由均以 /util-docs 开头

[PalePlain]

大佬, 现在有 dumi 2 x monorepo 的最佳实践了吗?

[Vincent-X]

自定义除中英文之外的其他语言的时候，搜索框的placeholder会显示这个，这个是有配置项的吗？

[Vincent-X]

https://github.com/Vincent-X/dumi-v2-monorepo

[PeachScript]

默认主题只支持简中和英文，其他语言需自行补充国际化文案，例如创建 .dumi/locales/zh-TW.json：https://d.umijs.org/theme#%E6%96%87%E6%A1%88%E5%8A%A0%E8%BD%BD
或者给默认主题提 PR 支持更多语言也可以

[Vincent-X]

ok 另外api解析是不是还没做好，我看你前面的回复以为是需要等一会才会出来，然后官方demo我等了半小时都没看到😂

[hirohe]

markdown里的代码块如果是tsx会解析失败，提示关于不支持语法的错误，如果要展示tsx的demo只能使用<code></code>引入

[PeachScript]

来个错误截图？

[hirohe]

这个codesandbox

[mfoonirlee]

请问下tsconfig的compilerOptions的paths设置了alias，但是运行dev的时候mfsu报找不到对应包，需要安装这种要怎么解

[PeachScript]

框架的 alias 也要配置：https://d.umijs.org/config#alias

[mfoonirlee]

因为类型声明 IDumiUserConfig 里没有，还以为这个配置移除了XD

[PeachScript]

配置文件类型有 bug，ref #1313

[licc12]

发现一个单词有错误
https://d.umijs.org/guide/upgrading

[bigbigDreamer]

是否有计划，可以类似于 docusaurus 在不干扰原有项目配置的基础上，为 monorepo 或者 polyrepo 单独提供 pure 文档能力。

[PeachScript]

这种结构应该不需要框架做处理吧，作为独立的子包单独运行即可

[daxiazilong]

开启mfsu后直接报错：
这个模块加载不到

然后提示：

我是npm管理的monorepos结构 子包的依赖是这样的：

这些依赖放到跟packagejson里也不会报错

[daxiazilong]

entryFile 可以支持多个路径不 我一个仓库下有多个包 想使用 自动 API 表格实验性 应该怎么做

[PeachScript]

短期内支持不了，只能用一个 entry 导出所有组件，ref #1372

[Connerli]

也是一个项目管理的多个组件库，只支持一个自动 API 生成，有点难受😔, 1.0 版本根据代码注解自动生成API，不需要统一配置API 解析路径，就挺方便的。

[TrumanDu]

还是更喜欢dumi 1.0主题，目前2.0主题对大屏和PC显示不友好，页面内容居中，留白太多。
文章内容目录展示在右侧要比左面更好，尤其是文章较多的场景。

[Vincent-X]

https://github.com/Vincent-X/dumi-theme-legecy 可以康康这个 不过是基于2.0主题直接改的样式。

[limengyao]

[mortalYoung]

首页有的 https://v1.d.umijs.org/

[limengyao]

三克油 才发现~

[limengyao]

dumi1.x 内置的是father几呢？

[wulisensen]

dumi 1.x 升级 2 启动时 卡住不动了

[ayo4code]

什么时候支持umi项目内集成呀

[PeachScript]

短期内不会支持，但现在两个框架是可以一起用的

[rotate-life]

react 17.0.2； dumi升级2.+后，页面报错Cannot create property '_updatedFibers' on number '0'；请问该如何解决这个报错

[rotate-life]

因为我的项目有历史原因，不能主动升级react为18.+

[PeachScript]

版本冲突了，声明 react 版本的同时也要声明 react-dom 版本

[HugoJuntaoChen]

当前项目react 16.12, dumi升级2.+后, 打开页面会报Cannot read properties of undefined (reading '_updatedFibers'); 请问如何解决？ 如何声明react 版本和react-dom版本

[huli66]

怎么在dumi中嵌入纯react页面呀，文档写的不明明确，React路由也是只提了一嘴

[PeachScript]

ref: #1691 (comment)