데비안 문서 프로젝트 VCS

데비안 문서 프로젝트는 웹 페이지와 많은 매뉴얼 텍스트를 salsa.debian.org에 있는 데비안 살사 서비스에 저장하는데, 이는 데비안의 gitlab 인스턴스입니다. 이 서비스가 어떻게 동작하는지 자세한 정보는 salsa 문서를 읽으세요.

누구나 Salsa 서비스에서 소스를 받을 수 있습니다. 데비안 문서 프로젝트 회원만 파일을 업데이트 할 수 있습니다.

git에서 소스에 접근하기

웹 인터페이스를 사용하여 파일에 개별적으로 접근하고 각 프로젝트의 변경 사항을 https://salsa.debian.org/ddp-team/에서 볼 수 있습니다

전체 매뉴얼을 받으려면, git 서버에 직접 접근하는 게 때로 좋은 선택입니다. 컴퓨터에 git 패키지가 필요합니다.

git 저장소를 익명(읽기전용)으로 복제

이 명령을 써서 한 프로젝트 모든 파일을 받습니다:

git clone https://salsa.debian.org/ddp-team/release-notes.git

로컬에 복제할 모든 프로젝트에 같은 작업을 하세요.

push 권한(읽기-쓰기)을 갖고 git 저장소 복제

git서버에 이 방법으로 접근하기 전에 git 서버 쓰기 권한을 받아야 합니다. push 권한을 어떻게 요청하는지 먼저 읽으세요.

이 명령을 써서 한 프로젝트 모든 파일을 받습니다:

git clone git@salsa.debian.org:ddp-team/release-notes.git

로컬에 복제할 모든 프로젝트에 같은 작업을 하세요.

원격 git 저장소로부터 변경 페치

다른 사람이 바꾼 것으로 로컬 사본을 업데이트 하려면, manuals 디렉터리로 들어가서 명령 실행:

git pull

push 권한 얻기

push 권한은 매뉴얼 작성에 참여하고자 하는 모든 사람이 이용할 수 있습니다. 일반적으로 유용한 패치를 먼저 제출해야 합니다.

Salsa에 계정을 만들 다음, https://salsa.debian.org/ddp-team/ 그룹 또는 아래 Request to join을 클릭해서 push 권한을 요청하세요. 데비안에 대한 당신의 작업 기록을 설명하는 메일을 debian-doc@lists.debian.org에 보내고 그것을 따라가십시오.

요청을 한번 승인 받으면, ddp-team 그룹 또는 그 프로젝트 중 하나의 한 부분이 될 겁니다.


자동 업데이트 매커니즘

매뉴얼 텍스트의 게시된 웹 페이지는 www.master.debian.org 에서 일반 웹 사이트 재 구축 프로세스의 일부로 생성되며, 4시간마다 발생합니다.

프로세스는 아카이브에서 최신 패키지 버전을 다운로드하고 각 매뉴얼를 다시 빌드하고 웹 사이트의 doc/manuals/ 하위 디렉터리에 있 파일을 설치하도록 설정됩니다.

업데이트 스크립트로 생성된 문서 파일은 https://www.debian.org/doc/manuals/에 있습니다.

업데이트 스크립트 파일이 만든 로그 파일은 https://www-master.debian.org/build-logs/webwml/ (스크립트 이름은 7doc 이며 often cron job의 일부로 실행됨).