Gitpod을 사용하여 코드 기여

이제 재미있는 부분이 있습니다. 몇 가지 코드를 편집해 봅시다.

이 예에서는 수정하고 싶은 UI 텍스트를 찾았습니다. GitLab의 오른쪽 상단에서 아바타를 선택한 다음 Preferences를 선택했습니다. Customize the color of GitLabGitLab 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. 문자열을 GitLab UI의 색 테마를 사용자 정의로 업데이트합니다.
  5. 변경 사항을 저장합니다.
  6. 이 변경 사항을 커밋하려면 IDE Terminal 탭을 사용합니다:

    git commit -m "UI 텍스트 업데이트
       
    이 페이지의 텍스트를 표준화하여 각 영역이 일관된 언어를 사용하도록 합니다."
    

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

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

    git push --set-upstream origin ui-updates
    
  8. 코드 변경으로 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을 생성하거나 문서를 계속해서 업데이트합니다.