[ko] using_git

1 files changed, 79 insertions, 18 deletions

diff --git a/korean/devel/website/using_git.wml b/korean/devel/website/using_git.wml
index 6f000b90143..e6debcc3ed6 100644
--- a/korean/devel/website/using_git.wml
+++ b/korean/devel/website/using_git.wml
@@ -8,32 +8,79 @@ control system</a>이며,
 모든 사용자는 주 저장소의 지역 사본을 만들 수 있습니다.
 지역 사본은 같은 컴퓨터, 또는 세계에 있을 수 있습니다.
 사용자는 지역 사본을 원하는 대로 바꾸고, 바뀐 재료가 준비되면, 변경을 커밋하고 
-그것을 주 저장소에 다시 밀어넣습니다.</p>
+그것을 주 저장소에 다시 push합니다.</p>
 
-<p>git은 원격 저장소에 같은 브랜치에 있는 여러분의 지역 사본보다 새로운 커밋(변경)이 있으면 파일을 직접 밀어넣지 못하게 합니다.
-이 경우 충돌이 일어나는 경우, 먼저 여러분의 지역 사본을 가져와서 업데이트 하고 여러분의 새 변경을
-최근 커밋의 꼭대기에서 <code>rebase</code> 하세요.
+<p>git은 원격 저장소에 같은 브랜치에 있는 여러분의 지역 사본보다 새로운 커밋(변경)이 있으면 파일을 직접 push 못하게 합니다.
+이 경우 충돌이 일어나는 경우, 먼저 여러분의 지역 사본을 가져와서 업데이트 하고 여러분의 새 변경을 최근 커밋의 꼭대기에서 <code>rebase</code> 하세요.
 </p>
 
-<h3><a name="write-access">git 쓰기 권한</a></h3>
+<h3><a name="write-access">git 저장소 쓰기 권한</a></h3>
+<p>
+전체 데비안 웹사이트 소스 코드는 Git에서 관리합니다.
+<url https://salsa.debian.org/webmaster-team/webwml/>에 있습니다.
+기본적으로, 게스트는 소스 코드 저장소로 커밋을 push할 수 없습니다.
+저장소에 대한 쓰기 액세스 권한을 얻으려면 일종의 권한이 필요합니다.
+</p>
 
-<p>저장소에 쓰기 권한이 필요하면,
-<url https://salsa.debian.org/webmaster-team/webwml/>를 통해 요청하세요.
-여러분의 요청에 유용한 것(어떤 언어 또는 어느 부분의 웹 사이트에서 일하기 원하는지
-그리고 누가 여러분을 보증할지)을 쓰세요.</p>
+<h4><a name="write-access-unlimited">무제한 쓰기 액세스</a></h4>
+<p>
+저장소에 대한 무제한 쓰기 액세스(예: 사용자가 자주 참여하게 될 경우)가 필요한 경우, 데비안 Salsa 플랫폼에 로그인 후 <url https://salsa.debian.org/webmaster-team/webwml/> 웹 인터페이스를 통해 쓰기 액세스를 요청하는 것을 고려하세요.
+</p>
 
-<h3><a name="work-on-repository">저장소에서 작업하기</a></h3>
+<p>데비안 웹사이트 개발에 처음이고 이전 경험이 없으면, 무제한 쓰기 액세스를 요청하기 전에 자기 소개서와 함께 <a href="mailto:debian-www@lists.debian.org">debian-www@lists.debian.org</a>에 메일 보내세요.
+여러분이 소개할 때, 어떤 언어 또는 웹사이트의 어느 부분을 사용할 계획이며, 누가 여러분을 보증할 것인지와 같은 유용한 정보를 제공하세요.
+</p>
 
-<h4><a name="clone-local-repo-copy">저장소의 지역 사본 복제</a></h4>
+<h4><a name="write-access-via-merge-request">Merge Request 통해 저장소에 쓰기</a></h4>
+<p>
+저장소에 대한 무제한 쓰기 액세스를 바라지 않거나 액세스할 수 없는 경우, 언제든지 Merge Request 하고 다른 개발자가 작업을 검토하고 여러분의 작업을 수락하도록 할 수 있습니다.
+Salsa GitLab 플랫폼에서 제공하는 표준 절차를 사용하여 웹 인터페이스를 통해 Merge Request 하세요.
+</p>
+Merge Request를 모든 웹사이트 개발자가 모니터하지 않으므로 시간 안에 시간 내에 처리되지 않을 수 있습니다.
+여러분의 기여가 적용될지 확실하지 않으면 <a href="https://lists.debian.org/debian-www/">debian-www</a> 메일링리스트에 메일 보내고 검토 요청하세요.
+</p>
 
-<p>저장소로 작업하고 여러분의 사용자와 e-mail을 설정하려면 git을 설치해야 합니다
-(일반적인 git 문서 참조).
-한번 이것이 되면, 저장소를 복제합니다:</p>
+
+<h2><a name="work-on-repository">저장소에서 작업하기</a></h2>
+
+<h3><a name="clone-local-repo-copy">저장소의 지역 사본 복제</a></h3>
+
+<p>우선, 저장소에서 작업하려면 git을 설치해야 합니다.(일반적인 git 문서 참조)
+다음, 둘 중 한 방법으로 저장소를 복제(다른 말로, 지역 사본 만들기)합니다.</p>
+
+<p>The recommended way to work on webwml is to first register an
+account on salsa.debian.org and enable git SSH access by uploading an
+SSH public key into your salsa account.
+See the <a
+href="https://salsa.debian.org/help/ssh/README.md">salsa help
+pages</a> for more details on how to do that. Then you can clone the
+webwml repository using the following command:</p>
+<p>
+webwml에서 작업하는 권장 방법은 먼저 salsa.debian.org에 계정을 등록하고 SSH 공용 키를 사용자의 Salsa 계정에 업로드하여 git SSH 액세스를 활성화하는 것입니다.
+자세한 방법은<a href="https://salsa.debian.org/help/ssh/README.md">salsa 도움말</a>을 참조하세요.
+그러면 아래 명령을 써서 webwml 저장소를 복제할 수 있습니다:</p>
 
 <pre>
    git clone git@salsa.debian.org:webmaster-team/webwml.git
 </pre>
 
+<p>이러면 로컬에서 똑같은 저장소 복사본이 제공되지만, 변경 내용을 직접 이 방식으로 다시 push할 수 는 없습니다.</p>
+
+<p>전체 Webwml 저장소를 복제하려면 약 500MB의 데이터를 다운로드해야 하므로 인터넷 연결이 느리거나 불안정하면 어려울 수 있습니다.
+먼저 최소 깊이의 얕은 복제를 시도하여 초기 다운로드를 줄일 수 있습니다:</p>
+
+<pre>
+  git clone git@salsa.debian.org:webmaster-team/webwml.git --depth 1
+</pre>
+
+<p>사용 가능한(얕은) 저장소를 가져온 다음, 로컬 얕은 복사본을 심층화하고 최종적으로 전체 로컬 저장소로 변환할 수 있습니다.:</p>
+
+<pre>
+  git fetch --deepen=1000 # deepen the repo for another 1000 commits
+  git fetch --unshallow   # fetch all missing commits, convert the repo to a complete one
+</pre>
+
+
 <h4><a name="partial-content-checkout">부분 content checkout</a></h4>
 
 <p>페이지의 부분집합만을 위한 checkout을 만들수 있습니다:</p>
@@ -53,6 +100,10 @@ control system</a>이며,
    $ git checkout --
 </pre>
 
+<h3><a name="submit-changes">지역 변경 제출</a></h3>
+
+<h4><a name="keep-local-repo-up-to-date">지역 저장소 최신 유지</a></h4>
+
 <p>며칠마다 (그리고 적어도 뭔가 편집 하기 전!) 아래와 같이 해서</p>
 
 <pre>
@@ -61,10 +112,20 @@ control system</a>이며,
 
 <p>변경이 있는 저장소에서 파일을 찾길 바랄 겁니다.</p>
 
-<p>git은 분산(중앙집중 아님) 시스템이므로, 변경을 커밋한 다음 
-변경을 Salsa의 저장소 안에 밀어넣어야 함을 주의하세요.</p>
+<p>
+"git pull"을 수행하고 편집 작업을 수행하기 전에 로컬 git working 디렉토리를 깨끗하게 유지하는 것이 좋습니다.
+현재 브랜치의 원격 저장소에 없는 커밋되지 않은 변경 사항이나 로컬 커밋이 있는 경우 "git pull"을 수행하면 자동으로 병합 커밋이 생성되거나 충돌로 인해 실패합니다. 
+완료되지 않은 작업을 다른 브랜치에 보관하거나 "git stash"와 같은 명령을 사용하는 것을 고려해 주십시오.</p>
 
-<p><b>그래서 영어에서 편집은 이렇게 보일 겁니다:</b></p>
+<p>주의: git은 분산(중앙 집중화되지 않은) 버전 제어 시스템입니다. 
+즉, 변경을 커밋할 때 변경 내용이 지역 저장소에만 저장됩니다.
+다른 사람과 공유하려면 변경 내용을 Salsa의 중앙 저장소에 push해야 합니다.</p>
+
+<h4><a name="example-edit-english-file">영어 파일 편집 예</a></h4>
+
+<p>웹사이트 소스 코드 저장소 안의 영어 파일을 편집하는 예를 여기 제공합니다.
+"git clone"을 써서 저장소의 지역 사본을 얻은 후 작업을 편집하기 전에, 아래 명령을 치세요.
+</p>
 
 <pre>
    $ git pull
@@ -77,7 +138,7 @@ control system</a>이며,
    $ git commit -m "Your commit message"
 </pre>
 
-<p>다음에, 여러분의 변경을 Salsa 저장소에 밀어넣습니다:</p>
+<p>다음에, 여러분의 변경을 Salsa 저장소에 push합니다:</p>
 
 <pre>
    $ git push