Skip to content

Commit

Permalink
fixup! Migrate to the required file structure for asciidoctor
Browse files Browse the repository at this point in the history
  • Loading branch information
jnavila committed Feb 23, 2018
1 parent 6088546 commit f4059ad
Show file tree
Hide file tree
Showing 6 changed files with 7 additions and 8 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -245,7 +245,7 @@ please contact us at email.support@github.com
</div>
----

這個解決方案分別採納了兩個分支中的各一部分內容,並且完整地移除了 `>>>>>` 這些標記行。
這個解決方案分別採納了兩個分支中的各一部分內容,並且完整地移除了 `<<<<<<<`、`=======` 和 `>>>>>>>` 這些標記行。
在解決了每個衝突檔案裡的每個衝突後,對每個檔案執行 `git add` 會將它們標記為已解決狀態,
因為預存(stage)動作代表了衝突已經解決。

Expand Down
6 changes: 3 additions & 3 deletions book/06-github/sections/2-contributing.asc
Original file line number Diff line number Diff line change
Expand Up @@ -187,7 +187,7 @@ image::images/blink-06-final.png[結束 Pull Request]

這是個很重要的差異,因為通常變動會在程式碼完備之前就被提出,這點跟基於郵件清單的運作模式是天差地遠的。這讓維護者們可以更早做溝通,讓適合的解決方案可以在接受更多社群能量下誕生。當有人使用 Pull Request 提出程式碼,然後維護者或是社群建議了一個變更,雖然這補丁系列不會重來,但相對的會以一個新的提交的形式加入這個分支,並讓討論和背景可以齊頭並進。

舉例來說,你可以回到 這邊看看,你會注意到那個貢獻者並沒有把他的提交重組之後另外開個新的 Pull Request,而是加入新的提交並推送到原本的分支。如果之後你回去看看 Pull Request,你可以看到之前我們為何做了這樣的變動的背景。當按下網站上的「Merge」鈕時,會建立一個參考那個 Pull Request 的合併提交,這樣當有需要時你可以很容易的就找到它並研究當初的交談內容。
舉例來說,你可以回到 <<r_pr_final>> 這邊看看,你會注意到那個貢獻者並沒有把他的提交重組之後另外開個新的 Pull Request,而是加入新的提交並推送到原本的分支。如果之後你回去看看 Pull Request,你可以看到之前我們為何做了這樣的變動的背景。當按下網站上的「Merge」鈕時,會建立一個參考那個 Pull Request 的合併提交,這樣當有需要時你可以很容易的就找到它並研究當初的交談內容。

===== 跟上上游

Expand All @@ -197,7 +197,7 @@ image::images/blink-06-final.png[結束 Pull Request]
.不能乾淨的合併的 Pull Request
image::images/pr-01-fail.png[Pull Request 合併失敗]

如果你看到類似 的畫面,你就會希望去對你的分支做修正讓那個標示轉綠,之後維護者就不需要做額外的事。
如果你看到類似 <<r_pr_fail>> 的畫面,你就會希望去對你的分支做修正讓那個標示轉綠,之後維護者就不需要做額外的事。

你有兩個方式可以來處理這個狀況。你可以用變基把你的分支接在目標分支 (通常會是你 fork 的專案的 `master` 分支) 上,或是把目標分支合併進你的分支。

Expand Down Expand Up @@ -364,7 +364,7 @@ image::images/markdown-04-fenced-code.png[渲染過的嵌入代碼]
How big are these slings and in particular, these arrows?
----

經過渲染之後評論就會變成 這個樣子。
經過渲染之後評論就會變成 <<r_md_quote>> 這個樣子。

[[r_md_quote]]
.渲染過的引文範例
Expand Down
2 changes: 1 addition & 1 deletion book/06-github/sections/3-maintaining.asc
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,7 @@ image::images/maint-02-merge.png[Merge 按鈕]

To demonstrate this, we're going to use a low-level command (often referred to as a ``plumbing'' command, which we'll read about more in <<ch10-git-internals#r_plumbing_porcelain>>) called `ls-remote`.
This command is generally not used in day-to-day Git operations but it's useful to show us what references are present on the server.
為了展示這個事實,我們要使用一個比較低階的指令(通常會被稱作「底層」指令,關於這點我們會在 再做詳細描述)—— `ls-remote`。
為了展示這個事實,我們要使用一個比較低階的指令(通常會被稱作「底層」指令,關於這點我們會在 <<ch10-git-internals#r_plumbing_porcelain>> 再做詳細描述)—— `ls-remote`。
這指令通常不會在日常的 Git 操作使用,但在展現伺服器上的所有參照是非常有用的。

如果對我們之前的「blink」倉儲使用這條指令,我們會得到在伺服器上這個倉儲裡所有的分支、標籤和其他各種參照的清單。
Expand Down
2 changes: 1 addition & 1 deletion book/07-git-tools/sections/advanced-merging.asc
Original file line number Diff line number Diff line change
Expand Up @@ -465,7 +465,7 @@ index 0399cd5,59727f0..0000000
The format is called ``Combined Diff'' and gives you two columns of data next to each line.
The first column shows you if that line is different (added or removed) between the ``ours'' branch and the file in your working directory and the second column does the same between the ``theirs'' branch and your working directory copy.

So in that example you can see that the `>>>>>` lines are in the working copy but were not in either side of the merge.
So in that example you can see that the `<<<<<<<` and `>>>>>>>` lines are in the working copy but were not in either side of the merge.
This makes sense because the merge tool stuck them in there for our context, but we're expected to remove them.

If we resolve the conflict and run `git diff` again, we'll see the same thing, but it's a little more useful.
Expand Down
2 changes: 1 addition & 1 deletion book/license.asc
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
[preface]
== 许可证
== 授權條款

include::../LICENSE.asc[]
1 change: 0 additions & 1 deletion progit.asc
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,6 @@ $$VERSION$$, $$DATE$$
:pdf-page-size: A4
:pagenums:
:front-cover-image: image:book/cover.png[width=1050,height=1600]
:toc-title: 目录
:appendix-caption: 附錄
:appendix-refsig: {appendix-caption}
:caution-caption: 注意
Expand Down

0 comments on commit f4059ad

Please sign in to comment.