이 깃허브 튜토리얼은 DjangoGirls How To 기여 튜토리얼을 기반으로 합니다. 크리에이티브 커먼즈 저작자표시-동일조건변경허락 4.0 라이선스에 따라 이용 가능합니다.
이 튜토리얼에서는 서류 가방 리포지토리를 기본으로 하여 를 링크와 참조 자료로 사용합니다.
시작하기 및 전제 조건
BeeWare에 기여하려면 다음 사항이 필요합니다:
- GitHub 계정](https://github.com)
- 복잡한 편집의 경우 Git 명령줄에 익숙한 경우 기본에 익숙하거나 앱(Windows 및 Mac)을 사용하여 컴퓨터에서 수정한 내용을 컴퓨터에서 편집한 내용을 GitHub로 푸시할 수 있습니다.
리포지토리 포크
먼저, Briefcase를 포크합니다. 리포지토리를 개인 GitHub 계정으로 포크합니다:
문서 편집
간단한 변경 사항
오타 수정과 같은 간단한 변경의 경우 온라인 GitHub를 사용할 수 있습니다. 편집기를 사용할 수 있습니다:
- GitHub에서 로컬 포크 페이지를 엽니다,
- 아무 챕터의 README.rst 파일로 이동합니다,
- 편집* 아이콘(펜)을 누릅니다.
에서 직접 챕터를 편집할 수 있습니다.
RST 구문은 문서의 개별 페이지를 편집하는 데 사용됩니다.
참고
위의 스크린샷은 현재 GitHub 리포지토리에 있는 내용을 반영하지 않을 수 있습니다. 라이브 리포지토리는 수시로 변경될 수 있습니다. 그러나 풀 리퀘스트를 제출하는 프로세스는 동일하게 유지됩니다.
변경 사항을 저장하고 아래 설명에 따라 풀 리퀘스트를 생성하세요.
새로운 코드 및 복잡한 변경 사항
새 코드를 추가하거나 클래스를 확장하거나 복잡한 변경 사항을 적용하려면 다음을 수행해야 합니다. 로컬 컴퓨터에 코드 사본을 가져와야 합니다.
위에서 언급한 운영 체제용 GitHub 앱을 사용하거나
git
명령줄을 사용하여 리포지토리를 로컬로 가져옵니다. 리포지토리
리포지토리 포크의 첫 페이지에서 주소를 얻습니다:
git clone git@github.com:yourusername/briefcase.git
그런 다음 새 변경 내용을 저장할 브랜치를 만듭니다. 브랜치 이름을 브랜치 이름을 변경하려는 내용과 관련된 이름으로 지정하세요.
git 체크아웃 -b 업데이트_문서
코드를 변경한 후 테스트하고 로컬에 저장했는지 확인합니다. 로컬로 저장합니다.
그런 다음 git
을 사용하여 변경 사항을 커밋하고 변경 사항을 원격
GitHub 리포지토리에 푸시합니다.
예시:
$ git status
브랜치 업데이트_문서
트래킹되지 않은 파일:
(커밋할 대상에 포함하려면 "git add <파일>..." 사용)
README.rst
git 추가 README.rst
git commit -m "Briefcase에 대한 README.rst 문서 업데이트"
[update_documentation fe36152] 깃북 스크린샷 추가
파일 변경 1개, 삽입(+) 0개, 삭제(-) 0개
모드 생성 100644 README.rst
$ git push
오브젝트 카운트하기: 11, 완료.
최대 8개의 스레드를 사용한 델타 압축.
오브젝트 압축 중: 100% (5/5), 완료.
객체를 쓰는 중입니다: 100%(5/5), 266.37KiB | 0바이트/s, 완료.
총 5(델타 1), 재사용 0(델타 0)
To git@github.com:yourusername/briefcase.git
b37ca59..fe36152 update_documentation -> update_documentation
풀 리퀘스트 만들기
변경을 완료한 후에는 pull 요청을 GitHub. BeeWare가 풀 리퀘스트에 대한 알림을 받고, 변경 사항을 검토한 후 변경 사항을 검토하고 필요한 경우 수정을 제안한 다음 변경 사항을 메인 버전으로 을 메인 버전에 적용합니다.
GitHub의 자체 리포지토리에서 비교 및 풀 리퀘스트를 누릅니다.
이 변경이 이루어지는 이유에 대한 정보를 입력하세요. 검토자 가 실제 변경 내용을 볼 수 있으므로 변경 내용을 반복해서 변경 내용을 반복할 필요가 없습니다.
그런 다음 풀 리퀘스트 만들기를 누릅니다.
후속 절차에 대한 안내는 GitHub 이메일에서 알려드립니다.