目前文档是用 gitbook 写的, 200 多个页面, build 一次太慢了,请问有什么好的替代方案?

2020-09-08 11:29:44 +08:00
 JJstyle

目前 build 一次需要 100 多秒,有点无法接受,请问有什么好的替代方案? 要求:

  1. 不能破坏当前的目录结构,可复用 SUMMARY.md 当做菜单或者目录
  2. 能生成 PDF 文档(带有封面 /目录,非单个 md 文件生成)
5662 次点击
所在节点    程序员
28 条回复
qingjiaowochangd
2020-09-08 11:32:18 +08:00
vuepress
96412hj
2020-09-08 11:32:52 +08:00
jira confluence google doc 都可以呀
JJstyle
2020-09-08 11:50:38 +08:00
@qingjiaowochangd vuepress 看着不错,可以根据目录自动生成菜单吗?或者根据 SUMMARY.md 生成也行,我看需要在 js 文件中配置,似乎比较麻烦😂,我这 200 多个页面分 10 几个目录
sidkang
2020-09-08 12:02:04 +08:00
docify,summary 稍微改改应该就可以直接用了
sidkang
2020-09-08 12:02:25 +08:00
docsify 更正
afc163
2020-09-08 12:03:39 +08:00
dumi - 基于 Umi 、为组件开发场景而生的文档工具: https://d.umijs.org/
Cbdy
2020-09-08 12:18:15 +08:00
换语雀,支持导入 markdown
matrix67
2020-09-08 12:33:55 +08:00
mdbook 直接可以用的。rust 写的
matrix67
2020-09-08 12:36:27 +08:00
gitbook 里面明显用了油漆匠算法。


================
老王得到一份当街道油漆匠的工作,工作内容是在马路中间喷涂点画线。第一天, 他拿出一罐漆来到他负责的路段,喷涂了 300 码长的线。“干得不错! ”他的老板称赞道, “真是一位麻利的工匠”,然后赏给他一个戈比(一种俄罗斯辅币,译者注)。

第二天,老王只喷涂了 150 码。“喏,虽然不如昨天那样好,但你仍然算得上一位 麻利的工匠! 150 码还是值得肯定的一个长度,”老板说完又赏给他一戈比。

接下来的一天,老王只喷涂了 30 码长的马路。“才 30 码!”他的老板吼道。“这太 令人难以接受了!第一天你干的工作量是今天的 10 倍!接下来是怎么回事?〃

“我尽力了,”老王说道。“一天一天下去,我离油漆罐越来越远!〃
matrix67
2020-09-08 12:39:08 +08:00
而且 https://news.ycombinator.com/item?id=23659451 这边也有一个大佬抱怨过。

It became clear to me that, internally some sort of scaling problem is present in the code that manifests itself abruptly once the book hits a certain size.
bless110
2020-09-08 12:46:56 +08:00
我之前也用的 gitbook,然后改用的 docsify.js ,迁移比较顺利。你可以参考下 https://github.com/zhaohaodang/pro-js
jorneyr
2020-09-08 13:16:48 +08:00
我就是把 Gitbook 的改为了 Docsify,很容易
zhbzhbzhbz
2020-09-08 16:15:56 +08:00
docsify
yuhangch
2020-09-08 16:17:45 +08:00
docsify,理论上稍微改改目录就可以了
itskingname
2020-09-08 16:30:17 +08:00
@matrix67 为什么不带着油漆桶走呢
matrix67
2020-09-08 17:13:41 +08:00
@itskingname #15

所以才叫油漆匠算法啊。 你的算法是不能随着问题的规模 scale 的。

比如 gitbook 渲染 10 个页面要 10 秒; 但是加一个页面,不是多花 1 秒,是多花 11 秒哦,他就是从头吭哧吭哧渲染起的油漆匠啊。

qingjiaowochangd
2020-09-08 17:36:55 +08:00
@JJstyle 你用代码改下这个文件 修改成 vuepress 的 config 就行了
dnL
2020-09-08 17:44:19 +08:00
@itskingname 我说我杀人不眨眼,你问我眼睛干不干?
itskingname
2020-09-08 19:30:47 +08:00
@matrix67 明白了,感谢
anUglyDog
2020-09-08 21:44:22 +08:00

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/705129

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX