用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.
使用 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.