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

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

이 예에서는 변경하고 싶은 UI 텍스트를 발견했습니다. GitLab의 우측 상단에서 아바타를 선택한 다음 Preferences를 선택했습니다. GitLab의 색상을 사용자 정의를 GitLab UI의 색상 테마를 사용자 정의로 바꾸고 싶습니다.

변경 전의 GitLab UI 텍스트.

  1. 변경 사항을 위한 새 브랜치를 생성하세요:

    상태 표시줄에서 master를 선택한 다음 브랜치 또는 태그를 확인하려면 선택하세요 상자에서 새 브랜치 만들기를 선택하고 새 브랜치의 이름을 입력하세요.

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

    본 문서에서 사용되는 예시에서는 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 "UI 텍스트 업데이트

이 페이지에서 텍스트를 표준화하여
각 영역이 일관된 언어를 사용하도록 함."

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

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

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

번역 파일 업데이트

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