Merge branch 'progit:master' into master

.github/ISSUE_TEMPLATE/bug_report.md

@@ -10,10 +10,10 @@ assignees: ''
 <!-- Before filing a bug please check the following: -->
 <!-- * There's no existing/similar bug report. -->
 <!-- * This bug report is about a single actionable bug. -->
-<!-- * This bug is about the Pro Git book, version 2, English language. -->
-<!-- * This bug is about the book as found on the [website](https://www.git-scm.com/book/en/v2) or the pdf. -->
-<!-- * If you found a issue in the pdf/epub/mobi files, you've checked if the problem is also present in the Pro Git book on the [website](https://www.git-scm.com/book/en/v2). -->
-<!-- * This bug is **not** about a translation, if so please file a bug with the translation project. You can find a table of translation projects here: [progit2/TRANSLATING.md](https://github.com/progit/progit2/blob/master/TRANSLATING.md) -->
+<!-- * This bug is about the Pro Git book, version 2, Chinese language. -->
+<!-- * This bug is about the book as found on the [website](https://www.git-scm.com/book/zh/v2) or the pdf. -->
+<!-- * If you found a issue in the pdf/epub/mobi files, you've checked if the problem is also present in the Pro Git book on the [website](https://www.git-scm.com/book/zh/v2). -->
+<!-- * This bug is about Chinese translation. You can find a table of translation projects here: [progit2/TRANSLATING.md](https://github.com/progit/progit2/blob/master/TRANSLATING.md) -->
 <!-- * This bug is **not** about the git-scm.com site, if so please file a bug here: [git-scm.com/issues/new](https://github.com/git/git-scm.com/issues/new) -->
 <!-- * This bug is **not** about git the program itself, if so please file a bug here: [git-scm.com/community](https://git-scm.com/community) -->
 <!-- * This bug is **not** about Git for Windows, if so please file a bug here: [git-for-windows/git](https://github.com/git-for-windows/git). -->

.github/workflows/pr-build.yml

@@ -8,17 +8,13 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
 
-    - name: Download bootstrap file
-      run: wget https://raw.githubusercontent.com/progit/progit2-pub/master/bootstrap.sh
-    - name: Run bootstrap
-      run: sh bootstrap.sh
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1
       with:
         ruby-version: 2.7
         bundler-cache: true # runs 'bundle install' and caches installed gems automatically
 
     - name: Build book
-      run: bundle exec rake book:build_action
+      run: bundle exec rake book:build

.github/workflows/release-on-merge.yml

@@ -8,21 +8,17 @@ jobs:
   release:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0
-    - name: get bootstrap file
-      run: wget https://raw.githubusercontent.com/progit/progit2-pub/master/bootstrap.sh
-    - name: run bootstrap
-      run: sh bootstrap.sh
     - name: Compute tag name
       id: compute-tag
       run: |
         echo Computing next tag number
         LASTPATCH=$(git describe --tags | cut -d- -f1 | cut -d. -f3)
         PATCH=$(($LASTPATCH+1))
-        echo "::set-output name=tagname::2.1.${PATCH}"
-        echo "::set-output name=branch::${GITHUB_REF#refs/heads/}"
+        echo "tagname=2.1.${PATCH}" >> $GITHUB_OUTPUT
+        echo "branch=${GITHUB_REF#refs/heads/}" >> $GITHUB_OUTPUT
 
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1
@@ -31,12 +27,12 @@ jobs:
         bundler-cache: true # runs 'bundle install' and caches installed gems automatically
 
     - name: Build release assets
-      run: bundle exec rake book:build_action
+      run: bundle exec rake book:build
 
     - name: Create release
       uses: ncipollo/release-action@v1
       with:
         token: ${{ secrets.GITHUB_TOKEN }}
         tag: ${{ steps.compute-tag.outputs.tagname }}
         commit: ${{ steps.compute-tag.outputs.branch }}
-        artifacts: './progit.epub,./progit.mobi,./progit.pdf,./progit.html'
+        artifacts: './progit.epub,./progit.fb2.zip,./progit.mobi,./progit.pdf,./progit.html'

.gitignore

@@ -7,6 +7,7 @@ progit.html
 progit.pdf
 progit.pdfmarks
 progit.epub
+progit.fb2.zip
 progit-kf8.epub
 progit.mobi
 contributors.txt

A-git-in-other-environments.asc

@@ -14,8 +14,6 @@ include::book/A-git-in-other-environments/sections/visualstudio.asc[]
 
 include::book/A-git-in-other-environments/sections/visualstudiocode.asc[]
 
-include::book/A-git-in-other-environments/sections/eclipse.asc[]
-
 include::book/A-git-in-other-environments/sections/jetbrainsides.asc[]
 
 include::book/A-git-in-other-environments/sections/sublimetext.asc[]

C-git-commands.asc

@@ -2,11 +2,11 @@
 [appendix]
 == Git 命令
 
-在这一整本书里我们介绍了大量的 Git 命令，并尽可能的通过讲故事的的方式来介绍它们，慢慢的介绍了越来越多的命令。
-但是这导致这些命令的示例用法都散落在在全书的各处。
+在这一整本书里我们介绍了大量的 Git 命令，并尽可能通过讲故事的方式来介绍它们，慢慢介绍了越来越多的命令。
+但是这导致这些命令的示例用法都散落在全书的各处。
 
-在此附录中，我们会将本书中所提到过的命令都过一遍，并根据其用途大致的分类。
-我们会大致地讨论每个命的作用，指出其在本书中哪些章节使用过。
+在此附录中，我们会将本书中所提到过的命令都过一遍，并根据其用途进行大致分类。
+我们会大致地讨论每个命令的作用，指出其在本书中哪些章节使用过。
 
 [TIP]
 ====
@@ -18,8 +18,7 @@
 
 === 设置与配置
 
-有两个十分常用的命令：`config` 和 `help`。
-从第一次调用 Git 到日常微调及阅读参考，它们一直陪伴着你。
+有两个十分常用的命令：`config` 和 `help`。从第一次调用 Git 到日常微调及阅读参考，它们一直陪伴着你。
 
 ==== git config
 
@@ -42,7 +41,7 @@ Git 做的很多工作都有一种默认方式。
 
 最后，基本上 <<ch08-customizing-git#_git_config>> 整个章节都是针对此命令的。
 
-[[_core_editor]]
+[[ch_core_editor]]
 ==== git config core.editor 命令
 
 就像 <<ch01-getting-started#_first_time>> 里的设置指示，很多编辑器可以如下设置：
@@ -52,23 +51,26 @@ Git 做的很多工作都有一种默认方式。
 |==============================
 |编辑器 | 设置命令
 |Atom |`git config --global core.editor "atom --wait"`
-|BBEdit (Mac, with command line tools) |`git config --global core.editor "bbedit -w"`
+|BBEdit (macOS, with command line tools) |`git config --global core.editor "bbedit -w"`
 |Emacs |`git config --global core.editor emacs`
 |Gedit (Linux) |`git config --global core.editor "gedit --wait --new-window"`
-|Gvim (Windows 64-bit) |`git config --global core.editor "'C:/Program Files/Vim/vim72/gvim.exe' --nofork '%*'"` (Also see note below)
-|Kate (Linux) |`git config --global core.editor "kate"`
+|Gvim (Windows 64-bit) |`git config --global core.editor "'C:\Program Files\Vim\vim72\gvim.exe' --nofork '%*'"` (Also see note below)
+|Helix |`git config --global core.editor "hx"`
+|Kate (Linux) |`git config --global core.editor "kate --block"`
 |nano |`git config --global core.editor "nano -w"`
 |Notepad (Windows 64-bit) |`git config core.editor notepad`
-|Notepad++ (Windows 64-bit) |`git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"` (Also see note below)
+|Notepad++ (Windows 64-bit) |`git config --global core.editor "'C:\Program Files\Notepad\++\notepad++.exe' -multiInst -notabbar -nosession -noPlugin"` (Also see note below)
 |Scratch (Linux)|`git config --global core.editor "scratch-text-editor"`
 |Sublime Text (macOS) |`git config --global core.editor "/Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl --new-window --wait"`
-|Sublime Text (Windows 64-bit) |`git config --global core.editor "'C:/Program Files/Sublime Text 3/sublime_text.exe' -w"` (Also see note below)
-|TextEdit (macOS)|`git config --global --add core.editor "open -W -n"`
+|Sublime Text (Windows 64-bit) |`git config --global core.editor "'C:\Program Files\Sublime Text 3\sublime_text.exe' -w"` (Also see note below)
+|TextEdit (macOS)|`git config --global core.editor "open --wait-apps --new -e"`
 |Textmate |`git config --global core.editor "mate -w"`
-|Textpad (Windows 64-bit) |`git config --global core.editor "'C:/Program Files/TextPad 5/TextPad.exe' -m` (Also see note below)
-|Vim |`git config --global core.editor "vim"`
-|VS Code |`git config --global core.editor "code --wait"`
-|WordPad |`git config --global core.editor '"C:\Program Files\Windows NT\Accessories\wordpad.exe"'"`
+|Textpad (Windows 64-bit) |`git config --global core.editor "'C:\Program Files\TextPad 5\TextPad.exe' -m"` (Also see note below)
+|UltraEdit (Windows 64-bit) | `git config --global core.editor Uedit32`
+|Vim |`git config --global core.editor "vim --nofork"`
+|Visual Studio Code |`git config --global core.editor "code --wait"`
+|VSCodium (Free/Libre Open Source Software Binaries of VSCode) | `git config --global core.editor "codium --wait"`
+|WordPad |`git config --global core.editor "'C:\Program Files\Windows NT\Accessories\wordpad.exe'"`
 |Xi | `git config --global core.editor "xi --wait"`
 |==============================
 
@@ -84,7 +86,6 @@ Git 做的很多工作都有一种默认方式。
 
 我们在 <<ch01-getting-started#_git_help>> 一节中介绍了 `git help` 命令，同时在 <<ch04-git-on-the-server#_setting_up_server>> 一节中给你展示了如何使用它来查找更多关于 `git shell` 的信息。
 
-
 === 获取与创建项目
 
 有几种方式获取一个 Git 仓库。
@@ -119,7 +120,6 @@ Git 做的很多工作都有一种默认方式。
 
 虽然在本书的其他地方都有用到此命令，但是上面这些用法是特例，或者使用方式有点特别。
 
-
 === 快照基础
 
 对于基本的暂存内容及提交到你的历史记录中的工作流，只有少数基本的命令。
@@ -312,7 +312,6 @@ Git 有几个实现大部的分支及合并功能的实用命令。
 
 我也在 <<ch07-git-tools#_signing>> 一节中介绍了如何使用 `-s` 标志创建一个 GPG 签名的标签，然后使用 `-v` 选项来验证。
 
-
 === 项目分享与更新
 
 在 Git 中没有多少访问网络的命令，几乎所以的命令都是在操作本地的数据库。
@@ -414,7 +413,6 @@ Git 有几个实现大部的分支及合并功能的实用命令。
 
 我们在 <<ch05-distributed-git#_build_number>> 及 <<ch05-distributed-git#_preparing_release>> 章节中使用 `git describe` 命令来获得一个字符串来命名我们发布的文件。
 
-
 === 调试
 
 Git 有一些命令可以用来帮你调试你代码中的问题。
@@ -496,14 +494,14 @@ Git 中的一些命令是以引入的变更即提交这样的概念为中心的
 
 ==== git format-patch
 
-
 `git format-patch` 命令用来以 mbox 的格式来生成一系列的补丁以便你可以发送到一个邮件列表中。
 
 我们在 <<ch05-distributed-git#_project_over_email>> 一节中研究了一个使用 `git format-patch` 工具为一个项目做贡献的示例。
 
-
 ==== git imap-send
+
 `git imap-send` 将一个由 `git format-patch` 生成的邮箱上传至 IMAP 草稿文件夹。
+
 我们在 <<ch05-distributed-git#_project_over_email>> 一节中见过一个通过使用 `git imap-send` 工具向一个项目发送补丁进行贡献的例子。
 
 ==== git send-email
@@ -549,7 +547,6 @@ Git 有一些可以与其他的版本控制系统集成的命令。
 
 ==== git fsck
 
-
 `git fsck` 命令用来检查内部数据库的问题或者不一致性。
 
 我们只在 <<ch10-git-internals#_data_recovery>> 这一节中快速使用了一次此命令来搜索所有的悬空对象（dangling object）。
@@ -568,7 +565,7 @@ Git 有一些可以与其他的版本控制系统集成的命令。
 
 在 <<ch07-git-tools#_removing_file_every_commit>> 一节中，我们解释了此命令，并探究了其他几个选项，例如 `--commit-filter`，`--subdirectory-filter` 及 `--tree-filter` 。
 
-在 <<ch09-git-and-other-systems#_git_p4>> 和 <<ch09-git-and-other-systems#_git_tfs>> 的章节中我们使用它来修复已经导入的外部仓库。
+在 <<ch09-git-and-other-systems#_git_p4>> 的章节中我们使用它来修复已经导入的外部仓库。
 
 === 底层命令
 

Gemfile

@@ -1,22 +1,23 @@
 source 'https://rubygems.org'
 
+gem 'ffi', '1.16.3'
 gem 'rake'
-gem 'asciidoctor', '1.5.6.2'
+gem 'asciidoctor', '2.0.12'
 
 gem 'json'
 gem 'awesome_print'
 
-gem 'ttfunk', '= 1.5.1'
-gem 'asciidoctor-epub3', '1.5.0.alpha.9'
+gem 'ttfunk', '1.5.1'
+gem 'asciidoctor-fb2'
+gem 'asciidoctor-epub3', '1.5.0.alpha.11'
 gem 'asciidoctor-pdf', '1.5.0.alpha.16'
 gem 'asciidoctor-pdf-cjk', '~> 0.1.3'
-gem 'asciidoctor-pdf-cjk-kai_gen_gothic', '~> 0.1.1'
+gem 'asciidoctor-pdf-cjk-kai_gen_gothic', github: 'Sherry520/asciidoctor-pdf-cjk-kai_gen_gothic'
 
 gem 'coderay'
 gem 'pygments.rb'
 gem 'thread_safe'
 gem 'epubcheck-ruby'
-gem 'kindlegen'
+gem 'html-proofer'
 
-gem 'octokit'
-gem 'github_changelog_generator', github: 'Furtif/github-changelog-generator'
+gem 'kindlegen', '3.1.1'

README.asc

@@ -34,6 +34,33 @@ Converting to PDF...
  -- PDF output at progit.pdf
 ----
 
+你可以只生成一种支持的格式（ HTML、EPUB、mobi、或 PDF ）。
+使用以下命令之一：
+
+生成 HTML 图书：
+
+----
+$ bundle exec rake book:build_html
+----
+
+生成 EPUB 图书：
+
+----
+$ bundle exec rake book:build_epub
+----
+
+生成 mobi 图书：
+
+----
+$ bundle exec rake book:build_mobi
+----
+
+生成 PDF 图书：
+
+----
+$ bundle exec rake book:build_pdf
+----
+
 ## 发起一个 Issue
 
 在发起一个 Issue 前，请在 bug 跟踪系统中搜索是否已有类似的问题。