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에서 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. 코드 변경으로 병합 요청을 생성하거나 번역 파일을 업데이트를 계속할 수 있습니다.

번역 파일 업데이트

영어 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. 병합 요청을 생성하거나 문서를 업데이트하려면 계속 진행하세요.

로컬라이제이션에 대한 자세한 정보는 국제화를 참조하세요.

문서 업데이트

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. 병합 요청을 생성하거나 문서를 업데이트하려면 계속 진행하세요.