用github写一本书

Question

使用Github，可以编写格式良好的README.md文件和文档来显示项目。此外，还有供用户协作的wiki页面。我想知道什么是最优的工作流程，即使对非科技用户来说也是如此，如何利用GitHub平台编写一本协作书。

如何使用标记，然后通过应用样式表来增强它，用它制作PDF，组织章节，在其中创建一个公共站点(gh-page)等等？GitHub是否有这样的项目或工具链？

换句话说，如何在GitHub中轻松地编写一本具有良好html和PDF输出的协作书？谢谢。

Answer 1

编辑:自从我第一次写这个答案以来， GitBook发生了很大的变化。PDF支持已被删除，并且CLI工具链已被放弃，转而使用专有服务

由于GitBook团队的工作集中在GitBook.com平台上，所以CLI不再处于积极开发阶段。

在2019年中期，mdBook是一个不错的选择，尽管它本机不支持PDF。如果你安装了铁锈和货物，你可以简单地

cargo install mdbook

开始吧。

原始答案：

这正是GitBook设计的目的：

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

它可以开箱即用，也可以在它自己的网络平台上进行在线发布。