GDK를 사용하여 코드 기여

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

이 예에서 변경하고 싶은 UI 텍스트를 발견했습니다. GitLab의 오른쪽 상단에 있는 아바타를 선택한 다음 Preferences를 클릭했습니다. Customize the color of GitLab를 Customize the color theme of the GitLab UI로 변경하고 싶습니다.

UI text

이 섹션의 대화형 데모 보기.

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

  1. 변경 사항을 위한 새 브랜치를 만드세요: 

    git checkout -b ui-updates

  2. gitlab-development-kit/gitlab 디렉터리에서 Customize the color of GitLab 문자열을 검색하세요.

    결과에서 하나의 .haml 파일과 여러 .po 파일이 나타납니다.

  3. app/views/profiles/preferences/show.html.haml 파일을 엽니다.
  4. 문자열을 Customize the color of GitLab에서 Customize the color theme of the GitLab UI로 업데이트하세요.
  5. 파일을 저장하세요.

  6. 성공적으로 완료되었는지 확인할 수 있습니다:

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

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

  7. GDK를 보고 있는 웹 브라우저를 새로 고침하세요. 변경 사항이 표시되어야 합니다. 화면을 캡처하세요.

    UI text - Color Theme

  8. 변경 사항을 커밋하세요: 

    git commit -a -m "UI 텍스트 업데이트
   
이 페이지의 텍스트를 일관된 언어로 표준화합니다."

    GitLab 커밋 메시지 지침을 따르세요.

  9. 변경 사항을 새 브랜치에 푸시하세요: 

    git push --set-upstream origin ui-updates
  10. 코드 변경으로 Merge Request을 만들거나 번역 파일을 업데이트하실 수 있습니다.

번역 파일 업데이트

영어 UI 문자열은 여러 언어로 로컬라이즈됩니다. 이러한 문자열은 UI 텍스트를 업데이트할 때마다 다시 생성되어야 하는 .pot 파일에 저장됩니다.

로컬라이제이션 파일을 자동으로 다시 생성하려면:

  1. gitlab-development-kit/gitlab 디렉터리에 있는지 확인하세요.

  2. 다음 명령어를 실행하세요: 

    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
  3. 변경 사항을 커밋하고 푸시하세요.
  4. Merge Request을 만들거나 문서를 업데이트하세요.

로컬라이제이션에 대한 자세한 내용은 국제화를 참조하세요.

문서 업데이트

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

  1. 기능에 대한 문서를 찾는 가장 쉬운 방법은 문서 사이트를 검색하는 것입니다. 이 경우 설정은 다음 문서 페이지에서 설명됩니다: 

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

  2. 해당 파일의 위치가 /doc 디렉터리에 표시됩니다. 이 경우 해당 위치는 다음과 같습니다: 

    doc/user/profile/preferences.md

  3. 로컬 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
  4. 변경 사항을 커밋하고 푸시하세요.
  5. Merge Request을 만들거나 계속해서 문서를 업데이트하세요.