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

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

这是一个创建于 1519 天前的主题，其中的信息可能已经有所发展或是发生改变。

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

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

第 1 条附言 · 2020-09-08 12:05:04 +08:00

Summary.md 是 gitbook 用于配置目录和菜单用的，举个例子：

# Summary

* [主页](README.md)
* [最近更新](latest-updated.md)

---

* [后端开发](backend/README.md)
    * [v3.9加值券部署指南](backend/README-v3.9-coupon.md)
    * [抢红包并发模拟](backend/coupon-concurrency.md)
    * [MySQL部分字段解释](backend/mysql-field-types.md)
    * [datetime字段转timestamp](backend/db-datetime-2-timestamp.md)
    * [phpstorm使用技巧](backend/phpstorm.md)
    * [消息-在线推离线拉模式](backend/message-push-pull.md)

第 2 条附言 · 2020-09-09 11:47:50 +08:00

1. 公司内部文档，所以不接受用任何托管服务；
2. 有时候需要将部分文档生成 PDF （多页生成，包含目录和封面）给第三方。

目前 gitbook cli 能用，就是太慢了。

build

请问

文档

28 条回复 • 2020-09-09 23:15:45 +08:00

755rQlBW742S6Fcc

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 via Android

换语雀，支持导入 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.