Skip to content

Commit

Permalink
Merge pull request #125 from eggmoid/fix/124
Browse files Browse the repository at this point in the history
fix some asciidoc syntax problem (#124)
  • Loading branch information
pismute authored Feb 9, 2022
2 parents 9063870 + 2d69592 commit 46d9147
Show file tree
Hide file tree
Showing 61 changed files with 589 additions and 1,226 deletions.
16 changes: 8 additions & 8 deletions C-git-commands.asc
Original file line number Diff line number Diff line change
Expand Up @@ -116,9 +116,9 @@ We first introduce this in <<ch02-git-basics-chapter#_getting_a_repo>>, where we
<<ch02-git-basics-chapter#_getting_a_repo>>에서 로컬에 저장소를 만드는 방법을 설명한다.
//////////////////////////
We talk briefly about how you can change the default branch from ``master'' in <<ch03-git-branching#_remote_branches>>.
We talk briefly about how you can change the default branch from master in <<ch03-git-branching#_remote_branches>>.
//////////////////////////
``master'' 에서 다른 브랜치로 변경하는 방법은 <<ch03-git-branching#_remote_branches>>에 소개한다.
master 에서 다른 브랜치로 변경하는 방법은 <<ch03-git-branching#_remote_branches>>에 소개한다.
//////////////////////////
We use this command to create an empty bare repository for a server in <<ch04-git-on-the-server#_bare_repo>>.
Expand Down Expand Up @@ -182,10 +182,10 @@ Stage 하고 커밋하는 정도의 아주 기본적인 워크플로는 명령
==== git add
//////////////////////////
The `git add` command adds content from the working directory into the staging area (or ``index'') for the next commit.
The `git add` command adds content from the working directory into the staging area (or index) for the next commit.
When the `git commit` command is run, by default it only looks at this staging area, so `git add` is used to craft what exactly you would like your next commit snapshot to look like.
//////////////////////////
`git add` 명령은 워킹 디렉토리에서 Staging Area(``index'')로 컨텐트를 추가하는 명령어다.
`git add` 명령은 워킹 디렉토리에서 Staging Area(index)로 컨텐트를 추가하는 명령어다.
`git commit` 명령은 오로지 Staging Area만 바라보기 때문에 `git add` 명령으로 커밋할 스냅샷을 잘 다듬어야 한다.
//////////////////////////
Expand Down Expand Up @@ -705,11 +705,11 @@ This can help you be very specific about what work you wish to share.
//////////////////////////
The `git remote` command is a management tool for your record of remote repositories.
It allows you to save long URLs as short handles, such as ``origin'' so you don't have to type them out all the time.
It allows you to save long URLs as short handles, such as origin so you don't have to type them out all the time.
You can have several of these and the `git remote` command is used to add, change and delete them.
//////////////////////////
`git remote` 명령은 원격 저장소 설정인 리모트의 관리 도구다.
긴 URL 대신 ``origin'' 처럼 이름을 짧게 지을 수 있다. 그리고 URL대신 짧은 리모트 이름을 사용한다.
긴 URL 대신 origin 처럼 이름을 짧게 지을 수 있다. 그리고 URL대신 짧은 리모트 이름을 사용한다.
`git remote` 명령으로 이 리모트를 여러 개 만들어 관리할 수 있다.
//////////////////////////
Expand Down Expand Up @@ -1069,9 +1069,9 @@ If you're administering a Git repository or need to fix something in a big way,
==== git gc
//////////////////////////
The `git gc` command runs ``garbage collection'' on your repository, removing unnecessary files in your database and packing up the remaining files into a more efficient format.
The `git gc` command runs garbage collection on your repository, removing unnecessary files in your database and packing up the remaining files into a more efficient format.
//////////////////////////
`git gc`는 저장소에 필요없는 파일을 삭제하고 남은 파일을 압축하는 ``Garbage Collection'' 명령이다.
`git gc`는 저장소에 필요없는 파일을 삭제하고 남은 파일을 압축하는 Garbage Collection 명령이다.
//////////////////////////
This command normally runs in the background for you, though you can manually run it if you wish.
Expand Down
4 changes: 2 additions & 2 deletions book/01-introduction/sections/about-version-control.asc
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@
(((version control)))
//////////////////////////
What is ``version control'', and why should you care?
What is version control, and why should you care?
Version control is a system that records changes to a file or set of files over time so that you can recall specific versions later.
For the examples in this book, you will use software source code as the files being version controlled, though in reality you can do this with nearly any type of file on a computer.
//////////////////////////
``버전 관리'' 는 무엇이고 우리는 왜 이것을 알아야 할까?
버전 관리 는 무엇이고 우리는 왜 이것을 알아야 할까?
버전 관리 시스템은 파일 변화를 시간에 따라 기록했다가 나중에 특정 시점의 버전을 다시 꺼내올 수 있는 시스템이다.
이 책에서는 버전 관리하는 예제로 소프트웨어 소스 코드만 보여주지만, 실제로 거의 모든 컴퓨터 파일의 버전을 관리할 수 있다.
Expand Down
4 changes: 2 additions & 2 deletions book/01-introduction/sections/basics.asc
Original file line number Diff line number Diff line change
Expand Up @@ -209,10 +209,10 @@ Git 디렉토리는 지금 작업하는 디스크에 있고 그 디렉토리 안
//////////////////////////
The staging area is a file, generally contained in your Git directory, that stores information about what will go into your next commit.
Its technical name in Git parlance is the ``index'', but the phrase ``staging area'' works just as well.
Its technical name in Git parlance is the index, but the phrase staging area works just as well.
//////////////////////////
Staging Area는 Git 디렉토리에 있다. 단순한 파일이고 곧 커밋할 파일에 대한 정보를 저장한다.
Git에서는 기술용어로는 ``Index'' 라고 하지만, ``Staging Area'' 라는 용어를 써도 상관 없다.
Git에서는 기술용어로는 Index 라고 하지만, Staging Area 라는 용어를 써도 상관 없다.
//////////////////////////
The basic Git workflow goes something like this:
Expand Down
2 changes: 1 addition & 1 deletion book/01-introduction/sections/help.asc
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ These channels are regularly filled with hundreds of people who are all very kno
이 채널에는 보통 수백 명의 사람이 접속해 있다. 모두 Git에 대해 잘 알고 있다. 기꺼이 도와줄 것이다.(((IRC)))
//////////////////////////
In addition, if you don't need the full-blown manpage help, but just need a quick refresher on the available options for a Git command, you can ask for the more concise ``help'' output with the `-h` or `--help` options, as in:
In addition, if you don't need the full-blown manpage help, but just need a quick refresher on the available options for a Git command, you can ask for the more concise help output with the `-h` or `--help` options, as in:
//////////////////////////
Git 명령을 사용하기 위해 매우 자세한 도움말 전체를 볼 필요 없이 각 명령에서 사용할 수 있는 옵션들에 대해서 간략히 살펴볼수도 있다. `-h`, `--help` 옵션을 사용하면 다음과 같이 Git 명령에서 사용할 수 있는 옵션들에 대한 간단한 도움말을 출력한다.
Expand Down
2 changes: 1 addition & 1 deletion book/02-git-basics/sections/getting-a-repository.asc
Original file line number Diff line number Diff line change
Expand Up @@ -137,7 +137,7 @@ $ git clone https://github.com/libgit2/libgit2
That creates a directory named `libgit2`, initializes a `.git` directory inside it, pulls down all the data for that repository, and checks out a working copy of the latest version.
If you go into the new `libgit2` directory that was just created, you'll see the project files in there, ready to be worked on or used.
//////////////////////////
이 명령은 ``libgit2'' 라는 디렉토리를 만들고 그 안에 `.git` 디렉토리를 만든다. 그리고 저장소의 데이터를 모두 가져와서 자동으로 가장 최신 버전을 Checkout 해 놓는다.
이 명령은 libgit2 라는 디렉토리를 만들고 그 안에 `.git` 디렉토리를 만든다. 그리고 저장소의 데이터를 모두 가져와서 자동으로 가장 최신 버전을 Checkout 해 놓는다.
`libgit2` 디렉토리로 이동하면 Checkout으로 생성한 파일을 볼 수 있고 당장 하고자 하는 일을 시작할 수 있다.
//////////////////////////
Expand Down
28 changes: 14 additions & 14 deletions book/02-git-basics/sections/recording-changes.asc
Original file line number Diff line number Diff line change
Expand Up @@ -65,13 +65,13 @@ nothing to commit, working directory clean
This means you have a clean working directory -- in other words, none of your tracked files are modified.
Git also doesn't see any untracked files, or they would be listed here.
Finally, the command tells you which branch you're on and informs you that it has not diverged from the same branch on the server.
For now, that branch is always ``master'', which is the default; you won't worry about it here.
For now, that branch is always master, which is the default; you won't worry about it here.
<<ch03-git-branching#ch03-git-branching>> will go over branches and references in detail.
//////////////////////////
위의 내용은 파일을 하나도 수정하지 않았다는 것을 말해준다. Tracked 파일은 하나도 수정되지 않았다는 의미다.
Untracked 파일은 아직 없어서 목록에 나타나지 않는다.
그리고 현재 작업 중인 브랜치를 알려주며 서버의 같은 브랜치로부터 진행된 작업이 없는 것을 나타낸다.
기본 브랜치가 master이기 때문에 현재 브랜치 이름이 ``master'' 로 나온다. 브랜치 관련 내용은 차차 알아가자.
기본 브랜치가 master이기 때문에 현재 브랜치 이름이 master 로 나온다. 브랜치 관련 내용은 차차 알아가자.
<<ch03-git-branching#ch03-git-branching>> 에서 브랜치와 Refs에 대해 자세히 다룬다.
//////////////////////////
Expand All @@ -96,12 +96,12 @@ nothing added to commit but untracked files present (use "git add" to track)
----
//////////////////////////
You can see that your new `README` file is untracked, because it's under the ``Untracked files'' heading in your status output.
You can see that your new `README` file is untracked, because it's under the Untracked files heading in your status output.
Untracked basically means that Git sees a file you didn't have in the previous snapshot (commit); Git won't start including it in your commit snapshots until you explicitly tell it to do so.
It does this so you don't accidentally begin including generated binary files or other files that you did not mean to include.
You do want to start including `README`, so let's start tracking the file.
//////////////////////////
`README` 파일은 ``Untracked files'' 부분에 속해 있는데 이것은 `README` 파일이 Untracked 상태라는 것을 말한다.
`README` 파일은 Untracked files 부분에 속해 있는데 이것은 `README` 파일이 Untracked 상태라는 것을 말한다.
Git은 Untracked 파일을 아직 스냅샷(커밋)에 넣어지지 않은 파일이라고 본다.
파일이 Tracked 상태가 되기 전까지는 Git은 절대 그 파일을 커밋하지 않는다. 그래서 일하면서 생성하는 바이너리 파일 같은 것을 커밋하는 실수는 하지 않게 된다.
`README` 파일을 추가해서 직접 Tracked 상태로 만들어 보자.
Expand Down Expand Up @@ -142,12 +142,12 @@ Changes to be committed:
----
//////////////////////////
You can tell that it's staged because it's under the ``Changes to be committed'' heading.
You can tell that it's staged because it's under the Changes to be committed heading.
If you commit at this point, the version of the file at the time you ran `git add` is what will be in the historical snapshot.
You may recall that when you ran `git init` earlier, you then ran `git add <files>` -- that was to begin tracking files in your directory.(((git commands, init)))(((git commands, add)))
The `git add` command takes a path name for either a file or a directory; if it's a directory, the command adds all the files in that directory recursively.
//////////////////////////
``Changes to be committed'' 에 들어 있는 파일은 Staged 상태라는 것을 의미한다.
Changes to be committed 에 들어 있는 파일은 Staged 상태라는 것을 의미한다.
커밋하면 `git add` 를 실행한 시점의 파일이 커밋되어 저장소 히스토리에 남는다.
앞에서 `git init` 명령을 실행한 후, `git add (files)` 명령을 실행했던 걸 기억할 것이다. 이 명령을 통해 디렉토리에 있는 파일을 추적하고 관리하도록 한다.(((git commands, init)))(((git commands, add)))
`git add` 명령은 파일 또는 디렉토리의 경로를 아규먼트로 받는다. 디렉토리면 아래에 있는 모든 파일들까지 재귀적으로 추가한다.
Expand Down Expand Up @@ -183,13 +183,13 @@ 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.
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 precisely 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 precisely 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` 파일은 ``Changes not staged for commit'' 에 있다. 이것은 수정한 파일이 Tracked 상태이지만 아직 Staged 상태는 아니라는 것이다.
이 `CONTRIBUTING.md` 파일은 Changes not staged for commit 에 있다. 이것은 수정한 파일이 Tracked 상태이지만 아직 Staged 상태는 아니라는 것이다.
Staged 상태로 만들려면 `git add` 명령을 실행해야 한다.
`git add` 명령은 파일을 새로 추적할 때도 사용하고 수정한 파일을 Staged 상태로 만들 때도 사용한다. Merge 할 때 충돌난 상태의 파일을 Resolve 상태로 만들때도 사용한다.
add의 의미는 프로젝트에 파일을 추가한다기 보다는 다음 커밋에 추가한다고 받아들이는게 좋다.(((git commands, add)))
Expand Down Expand Up @@ -328,13 +328,13 @@ $ cat .gitignore
----
//////////////////////////
The first line tells Git to ignore any files ending in ``.o'' or ``.a'' -- object and archive files that may be the product of building your code.
The first line tells Git to ignore any files ending in “.o” or “.a” -- object and archive files that may be the product of building your code.
The second line tells Git to ignore all files whose names end with a tilde (`~`), which is used by many text editors such as Emacs to mark temporary files.
You may also include a log, tmp, or pid directory; automatically generated documentation; and so on.
Setting up a `.gitignore` file for your new repository before you get going is generally a good idea so you don't accidentally commit files that you really don't want in your Git repository.
//////////////////////////
첫번째 라인은 확장자가 ``.o''``.a'' 인 파일을 Git이 무시하라는 것이고 둘째 라인은 `~` 로 끝나는 모든 파일을 무시하라는 것이다. 보통 대부분의 텍스트 편집기에서 임시파일로 사용하는 파일 이름이기 때문이다.
``.o''``.a'' 는 각각 빌드 시스템이 만들어내는 오브젝트와 아카이브 파일이고 `~` 로 끝나는 파일은 Emacs나 VI 같은 텍스트 편집기가 임시로 만들어내는 파일이다.
첫번째 라인은 확장자가 “.o”“.a” 인 파일을 Git이 무시하라는 것이고 둘째 라인은 `~` 로 끝나는 모든 파일을 무시하라는 것이다. 보통 대부분의 텍스트 편집기에서 임시파일로 사용하는 파일 이름이기 때문이다.
“.o”“.a” 는 각각 빌드 시스템이 만들어내는 오브젝트와 아카이브 파일이고 `~` 로 끝나는 파일은 Emacs나 VI 같은 텍스트 편집기가 임시로 만들어내는 파일이다.
또 log, tmp, pid 같은 디렉토리나, 자동으로 생성하는 문서 같은 것들도 추가할 수 있다.
`.gitignore` 파일은 보통 처음에 만들어 두는 것이 편리하다. 그래서 Git 저장소에 커밋하고 싶지 않은 파일을 실수로 커밋하는 일을 방지할 수 있다.
Expand Down Expand Up @@ -780,9 +780,9 @@ Git에서 파일을 제거하려면 `git rm` 명령으로 Tracked 상태의 파
이 명령은 워킹 디렉토리에 있는 파일도 삭제하기 때문에 실제로 파일도 지워진다.
//////////////////////////
If you simply remove the file from your working directory, it shows up under the ``Changes not staged for commit'' (that is, _unstaged_) area of your `git status` output:
If you simply remove the file from your working directory, it shows up under the Changes not staged for commit (that is, _unstaged_) area of your `git status` output:
//////////////////////////
Git 명령을 사용하지 않고 단순히 워킹 디렉터리에서 파일을 삭제하고 `git status` 명령으로 상태를 확인하면 Git은 현재 ``Changes not staged for commit'' (즉, _Unstaged_ 상태)라고 표시해준다.
Git 명령을 사용하지 않고 단순히 워킹 디렉터리에서 파일을 삭제하고 `git status` 명령으로 상태를 확인하면 Git은 현재 Changes not staged for commit (즉, _Unstaged_ 상태)라고 표시해준다.
[source,console]
----
Expand Down
Loading

0 comments on commit 46d9147

Please sign in to comment.