이제 재미있는 부분입니다. 코드를 편집해 봅시다.

이 예시에서는 변경하고 싶은 UI 텍스트를 발견했습니다. GitLab의 오른쪽 상단 모서리에서 아바타를 선택한 후 **환경설정(Preferences)**을 클릭했습니다. Syntax highlighting theme을 Code syntax highlighting theme으로 변경하려고 합니다.

이 튜토리얼은 GitLab 프로젝트에 기여하는 방법에 대한 일반적인 소개를 위해 설계된 것이며, 리뷰를 위해 제출해야 하는 변경 사항의 예시가 아닙니다.

로컬 IDE를 사용하여 GDK 디렉터리의 코드를 변경하세요.

• 변경 사항을 위한 새 브랜치를 생성합니다:

  git checkout -b ui-updates
  

• gitlab-development-kit/gitlab 디렉터리에서 Syntax highlighting 문자열을 검색합니다. 결과에는 .haml 파일 하나와 여러 .po 파일이 표시됩니다.

• app/views/profiles/preferences/show.html.haml 파일을 엽니다.

• 문자열을 Syntax highlighting에서 Code syntax highlighting으로 업데이트합니다.

• 파일을 저장합니다.

• 성공 여부를 확인할 수 있습니다:

  gitlab-development-kit/gitlab 디렉터리에서 git status를 입력하여 수정한 파일을 확인합니다:

        modified:   app/views/profiles/preferences/show.html.haml
  

• GDK를 보고 있는 웹 브라우저를 새로 고칩니다. 변경 사항이 표시되어야 합니다. 스크린샷을 찍으세요.

• 변경 사항을 커밋합니다:

  git commit -a -m "Update UI text
  
  Standardizing the text on this page so
  that each area uses consistent language."
  

  GitLab 커밋 메시지 가이드라인을 따르세요.

• 새 브랜치에 변경 사항을 푸시합니다:

  git push --set-upstream origin ui-updates
  

• 코드 변경 사항으로 머지 리퀘스트를 생성하거나, 계속해서 번역 파일을 업데이트할 수 있습니다.

번역 파일 업데이트#

영어 UI 문자열은 여러 언어로 현지화됩니다. 이 문자열들은 .pot 파일에 저장되며, UI 텍스트를 업데이트할 때마다 이 파일을 재생성해야 합니다.

현지화 파일을 자동으로 재생성하려면:

• gitlab-development-kit/gitlab 디렉터리에 있는지 확인합니다.

• 다음 명령어를 실행합니다:

  tooling/bin/gettext_extractor locale/gitlab.pot
  

  .pot 파일은 /locale 디렉터리에 생성됩니다.

이제 gitlab-development-kit/gitlab 디렉터리에서 git status를 입력하면 두 파일이 모두 나열되어 있어야 합니다:

      modified:   app/views/profiles/preferences/show.html.haml
      modified:   locale/gitlab.pot

• 변경 사항을 커밋하고 푸시합니다.

• 머지 리퀘스트를 생성하거나 계속해서 문서를 업데이트합니다.

현지화에 대한 자세한 내용은 국제화(internationalization)를 참조하세요.

문서 업데이트#

GitLab 문서는 https://docs.gitlab.com에 게시됩니다. 기능을 추가하거나 업데이트할 때는 문서도 함께 업데이트해야 합니다.

• 기능에 대한 문서를 찾으려면, 가장 쉬운 방법은 문서 사이트를 검색하는 것입니다. 이 경우, 해당 설정은 다음 문서 페이지에 설명되어 있습니다:

  https://docs.gitlab.com/user/profile/preferences/
  

• URL에서 /doc 디렉터리 내의 파일 위치를 확인할 수 있습니다. 이 경우, 위치는 다음과 같습니다:

  doc/user/profile/preferences.md
  

• 로컬 gitlab 리포지터리에서 해당 위치로 이동하여 .md 파일과 관련 이미지를 업데이트합니다.

이제 git status를 실행하면 다음과 같이 표시됩니다:

      modified:   app/views/profiles/preferences/show.html.haml
      modified:   doc/user/profile/img/profile-preferences-syntax-themes.png
      modified:   doc/user/profile/preferences.md
      modified:   locale/gitlab.pot

• 변경 사항을 커밋하고 푸시합니다.

• 머지 리퀘스트를 생성하거나 계속해서 문서를 업데이트합니다.