使用 Github,我们可以编写格式良好的 README.md 文件和文档来展示项目。此外,还有供用户协作的 wiki 页面。我正在思考什么是最佳工作流程,即使对于非技术用户来说也是如此,利用 GitHub 平台编写协作书籍。
如何使用 Markdown,然后通过应用样式表来增强它、将其制作为 PDF、组织章节、建立公共站点(gh-pages)等等? GitHub有这样的项目或者工具链吗?
换句话说,如何在 GitHub 中轻松编写一本具有良好 html 和 PDF 输出的协作书籍?谢谢。
Edit:自从我第一次写这个答案以来,GitBook 已经发生了很大的变化。 PDF 支持已被删除,CLI 工具链已被放弃,取而代之的是专有服务 https://github.com/GitbookIO/gitbook/blob/master/README.md:
由于 GitBook 团队的工作重点是 GitBook.com 平台,因此 CLI 不再处于积极开发状态。
2019年中mdBook https://rust-lang-nursery.github.io/mdBook/是一个不错的选择,尽管它本身不支持 PDF。如果你安装了 Rust 和 Cargo,你可以简单地
cargo install mdbook
开始。
原答案:
这正是GitBook https://github.com/GitbookIO/gitbook专为:
GitBook 是一个命令行工具(和 Node.js 库),用于使用 GitHub/Git 和 Markdown(或 AsciiDoc)构建精美的书籍。
It 支持PDF输出 http://toolchain.gitbook.com/ebook.html开箱即用,以及在线发布自己的网络平台 https://www.gitbook.com/.
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)