用github写一本书

pis*_*hio 9 github githooks github-pages

使用Github,可以编写格式良好的README.md文件和文档来呈现项目.此外,还有维基页面供用户协作.我正在徘徊什么是最佳工作流程,即使对于非技术用户,也要利用GitHub平台编写协作书.

如何使用markdown然后通过应用样式表来增强它,从中创建PDF,组织章节,从中获取公共站点(gh-pages)等等?GitHub有这样的项目或工具链吗?

换句话说,如何在GitHub中轻松编写带有漂亮的html和PDF输出的协作书?谢谢.

Chr*_*ris 14

这正是GitBook的设计目标:

GitBook是一个命令行工具(和Node.js库),用于使用GitHub/Git和Markdown(或AsciiDoc)构建精美的书籍.

支持开箱即用的PDF输出,以及在自己的网络平台上进行在线发布.

  • Gitbook 在 V2 中删除了 PDF 导出,因此这个答案实际上不再适用。这是一个 CLI 工具,可以从 v2 Gitbook 导出创建 PDF:https://www.forgebox.io/view/gitbook-exporter (2认同)