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

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

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

  1. 不能破坏当前的目录结构，可复用 SUMMARY.md 当做菜单或者目录
  2. 能生成 PDF 文档（带有封面 /目录，非单个 md 文件生成）
6257 次点击
所在节点    程序员
28 条回复
mlboy
2020-09-09 02:45:02 +08:00
不如换台新电脑？
raaaaaar
2020-09-09 07:02:45 +08:00
没人用 mdbook ？模仿 gitbook 的，但编译速度快许多。
12101111
2020-09-09 09:20:38 +08:00
@raaaaaar 楼主要输出到 pdf,现在 mdbook 好像没有支持生成 pdf 书签的后端
aiifabbf
2020-09-09 09:47:58 +08:00
sphinx <sphinx-doc.org/> 可以输出到各种格式（ LaTeX, html, man page ），好像 Python 和 Swift 的官方文档都是用这个生成的。
SpiritLingPub
2020-09-09 11:03:00 +08:00
我觉得你直接用看云吧，看云和 gitbook 很相似的，都是 summary 来设置目录，而且看云也是 git 管理的。
JCZ2MkKb5S8ZX9pq
2020-09-09 11:50:20 +08:00
docsify，然后自己写了个目录生成.py
0703wzq
2020-09-09 18:56:06 +08:00
docsify 无需编译。
solider245
2020-09-09 23:15:45 +08:00
我想知道 docsify 如何自动生成目录呢？文件少还好，多了的话，每篇文章都要写一个目录，扛不住啊

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

https://ex.noerr.eu.org/t/705129

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

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

© 2021 V2EX