GDK를 사용하여 코드 기여

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

이 예에서는 변경하고 싶은 UI 텍스트를 찾았습니다. GitLab의 오른쪽 상단에서 아바타를 선택한 다음 Preferences를 클릭합니다. GitLab의 색상을 사용자 정의를 GitLab UI의 색상 테마를 사용자 정의로 변경하고 싶습니다.

변경 전 GitLab의 UI 텍스트입니다.

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

로컬 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를 보고 있는 웹 브라우저를 새로고침합니다. 변경 사항이 표시되어야 합니다. 화면을 캡처합니다.

    변경 후 GitLab의 UI 텍스트입니다.

  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/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. 병합 요청을 생성하거나 문서를 업데이트하십시오.