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

[JJstyle]

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

1. 不能破坏当前的目录结构，可复用 SUMMARY.md 当做菜单或者目录
2. 能生成 PDF 文档（带有封面 /目录，非单个 md 文件生成）

[755rQlBW742S6Fcc]

vuepress

[96412hj]

jira confluence google doc 都可以呀

[JJstyle]

@qingjiaowochangd vuepress 看着不错，可以根据目录自动生成菜单吗？或者根据 SUMMARY.md 生成也行，我看需要在 js 文件中配置，似乎比较麻烦😂，我这 200 多个页面分 10 几个目录

[sidkang]

docify，summary 稍微改改应该就可以直接用了

[sidkang]

docsify 更正

[afc163]

dumi - 基于 Umi 、为组件开发场景而生的文档工具： https://d.umijs.org/

[Cbdy]

换语雀，支持导入 markdown

[matrix67]

mdbook 直接可以用的。rust 写的

[matrix67]

gitbook 里面明显用了油漆匠算法。


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

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

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

“我尽力了，”老王说道。“一天一天下去，我离油漆罐越来越远！〃

[matrix67]

而且 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]

我之前也用的 gitbook，然后改用的 docsify.js ，迁移比较顺利。你可以参考下 https://github.com/zhaohaodang/pro-js

[jorneyr]

我就是把 Gitbook 的改为了 Docsify，很容易

[zhbzhbzhbz]

docsify

[yuhangch]

docsify，理论上稍微改改目录就可以了

[itskingname]

@matrix67 为什么不带着油漆桶走呢

[matrix67]

@itskingname #15

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

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

[755rQlBW742S6Fcc]

@JJstyle 你用代码改下这个文件 修改成 vuepress 的 config 就行了

[dnL]

@itskingname 我说我杀人不眨眼,你问我眼睛干不干?

[itskingname]

@matrix67 明白了，感谢

[anUglyDog]

yifeishu.com