Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Insert spaces around backticks for markups to be correctly detected #141

Open
wants to merge 6 commits into
base: master
Choose a base branch
from
26 changes: 13 additions & 13 deletions book/02-git-basics/sections/recording-changes.asc
Original file line number Diff line number Diff line change
Expand Up @@ -174,14 174,14 @@ Changes not staged for commit:
----

//////////////////////////
The `CONTRIBUTING.md` file appears under a section named ``Changes not staged for commit'' – which means that a file that is tracked has been modified in the working directory but not yet staged.
The `CONTRIBUTING.md` file appears under a section named "`Changes not staged for commit`" -- which means that a file that is tracked has been modified in the working directory but not yet staged.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we need this kind of change 🤔

Suggested change
The `CONTRIBUTING.md` file appears under a section named "`Changes not staged for commit`" -- which means that a file that is tracked has been modified in the working directory but not yet staged.
The `CONTRIBUTING.md` file appears under a section named ``Changes not staged for commit'' -- which means that a file that is tracked has been modified in the working directory but not yet staged.

To stage it, you run the `git add` command.
`git add` is a multipurpose command – you use it to begin tracking new files, to stage files, and to do other things like marking merge-conflicted files as resolved.
It may be helpful to think of it more as ``add this content to the next commit'' rather than ``add this file to the project''.(((git commands, add)))
It may be helpful to think of it more as "`add this content to the next commit`" rather than "`add this file to the project`".(((git commands, add)))
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
It may be helpful to think of it more as "`add this content to the next commit`" rather than "`add this file to the project`".(((git commands, add)))
It may be helpful to think of it more as ``add this content to the next commit'' rather than ``add this file to the project''.(((git commands, add)))

Let's run `git add` now to stage the `CONTRIBUTING.md` file, and then run `git status` again:
//////////////////////////
`CONTRIBUTING.md` ファイルは ``Changed but not staged for commit'' という欄に表示されます。これは、追跡対象のファイルが作業ディレクトリ内で変更されたけれどもまだステージされていないという意味です。
ステージするには `git add` コマンドを実行します。 `git add` にはいろんな意味合いがあり、新しいファイルの追跡開始・ファイルのステージング・マージ時に衝突が発生したファイルに対する「解決済み」マーク付けなどで使用します。``指定したファイルをプロジェクトに追加(add)する''コマンド、というよりは、``指定した内容を次のコミットに追加(add)する''コマンド、と捉えるほうがわかりやすいかもしれません。(((git commands, add)))
`CONTRIBUTING.md` ファイルは "`Changed but not staged for commit`" という欄に表示されます。これは、追跡対象のファイルが作業ディレクトリ内で変更されたけれどもまだステージされていないという意味です。
ステージするには `git add` コマンドを実行します。 `git add` にはいろんな意味合いがあり、新しいファイルの追跡開始・ファイルのステージング・マージ時に衝突が発生したファイルに対する「解決済み」マーク付けなどで使用します。 "`指定したファイルをプロジェクトに追加(add)する`" コマンド、というよりは、 "`指定した内容を次のコミットに追加(add)する`" コマンド、と捉えるほうがわかりやすいかもしれません。(((git commands, add)))
Comment on lines 183 to 184
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`CONTRIBUTING.md` ファイルは "`Changed but not staged for commit`" という欄に表示されます。これは、追跡対象のファイルが作業ディレクトリ内で変更されたけれどもまだステージされていないという意味です。
ステージするには `git add` コマンドを実行します。 `git add` にはいろんな意味合いがあり、新しいファイルの追跡開始・ファイルのステージング・マージ時に衝突が発生したファイルに対する「解決済み」マーク付けなどで使用します。 "`指定したファイルをプロジェクトに追加(add)する`" コマンド、というよりは、 "`指定した内容を次のコミットに追加(add)する`" コマンド、と捉えるほうがわかりやすいかもしれません。(((git commands, add)))
`CONTRIBUTING.md` ファイルは ``Changed but not staged for commit'' という欄に表示されます。これは、追跡対象のファイルが作業ディレクトリ内で変更されたけれどもまだステージされていないという意味です。
ステージするには `git add` コマンドを実行します。 `git add` にはいろんな意味合いがあり、新しいファイルの追跡開始・ファイルのステージング・マージ時に衝突が発生したファイルに対する「解決済み」マーク付けなどで使用します。 ``指定したファイルをプロジェクトに追加(add)する'' コマンド、というよりは、 ``指定した内容を次のコミットに追加(add)する'' コマンド、と捉えるほうがわかりやすいかもしれません。(((git commands, add)))

では、`git add` で `CONTRIBUTING.md` をステージしてもういちど `git status` を実行してみましょう。

[source,console]
Expand Down Expand Up @@ -266,7 266,7 @@ If you run `git status -s` or `git status --short` you get a far more simplified
//////////////////////////
`git status` の出力はとてもわかりやすいですが、一方で冗長でもあります。
Gitにはそれを簡略化するためのオプションもあり、変更点をより簡潔に確認できます。
`git status -s``git status --short`コマンドを実行して、簡略化された状態表示を見てみましょう。
`git status -s``git status --short` コマンドを実行して、簡略化された状態表示を見てみましょう。

[source,console]
----
Expand All @@ -284,11 284,11 @@ There are two columns to the output - the left hand column indicates that the fi
So for example in that output, the `README` file is modified in the working directory but not yet staged, while the `lib/simplegit.rb` file is modified and staged.
The `Rakefile` was modified, staged and then modified again, so there are changes to it that are both staged and unstaged.
//////////////////////////
まだ追跡されていない新しいファイルには`??`が、ステージングエリアに追加されたファイルには`A`が、変更されたファイルには`M`が、といったように、ファイル名の左側に文字列が表示されます。
まだ追跡されていない新しいファイルには `??` が、ステージングエリアに追加されたファイルには `A` が、変更されたファイルには `M` が、といったように、ファイル名の左側に文字列が表示されます。
内容は2文字の組み合わせです。1文字目はステージされたファイルの状態を、2文字はファイルが変更されたかどうかを示しています。
この例でいうと、`README`ファイルは作業ディレクトリ上にあって変更されているけれどステージされてはいません。
`lib/simplegit.rb`ファイルは変更済みでステージもされています。
`Rakefile`のほうはどうかというと、変更されステージされたあと、また変更された、という状態です。変更の内容にステージされたものとそうでないものがあることになります。
この例でいうと、`README` ファイルは作業ディレクトリ上にあって変更されているけれどステージされてはいません。
`lib/simplegit.rb` ファイルは変更済みでステージもされています。
`Rakefile` のほうはどうかというと、変更されステージされたあと、また変更された、という状態です。変更の内容にステージされたものとそうでないものがあることになります。

[[r_ignoring]]
//////////////////////////
Expand Down Expand Up @@ -352,7 352,7 @@ glob パターンとは、シェルで用いる簡易正規表現のようなも
また、ハイフン区切りの文字を角括弧で囲んだ形式 (`[0-9]`) は、
ふたつの文字の間の任意の文字 (この場合は 0 から 9 までの間の文字) にマッチします。
アスタリクスを2つ続けて、ネストされたディレクトリにマッチさせることもできます。
`a/**/z` のように書けば、`a/z`、`a/b/z`、`a/b/c/z`などにマッチします。
`a/**/z` のように書けば、`a/z`、`a/b/z`、`a/b/c/z` などにマッチします。

//////////////////////////
Here is another example .gitignore file:
Expand Down Expand Up @@ -577,10 577,10 @@ Run `git difftool --tool-help` to see what is available on your system.
//////////////////////////
.GitのDiffを他のツールで見る
====
この本では、引き続き`git diff`コマンドを様々な方法で使っていきます。
この本では、引き続き `git diff` コマンドを様々な方法で使っていきます。
一方、このコマンドを使わずに差分を見る方法も用意されています。GUIベースだったり、他のツールが好みの場合、役に立つでしょう。
`git diff`の代わりに`git difftool`を実行してください。そうすれば、emerge、vimdiffなどのツールを使って差分を見られます(商用のツールもいくつもあります)。
また、`git difftool --tool-help`を実行すれば、利用可能なdiffツールを確認することもできます。
`git diff` の代わりに `git difftool` を実行してください。そうすれば、emerge、vimdiffなどのツールを使って差分を見られます(商用のツールもいくつもあります)。
また、`git difftool --tool-help` を実行すれば、利用可能なdiffツールを確認することもできます。
====

[[r_committing_changes]]
Expand Down
4 changes: 2 additions & 2 deletions book/09-git-and-other-scms/sections/import-svn.asc
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 133,7 @@ $ rm -Rf .git/refs/remotes/origin
//////////////////////////
It may happen that you'll see some extra branches which are suffixed by `@xxx` (where xxx is a number), while in Subversion you only see one branch. This is actually a Subversion feature called "peg-revisions", which is something that Git simply has no syntactical counterpart for. Hence, `git svn` simply adds the svn version number to the branch name just in the same way as you would have written it in svn to address the peg-revision of that branch. If you do not care anymore about the peg-revisions, simply remove them using `git branch -d`.
//////////////////////////
このとき、Subversionではブランチが1つだったのにもかかわらず、名前が`@xxx`(xxxは数字)で終わる余分なブランチがいくつか出来てしまうことがあります。Subversionの「ペグ・リビジョン」という機能が原因なのですが、Gitにはこれと同等の機能は存在しません。よって、`git svn`コマンドはブランチ名にsvnのバージョン番号をそのまま追加します。svnでペグ・リビジョンをブランチに設定するときとまさに同じやり方です。もうペグ・リビジョンがいらないのであれば、`git branch -d`コマンドで削除してしまいましょう。
このとき、Subversionではブランチが1つだったのにもかかわらず、名前が `@xxx`(xxxは数字)で終わる余分なブランチがいくつか出来てしまうことがあります。Subversionの「ペグ・リビジョン」という機能が原因なのですが、Gitにはこれと同等の機能は存在しません。よって、`git svn` コマンドはブランチ名にsvnのバージョン番号をそのまま追加します。svnでペグ・リビジョンをブランチに設定するときとまさに同じやり方です。もうペグ・リビジョンがいらないのであれば、`git branch -d` コマンドで削除してしまいましょう。

//////////////////////////
Now all the old branches are real Git branches and all the old tags are real Git tags.
Expand All @@ -143,7 143,7 @@ Now all the old branches are real Git branches and all the old tags are real Git
//////////////////////////
There's one last thing to clean up. Unfortunately, `git svn` creates an extra branch named `trunk`, which maps to Subversion's default branch, but the `trunk` ref points to the same place as `master`. Since `master` is more idiomatically Git, here's how to remove the extra branch:
//////////////////////////
最後に後始末についてです。残念なことに、`git svn``trunk`という名前の余計なブランチを生成してしまいます。Subversionにおけるデフォルトブランチではあるのですが、`trunk`の参照が指す場所は`master`と同じです。`master`のほうが用語としてもGitらしいですから、余分なブランチは削除してしまいましょう。
最後に後始末についてです。残念なことに、`git svn``trunk` という名前の余計なブランチを生成してしまいます。Subversionにおけるデフォルトブランチではあるのですが、`trunk` の参照が指す場所は `master` と同じです。`master` のほうが用語としてもGitらしいですから、余分なブランチは削除してしまいましょう。

[source,console]
----
Expand Down
8 changes: 4 additions & 4 deletions book/A-git-in-other-environments/sections/guis.asc
Original file line number Diff line number Diff line change
Expand Up @@ -74,8 74,8 @@ Gitkのインターフェイスは次のようになっています。
.The `gitk` history viewer.
image::images/gitk.png[The `gitk` history viewer.]
//////////////////////////
.`gitk`の歴史ビューアー
image::images/gitk.png[`gitk`の歴史ビューアー]
.`gitk` の歴史ビューアー
image::images/gitk.png[`gitk` の歴史ビューアー]

//////////////////////////
On the top is something that looks a bit like the output of `git log --graph`; each dot represents a commit, the lines represent parent relationships, and refs are shown as colored boxes.
Expand Down Expand Up @@ -181,13 181,13 @@ We won't be doing a detailed rundown of these tools (they have their own documen
ここではツールの詳細な説明はしません(GitHubクライアントの自前のドキュメントがあります)が、 ``changes'' ビュー(ツールの実行時間の大半はここを使うことになると思います)の内容をざっと見ていきましょう。

//////////////////////////
* On the left is the list of repositories the client is tracking; you can add a repository (either by cloning or attaching locally) by clicking the `` '' icon at the top of this area.
* On the left is the list of repositories the client is tracking; you can add a repository (either by cloning or attaching locally) by clicking the "` `" icon at the top of this area.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* On the left is the list of repositories the client is tracking; you can add a repository (either by cloning or attaching locally) by clicking the "` `" icon at the top of this area.
* On the left is the list of repositories the client is tracking; you can add a repository (either by cloning or attaching locally) by clicking the `` '' icon at the top of this area.

* In the center is a commit-input area, which lets you input a commit message, and select which files should be included.
(On Windows, the commit history is displayed directly below this; on Mac, it's on a separate tab.)
* On the right is a diff view, which shows what's changed in your working directory, or which changes were included in the selected commit.
* The last thing to notice is the ``Sync'' button at the top-right, which is the primary way you interact over the network.
//////////////////////////
* 左側には、クライアントが追跡しているリポジトリのリストが表示されます。この領域の一番上の `` '' アイコンをクリックすると、(ローカルでクローンするかアタッチするかして)リポジトリを追加できます。
* 左側には、クライアントが追跡しているリポジトリのリストが表示されます。この領域の一番上の "` `" アイコンをクリックすると、(ローカルでクローンするかアタッチするかして)リポジトリを追加できます。
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* 左側には、クライアントが追跡しているリポジトリのリストが表示されます。この領域の一番上の "` `" アイコンをクリックすると、(ローカルでクローンするかアタッチするかして)リポジトリを追加できます。
* 左側には、クライアントが追跡しているリポジトリのリストが表示されます。この領域の一番上の `` '' アイコンをクリックすると、(ローカルでクローンするかアタッチするかして)リポジトリを追加できます。

* 真ん中はコミット入力領域です。コミットメッセージを入力したり、コミットに含めるファイルを選択したりできます。
(Windowsでは、コミットの歴史は、この下に直接表示されます。Macの場合は、別のタブに表示されます。)
* 右側はdiffビューです。作業ディレクトリの変更内容、または、選択しているコミットに含まれている内容が表示されます。
Expand Down
2 changes: 1 addition & 1 deletion book/A-git-in-other-environments/sections/powershell.asc
Original file line number Diff line number Diff line change
Expand Up @@ -50,4 50,4 @@ Windows用GitHubクライアントのユーザでない場合は、 (https://git
//////////////////////////
This will add the proper line to your `profile.ps1` file, and posh-git will be active the next time you open your prompt.
//////////////////////////
これで `profile.ps1`ファイルに適切な内容が追加されます。次にプロンプトを開いた時に、 posh-git が有効になります。
これで `profile.ps1` ファイルに適切な内容が追加されます。次にプロンプトを開いた時に、 posh-git が有効になります。
8 changes: 4 additions & 4 deletions book/A-git-in-other-environments/sections/zsh.asc
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 10,7 @@ To use it, simply run `autoload -Uz compinit && compinit` in your `.zshrc`.
Zsh's interface is a bit more powerful than Bash's:
//////////////////////////
Zshには、Git用のタブ補完ライブラリも同梱されています。
`.zshrc``autoload -Uz compinit && compinit`という行を追加するだけで、使えるようになります。
`.zshrc``autoload -Uz compinit && compinit` という行を追加するだけで、使えるようになります。
Zshのインターフェイスは、Bashよりさらに強力です。

[source,console]
Expand Down Expand Up @@ -70,14 70,14 @@ For more information on vcs_info, check out its documentation
in the `zshcontrib(1)` manual page,
or online at http://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Version-Control-Information[].
//////////////////////////
vcs_infoについての詳細は、`zshcontrib(1)`マニュアルにあるドキュメントか、オンラインであれば http://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Version-Control-Information[] を確認してみてください。
vcs_infoについての詳細は、`zshcontrib(1)` マニュアルにあるドキュメントか、オンラインであれば http://zsh.sourceforge.net/Doc/Release/User-Contributions.html#Version-Control-Information[] を確認してみてください。

//////////////////////////
Instead of vcs_info, you might prefer the prompt customization script that ships with Git, called `git-prompt.sh`; see https://github.com/git/git/blob/master/contrib/completion/git-prompt.sh[] for details.
`git-prompt.sh` is compatible with both Bash and Zsh.
//////////////////////////
一方、Gitに同梱されている`git-prompt.sh`というスクリプトでも、プロンプトをカスタマイズすることができます。vcs_infoよりも気に入るかもしれませんね。詳しくは https://github.com/git/git/blob/master/contrib/completion/git-prompt.sh[] を確認してみてください。
`git-prompt.sh`はBashとZshの両方に対応しています。
一方、Gitに同梱されている `git-prompt.sh` というスクリプトでも、プロンプトをカスタマイズすることができます。vcs_infoよりも気に入るかもしれませんね。詳しくは https://github.com/git/git/blob/master/contrib/completion/git-prompt.sh[] を確認してみてください。
`git-prompt.sh` はBashとZshの両方に対応しています。

//////////////////////////
Zsh is powerful enough that there are entire frameworks dedicated to making it better.
Expand Down
2 changes: 1 addition & 1 deletion book/B-embedding-git/sections/jgit.asc
Original file line number Diff line number Diff line change
Expand Up @@ -277,7 277,7 @@ In this case, we're asking the `origin` remote for tags, but not heads.
Also notice the use of a `CredentialsProvider` object for authentication.
//////////////////////////
これはGitクラスを使うときによくあるパターンです。メソッドがコマンドオブジェクトを返すので、パラメータを設定するメソッドチェーンを繋げていき、最後に `.call()` メソッドを呼び出すとそれらがまとめて実行されます。
このケースでは、タグを取得する際に、HEADではなく`origin`リモートを要求しています。
このケースでは、タグを取得する際に、HEADではなく `origin` リモートを要求しています。
また、`CredentialsProvider` オブジェクトを使って認証を行っていることにも注意してください。

//////////////////////////
Expand Down