Gitpod를 사용하여 코드 기여하기

이젠 재미있는 부분이에요. 코드를 수정해 봅시다.

이 예제에서는 변경하고 싶은 UI 텍스트를 찾았습니다. GitLab의 오른쪽 상단에서 아바타를 선택한 후 Preferences를 클릭합니다. Customize the color of GitLab을 Customize the color theme of the GitLab UI로 변경하려고 합니다:

UI text

  1. 변경 내용을 위한 새 브랜치를 생성합니다:

    상태 표시줄에서 master를 선택한 후, Select a branch or tag to checkout 상자에서 Create new branch를 선택하고 새 브랜치의 이름을 입력합니다.

    코드 변경이 문제를 해결하는 경우, 브랜치 이름은 문제 번호로 시작해야 합니다.

    이 문서의 예제에서는 새로운 브랜치를 ui-updates라고 부릅니다.

  2. 문자열 Customize the color of GitLab을 저장소에서 검색합니다:

    • VS Code에서 사이드 툴바의 검색 아이콘 을 선택합니다.
  3. app/views/profiles/preferences/show.html.haml 파일을 선택합니다.
  4. 문자열을 Customize the color theme of the GitLab UI로 업데이트합니다.
  5. 변경 사항을 저장합니다.

  6. 변경 사항을 커밋하기 위해 IDE의 Terminal 탭을 사용합니다: 

    git commit -m "Update UI text

이 페이지의 텍스트를 통일하여
각 영역이 일관된 언어를 사용하도록 표준화합니다."

    GitLab의 커밋 메시지 지침을 따릅니다.

  7. 변경 사항을 새 브랜치로 푸시합니다: 

    git push --set-upstream origin ui-updates
  8. 코드 변경으로 병합 요청을 생성하거나 번역 파일을 업데이트하실 수 있습니다.

번역 파일 업데이트

영문 UI 문자열은 여러 언어로 로컬라이즈됩니다. 이러한 문자열은 UI 텍스트를 업데이트할 때마다 재생성되어야 하는데요.

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

  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. 병합 요청을 생성하거나 문서를 업데이트하실 수 있습니다.