주의: 이 번역은 원문보다 오래되었습니다.

Git을 써서 데비안 웹사이트 작업

Git 저장소에서 작업

바로 시작합니다. 이 절에서는 기본 저장소의 로컬 복사본을 만드는 방법, 해당 저장소를 최신 상태로 유지하는 방법 및 작업을 제출하는 방법을 배웁니다. 번역 작업 방법도 설명합니다.

로컬 복사본 받기

Git을 설치하세요. 다음, Git을 구성하고 이름과 이메일을 넣으세요. Git을 처음 쓴다면, 일반 git 문서를 먼저 읽는 게 좋습니다.

다음 단계는 저장소를 복제(로컬 사본 만들기)하는 겁니다. 두 가지 방법:

팁: 전체 webwml 저장소를 복제하는 것은 약 1.3 GB 데이터를 다운로드하며 이것은 느리거나 불안정안 인터넷 연결에서는 너무 느립니다. 따라서, 초기 다운로드에 최소 깊이를 정의할 수 있습니다: 

  git clone git@salsa.debian.org:webmaster-team/webwml.git --depth 1

쓸모 있는 (얕은) 저장소를 얻은 다음, 로컬 사본을 심화하고 결국 전체 로컬 저장소로 변환할 수 있습니다:

  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

페이지의 부분집합만 check out 할 수 있습니다:

  1. git clone --no-checkout git@salsa.debian.org:webmaster-team/webwml.git
  2. cd webwml
  3. git config core.sparseCheckout true
  4. .git/info/sparse-checkout 파일을 webwml 디렉터리에 만들어서 체크아웃할 내용을 정의하세요. 예를 들어, 기본 파일, 영어, 카탈로니아어, 스페인어만 검색하길 바라면, 파일은 다음과 같이 보입니다: 
          /*
      !/[a-z]*/
      /english/
      /catalan/
      /spanish/
  5. 마지막으로, 저장소를 체크 아웃: git checkout --

로컬 변경 제출

로컬 저장소 최신으로 유지

며칠에 한 번 (그리고 편집 작업 전!) 할 작업

  git pull

하여, 변경된 저장소에서 파일 검색합니다.

git pull 수행하기 전에 로컬 Git 작업 디렉토리를 깨끗하게 유지하는 것이 좋습니다. 현재 분기의 원격 저장소에 없는 커밋되지 않은 변경 사항이나 로컬 커밋이 있으면 git pull 하면 자동으로 병합 커밋이 생성되거나 충돌로 인해 실패할 수도 있습니다. 완료되지 않은 작업을 다른 분기에 보관하거나 git stash 같은 명령을 사용하는 것을 고려하십시오.

주의: Git은 분산(중앙 집중 아님) 버전 제어 시스템입니다. 즉, 변경 사항을 커밋하면 로컬 저장소에만 저장됩니다. 다른 사람들과 공유하려면 변경 사항을 Salsa의 중앙 저장소로 push해야 합니다.

예시: 몇 파일 편집

좀 더 실용적인 예와 일반적인 편집 세션을 살펴보겠습니다. git clone을 사용하여 저장소의 local copy을 얻었다고 가정합니다. 다음 단계:

  1. git pull
  2. 이제 편집을 시작하고 파일을 변경합니다.
  3. 다 되면, 여러분의 변경을 로컬 저장소에 커밋: 
        git add path/to/file(s)
    git commit -m "커밋 메시지"
  4. 무제한 쓰기 권한이 원격 webwml 저장소에 있으면, Salsa 저장소에: git push
  5. webwml 저장소에 직접 쓰기 권한이 없다면, 여러분의 변경을 merge request 또는 다른 개발자에게 도움을 위해 연락.

Closing Debian Bugs in Git Commits

If you include Closes: #nnnnnn in your commit log entry, then bug number #nnnnnn will be closed automatically when you push your changes. The precise form of this is the same as in Debian policy.

HTTP/HTTPS 사용하는 링크

많은 데비안 웹사이트가 SSL/TLS를 지원하므로 가능하면 HTTPS 링크를 사용하십시오. 그러나, 일부 Debian/DebConf/SPI/etc 웹사이트는 HTTPS를 지원하지 않거나 SPI CA만 사용합니다 (모든 브라우저가 SSL CA를 신뢰하는 건 아닙니다). 비데비안 사용자에게 오류 메시지가 발생하지 않도록 하려면 HTTPS를 사용하여 이러한 사이트에 링크하지 마십시오.

Git 저장소는 HTTPS를 지원하는 Debian 웹사이트용 플레인 HTTP 링크를 포함하거나 HTTPS를 지원하지 않거나 SPI가 서명한 증명서를 사용하는 것으로 알려진 Debian/DebConf/SPI 웹사이트용 HTTPS 링크를 포함하는 커밋을 거부합니다.

번역 작업

번역은 항상 해당 영어 파일과 함께 최신 상태로 유지되어야 합니다. 번역 파일의 translation-check 헤더는 현재 번역의 기반이 된 영어 파일 버전을 추적하는 데 사용됩니다. 번역된 파일을 변경하는 경우 영어 파일에서 해당 변경 사항의 Git 커밋 해시와 일치하도록 translation-check 헤더를 업데이트해야 합니다. 다음 명령으로 해시를 식별할 수 있습니다. 

  git log path/to/english/file

파일을 새로 번역 할 경우 copypage.pl 스크립트를 사용하십시오. 올바른 번역 헤더를 포함하여 여러분 언어에 대한 템플릿을 생성합니다.

smart_change.pl 사용한 번역 변경

smart_change.pl은 원본 파일과 해당 번역을 함께 업데이트하기 쉽게 하기 위한 스크립트입니다. 두 가지 방법이 있는데, 무엇을 바꾸냐에 따라 다릅니다.

이것은 smart_change.pl을 어떻게 쓰며, 수동으로 파일 작업 할 때 어떻게 translation-check 헤더를 업데이트 하는지 입니다.

  1. 원본 파일을 변경하고 변경을 커밋.
  2. 번역을 업데이트.
  3. smart_change.pl -c COMMIT_HASH 실행(원본 파일 변경 커밋 해시 사용). 변경을 선택하고 번역 파일 헤더를 업데이트.
  4. 변경을 리뷰 (예. git diff).
  5. 번역 변경 커밋.

또는, 정규식으로 작업하여 한 번에 여러 파일을 변경할 수 있습니다.

  1. 실행할 것 smart_change.pl -s s/FOO/BAR/ origfile1 origfile2 ...
  2. 변경 리뷰 (예. git diff).
  3. 원본 파일 커밋.
  4. 실행할 것 smart_change.pl origfile1 origfile2 (즉 이번에는 regexp 없이). 번역 파일 안의 헤더를 업데이트.
  5. 마지막으로, 번역 변경을 커밋.

물론, 이것은 두 개의 커밋을 포함하기 때문에 첫 번째 예제보다 약간 더 많은 노력이 필요하지만, Git 해시 작동 방식으로 인해 피할 수 없습니다.

Git 저장소 쓰기 권한

데비안 웹사이트의 소스 코드는 Git으로 관리되며 https://salsa.debian.org/webmaster-team/webwml에 있습니다. 기본적으로 게스트는 소스 코드 리포지토리에 커밋을 푸시할 수 없습니다. 데비안 웹사이트에 기여하려면 저장소에 대한 쓰기 권한을 얻기 위해 일종의 권한이 필요합니다.

무제한 쓰기 권한

저장소에 무제한 쓰기 권한 필요하면 예를 들어. 잦은 기여를 하려면, https://salsa.debian.org/webmaster-team/webwml 웹 인터페이스를 통해 데비안 Salsa 플랫폼에 로그인 해서 요청하세요.

데비안 웹사이트 개발이 처음이고 이전 경험이 없는 경우, 무제한 쓰기 권한을 요청하기 전에 debian-www@lists.debian.org 로 이메일을 보내 자신을 소개하십시오. 예를 들어 웹사이트의 어느 부분에서 작업할 계획인지, 어떤 언어를 사용하는지, 보증할 수 있는 다른 데비안 팀원이 있는지 등 자신에 대해 좀 더 친절하게 알려주시겠습니까?

병합 요청

저장소에 대한 무제한 쓰기 액세스 권한을 얻을 필요는 없습니다. 언제든지 병합 요청을 제출하고 다른 개발자가 작업을 검토하고 수락하도록 할 수 있습니다. 웹 인터페이스를 통해 Salsa GitLab 플랫폼에서 제공하는 병합 요청에 대한 표준 절차를 따르고 다음 두 문서를 읽으십시오.

모든 웹사이트 개발자가 병합 요청을 모니터링하는 것은 아닙니다. 따라서 피드백을 받기까지 시간이 걸릴 수 있습니다. 여러분의 기여가 승인될지 여부가 궁금하면 debian-www 메일링 리스트에 이메일을 보내서 검토를 요청하십시오.

알림 받기

데비안 웹사이트에서 작업하고 있다면 webwml 저장소에서 무슨 일이 일어나고 있는지 알고 싶을 것입니다. 루프를 유지하는 방법 2가지: 커밋 알림과 병합 요청 알림.

커밋 알림 받기

Salsa 안의 webwml 프로젝트를 설정해서 commit이 IRC 채널 #debian-www 에서 보인다.

webwml 저장소 commit 알림을 메일로 받고 싶으면, tracker.debian.org을 통해 www.debian.org 의사 패키지에 가입하고 다음 단계에 따라 vcs 키워드를 활성화하십시오(한 번만).

  1. 웹 브라우저를 열고 https://tracker.debian.org/pkg/www.debian.org 가세요.
  2. www.debian.org 의사 패키지에 가입하세요. (아직 tracker.debian.org을 다른 용도로 사용하지 않는다면 SSO를 통해 인증하거나 전자 메일 및 암호를 등록할 수 있습니다.).
  3. https://tracker.debian.org/accounts/subscriptions 가서, modify keywords, vcs 체크(체크 안 되었다면) 그리고 저장.
  4. 누군가 webwml 저장소를 커밋할 때 지금부터 이메일을 받을 수 있습니다.

병합 요청 알림 받기

Salsa의 webwml 저장소에 제출된 새로운 병합 요청이 있을 때마다 알림 이메일을 받으려면 다음 단계에 따라 웹 인터페이스에서 알림 설정을 구성할 수 있습니다.

  1. Salsa 계정에 로그인하고 project 페이지로.
  2. project 홈페이지 꼭대기 종 아이콘 클릭.
  3. 좋아하는 알림 레벨 선택.