데비안 문서 프로젝트 VCS
git에서 소스에 접근하기
데비안 문서 프로젝트는 모든 내용을 Salsa 데비안 GitLab 인스턴스에 저장합니다. 개별 파일에 접근, 최근 변경, 프로젝트 활동을 점검하려면 DDP 저장소를 방문하십시오.
전체 매뉴얼을 받으려면, git 서버에 직접 접근하는 게 때로 좋은 선택입니다. 다음 섹션에서는 로컬 컴퓨터에 Git 저장소(읽기 전용 및 읽기-쓰기)를 복제하는 방법과 로컬 복사본을 업데이트하는 방법을 설명합니다. 시작하기 전에 git 패키지를 자신의 컴퓨터에 설치하십시오.
git 저장소를 익명(읽기 전용)으로 복제
아래 명령을 써서 한 프로젝트 모든 파일을 받으십시오:
git clone https://salsa.debian.org/ddp-team/release-notes.git
자신의 컴퓨터에 다운로드하려는 모든 프로젝트에 동일한 작업을 수행합니다. Tip: git clone 명령의 올바른 URL을 찾으려면 웹 브라우저에서 프로젝트를 열고 파란색 Clone 버튼을 클릭한 다음 Clone with HTTPS URL을 클립보드에 복사합니다.
push 권한(읽기-쓰기)을 갖고 git 저장소 복제
git서버에 이 방법으로 접근하기 전에 git 서버 쓰기 권한을 받아야 합니다. push 권한을 어떻게 요청하는지 먼저 읽으십시오.
이 명령을 써서 한 프로젝트 모든 파일을 받습니다:
git clone git@salsa.debian.org:ddp-team/release-notes.git
로컬에 복제할 모든 프로젝트에 같은 작업을 하십시오.
원격 git 저장소로부터 변경 페치
다른 사람이 바꾼 것으로 로컬 사본을 업데이트 하려면, manual 서ㅂ디렉터리로 들어가서 명령 실행:
git pull
push 권한 얻기
push 권한은 매뉴얼 작성, FAQ, HOWTO 등에 참여하고자 하는 모든 분들께 제공됩니다. 일반적으로 유용한 패치 몇 개를 먼저 제출하십시오. 그 후, 다음 단계를 따라 작성 권한을 신청하세요:
- 계정을 Salsa에 만드십시오(계정이 없다면).
- DDP 저장소에 가서 Request Access 클릭.
- 메일을 debian-doc@lists.debian.org 에 보내고 데비안 프로젝트에 어떻게 기여했는지 말하십시오.
- 요청이 승인되면, 당신은 DDP 팀 일원이 됩니다.
자동 업데이트 매커니즘
모든 매뉴얼은 웹 페이지로 게시됩니다. 이 매뉴얼은 4시간마다 진행되는 정기적인 웹사이트 재구성 과정의 일환으로 www-master.debian.org 에서 자동으로 생성됩니다. 이 과정에서 최신 패키지 버전이 아카이브에서 다운로드되고, 각 매뉴얼이 재구성되며, 모든 파일은 웹사이트의 doc/manuals/ 서브디렉토리로 전송됩니다.
업데이트 스크립트로 생성된 문서 파일은 https://www.debian.org/doc/manuals/에 있습니다.
업데이트 스크립트 파일이 만든 로그 파일은
https://www-master.debian.org/build-logs/webwml/
(스크립트 이름은 7doc이며 often cron job의 일부로 실행됨).