Pro Git 中文版本地安装指南：10 分钟在电脑上构建并读完这本开源书

Pro Git 中文版本地安装指南10 分钟在电脑上构建并读完这本开源书【免费下载链接】progit2-zh项目地址: https://gitcode.com/gh_mirrors/pr/progit2-zh想在自己电脑上读一本 Git 中文书这篇 Pro Git 安装教程带你把 progit2-zhScott Chacon 与 Ben Straub 所著开源书 Pro Git 的简体中文翻译从 Asciidoc 源码一路构建成能直接翻阅的成品书全程约 10 分钟。动手前准备环境先自查这 4 个工具先跑一遍下面的检查命令能看到版本号就可以直接往下走。工具建议版本用途是否必需Ruby2.5 以上推荐 2.7运行构建脚本、装 Asciidoctor 全家桶必需Git最新稳定版克隆仓库构建脚本还会读取仓库的 tag 和提交信息必需Asciidoctor2.xGemfile 已锁定 2.0.12随依赖安装把 Asciidoc 源码转成各种格式的核心引擎必需Asciidoctor PDF CJK 字体1.5.x楷体 KaiGenGothic渲染 PDF 版构建时会自动下载字体想看 PDF 才需要ruby -v # 期望输出ruby 2.7.x 或更高 git -v # 期望输出git version 2.x 或更高克隆 progit2-zh 仓库并安装构建依赖三条命令每跑完一条看一眼输出对上再继续。1️⃣ 克隆仓库git clone https://gitcode.com/gh_mirrors/pr/progit2-zh.git cd progit2-zh预期结果多出一个progit2-zh目录里面有Rakefile、Gemfile和书籍总源文件progit.asc。2️⃣ 安装 Ruby 依赖bundle install预期结果滚过一排 gemasciidoctor、asciidoctor-epub3、asciidoctor-pdf 等最后一行出现Bundle complete。3️⃣可选预装 PDF 中文字体asciidoctor-pdf-cjk-kai_gen_gothic-install预期结果提示楷体字体包下载并安装完成不打算读 PDF 版可以跳过构建时它也会自己尝试下载。一条构建命令生成 4 种成品书在项目根目录执行bundle exec rake book:build它在做什么确认 CJK 字体就绪 → 按 构建脚本 里的任务顺序用 Asciidoctor 对 书籍源文件 做 Asciidoc 书籍转换 → 顺带跑一遍 HTML 与 EPUB 校验。✅ 构建结束后根目录会多出这些成品progit.html网页版打开即用progit.epub通用电子书progit.mobiKindle 电子书progit.pdf版式书也是耗时最长的一步只想要网页版跑bundle exec rake book:build_html就能只生成 HTML其余格式直接跳过。挑个格式开始读成品文件怎么读progit.html任何浏览器打开目录可直接点击跳转progit.epubCalibre、Apple Books 或 Kindle App 打开progit.mobi发送到 Kindle墨水屏体验最佳progit.pdf任意 PDF 阅读器或拿去打印PDF 和 EPUB 版的第一页就是封面看到它出现就说明这次 progit2-zh 构建大功告成。常见坑与下一步资源⚠️ 三个最容易卡住的点PDF 乱码或字体下载失败CJK 字体由构建脚本联网获取网络不稳定时先手动执行asciidoctor-pdf-cjk-kai_gen_gothic-install再重新构建。bundle install报错多数是 Ruby 太旧或缺少 C 编译工具链。先gem update --systemLinux 装 build-essential、macOS 装 Xcode Command Line Tools再重试。构建长时间停在 PDF 步骤Rakefile 里就注明 PDF 最慢等几分钟属正常赶时间就只构建book:build_html。下一步可以顺手做想看全部构建任务参数打开 Rakefile想改书里某个章节到 book/ 目录找对应章的 Asciidoc 源文件想给翻译提意见或补稿先读 TRANSLATING.md构建产物想清理重来执行bundle exec rake book:clean【免费下载链接】progit2-zh项目地址: https://gitcode.com/gh_mirrors/pr/progit2-zh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考