用github写一本书

Using github to write a book

使用 Github 可以编写格式良好的 README.md 文件和文档来展示项目。此外,还有供用户协作的 wiki 页面。我正在考虑什么是最佳工作流程,即使对于非技术用户而言,也可以利用 GitHub 平台来编写协作书籍。

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

换句话说,如何轻松地编写一本 html 且 PDF 输出 GitHub 的协作书籍?谢谢

编辑: 自从我第一次写这个答案以来,GitBook 发生了重大变化。 PDF 支持已被删除,CLI 工具链 has been abandoned in favour of a proprietary service:

As the efforts of the GitBook team are focused on the GitBook.com platform, the CLI is no longer under active development.

2019 年年中 mdBook 是一个不错的选择,尽管它本身不支持 PDF。如果你安装了 Rust 和 Cargo,你可以简单地

cargo install mdbook

开始。


原回答:

这正是 GitBook 的设计目的:

GitBook is a command line tool (and Node.js library) for building beautiful books using GitHub/Git and Markdown (or AsciiDoc).

supports PDF output out of the box, as well as online publishing on its own web platform.