Pro Git 2 多格式电子书一键构建完全指南HTML、PDF、EPUB 全搞定【免费下载链接】progit2-zh项目地址: https://gitcode.com/gh_mirrors/pr/progit2-zhprogit2-zh 是经典 Git 教程《Pro Git 2》的中文版仓库。除了直接翻 AsciiDoc 源码你还可以用一条命令把它构建成 HTML、PDF、EPUB、MOBI、FB2 五种格式的电子书塞进浏览器、Kindle或者干脆打印成纸质书。下面带你从零走通整个流程。 先看看成品长什么样构建完成后仓库根目录会多出五个文件各管各的阅读场景输出文件格式适用场景progit.html网页浏览器直接打开支持全文搜索与目录跳转progit.pdf打印版桌面阅读、打印装订progit.epub电子书包Kobo、苹果图书等阅读器progit.mobiKindle 格式各类 Kindle 设备progit.fb2.zipFB2支持 FB2 的阅读软件书稿里穿插了大量手绘风格的示意图转换进上述格式后依然清晰可读 倒推回去先把 Ruby 环境装好整个构建基于 Ruby Rake准备阶段只有两步git clone https://gitcode.com/gh_mirrors/pr/progit2-zh cd progit2-zh bundle installbundle install会按 Gemfile 的声明装好全部依赖其中几个关键角色是asciidoctor核心转换引擎负责把源稿变成文档asciidoctor-pdf / asciidoctor-epub3 / asciidoctor-fb2三种格式的处理器rake把构建步骤编排成可调用的任务html-proofer、epubcheck-ruby构建完成后的自动校验asciidoctor-pdf-cjk 系列字体包保证 PDF 里的中文显示正常而不是一个个豆腐块⚡ 一条命令构建全部格式环境就绪后在仓库根目录执行rake book:build这条命令背后连做了四件事用git describe取出版本号、结合当前日期写入文档头部重新生成贡献者名单book/contributors.txt依次调用各格式转换器最后对 HTML 和 EPUB 跑一遍自动校验。其中 PDF 环节最耗时构建脚本自己都会提示 this one takes a while耐心等即可。如果只想要某一种格式直接调用对应子任务就行命令产物rake book:build_htmlprogit.htmlrake book:build_pdfprogit.pdfrake book:build_epubprogit.epubrake book:build_mobiprogit.mobirake book:build_fb2progit.fb2.ziprake book:clean清空全部生成文件 生成完成之后怎么用、怎么改HTML双击 progit.html 就能读浏览器原生支持全文搜索。PDF版面固定最适合打印或平板阅读。EPUB / MOBI通过同步工具或邮箱发送到对应阅读器即可。想换一套外观样式集中在 theme/ 目录下HTML 对应 theme/html/html.cssPDF 对应 theme/pdf/pdf.css 与 theme/pdf/pdf.xslEPUB 对应 theme/epub/epub.css。改完 CSS 重新跑一次对应的构建任务即可生效。 清理与常见问题想推倒重来rake book:clean会删掉所有生成文件包括贡献者名单缓存。构建特别慢PDF 环节本来就重属正常现象别中途杀掉。gem 版本冲突删掉 Gemfile.lock重新执行bundle install。中文缺字构建前会自动执行 kai_gen_gothic 字体安装步骤留意该步骤是否报错即可。五种格式、一条命令这本书以后想怎么读就怎么读。【免费下载链接】progit2-zh项目地址: https://gitcode.com/gh_mirrors/pr/progit2-zh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考