GDK를 사용하여 코드 기여

이제 재밌는 부분을 시작해 봅시다. 코드를 수정해 봅시다.

이 예시에서는 변경하고 싶은 UI 텍스트를 찾았습니다. GitLab의 오른쪽 상단에서 아바타를 선택한 후 Preferences를 선택했습니다. GitLab의 색상을 사용자 정의를 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. 이 URL은 /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을 생성하거나 문서를 계속 업데이트하세요.