GitHub 개발자들은 저장소의 풀 리퀘스트(pull request)에 스크린샷이나 애니메이션 GIF를 자주 첨부합니다. 여러 줄의 일반 텍스트를 읽게 하는 것보다 시각적인 자료가 훨씬 더 눈길을 끌기 때문입니다. 정적 스크린샷은 화면상의 변화나 이미지를 인라인으로 보여줄 때 유용하며, GIF 애니메이션은 작업 흐름이나 마우스 커서의 움직임을 직관적으로 전달하는 데 적합합니다.
이번 튜토리얼에서는 GitHub 풀 리퀘스트에 스크린샷 이미지와 GIF 애니메이션을 추가하는 방법을 처음부터 차근차근 알려드립니다. GitHub를 한 번도 사용해 본 적 없는 초보자도 아래 단계만 따라 하면 충분히 시작할 수 있습니다.
1. 새 저장소와 브랜치 만들기
GitHub가 처음이라면 먼저 계정 생성 절차부터 진행하세요.
오른쪽 상단의 “+” 버튼을 클릭해 새 저장소(repository)를 만듭니다. 이때 “Initialize this repository with a README(README로 이 저장소 초기화)” 옵션을 반드시 체크하는 것을 잊지 마세요.
다음 단계에서는 아래 드롭다운 메뉴를 이용해 저장소에 브랜치(branch)를 추가합니다. 여기서는 “Hola-World” 저장소에 “Guten-tag”라는 브랜치를 추가했습니다.
GitHub에서 브랜치의 역할은 개발자가 메인 프로덕션 브랜치(master)와 분리된 환경에서 새로운 기능 개발이나 버그 수정 작업을 진행할 수 있도록 돕는 것입니다.
2. 스크린샷 또는 애니메이션 제작하기
스크린샷을 추가하려면 먼저 좋은 화면 캡처 도구가 필요합니다. Windows 10 환경에서는 Snip & Sketch(캡처 및 스케치)와 캡처 도구(Snipping Tool)가 가장 손쉽고 유용한 선택지입니다.
GIF 애니메이션을 만들려면 화면 녹화 도구가 필요합니다. 빠른 스크린캐스팅에 매우 편리한 Recordit을 추천합니다. Windows와 macOS용 설치 파일을 모두 공식 사이트에서 내려받을 수 있습니다.
설치 후에는 Record 버튼을 눌러 화면의 원하는 부분을 몇 초간 간단히 녹화할 수 있습니다. 최근에 녹화한 스크린캐스트는 시스템 트레이 메뉴에서 확인할 수 있으며, 클릭하면 브라우저에서 바로 열어볼 수 있습니다.
주의할 점은 GitHub 풀 리퀘스트에서는 동영상 파일(MP4 등)을 직접 업로드할 수 없다는 것입니다. 따라서 반드시 GIF 파일로 변환해야 합니다. 실제로 GitHub에서 지원하는 파일 형식은 JPG, JPEG, GIF, PNG, DOCX, PPTX, PDF, TXT, XLSX, ZIP으로 매우 제한적입니다. Ezgif 같은 무료 온라인 변환 도구를 이용하면 MP4 영상을 GIF로 몇 초 만에 변환할 수 있습니다.
아래는 GitHub 풀 리퀘스트에 삽입될 GIF 파일 예시입니다. GitHub Desktop 앱을 사용해 새 브랜치를 저장소에 추가하는 과정을 담고 있습니다.
3. 풀 리퀘스트에 스크린샷·애니메이션 추가하기
앞서 만든 브랜치로 돌아가 “Pull requests” 메뉴로 이동합니다. 여기서 점 세 개(⋮) 메뉴를 통해 풀 리퀘스트 정보를 수정할 수 있습니다.
편집 모드에 들어가면 “Attach files(파일 첨부)” 옵션을 통해 스크린샷 이미지와 GIF 애니메이션 파일을 첨부할 수 있습니다. 해당 브랜치 저장소에 처음 커밋하는 경우 “Commit”을 클릭하고, 기존 코멘트를 수정하는 경우라면 “Update comment”를 선택하세요.
이렇게 하면 생성한 스크린샷과 애니메이션이 GitHub 브랜치에 성공적으로 추가되고, 나아가 저장소 전체에도 반영됩니다.
GitHub의 핵심은 다른 개발자들과의 협업입니다. 제안한 변경 사항이 마음에 든다면, 상대방은 이를 자신의 저장소에 병합(merge)할 수 있습니다. 이때 “Merge pull request” 옵션을 사용합니다.
애니메이션은 GitHub 커뮤니티에서 다른 개발자들의 주목을 받을 수 있는 확실한 방법입니다. 이 튜토리얼을 완료했다면, 이제 GitHub 저장소와 그 하위 브랜치에 스크린샷과 GIF 애니메이션을 추가하는 방법을 모두 익힌 것입니다. GitHub가 잘 맞지 않는다면 GitHub 대안 서비스 목록을 확인해 보는 것도 좋습니다.