Gitpod를 사용하여 코드 기여

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

이 예시에서는 변경하고 싶은 UI 텍스트를 찾았습니다. GitLab의 우측 상단에 있는 아바타를 선택한 다음 Preferences(설정)를 클릭했습니다. Customize the color of GitLab를 Customize the color theme of the GitLab UI로 변경하고 싶습니다:

UI text

  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의 터미널 탭을 사용합니다: 

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

    GitLab의 커밋 메시지 가이드라인을 따르세요.

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

    git push --set-upstream origin ui-updates
  8. 코드 변경 사항에 대한 Merge Request을 만들 수 있거나 번역 파일을 업데이트할 수 있습니다.

번역 파일 업데이트

영어 UI 문자열은 여러 언어로 로컬라이즈됩니다. 이러한 문자열은 .pot 파일에 저장되며 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. Merge Request을 만들 수 있거나 문서를 업데이트할 수 있습니다.

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

문서 업데이트

GitLab의 문서는 https://docs.gitlab.com에 게시됩니다. 기능을 추가하거나 업데이트할 때는 문서도 업데이트해야 합니다.

  1. 기능에 대한 문서를 찾으려면 가장 간단한 방법은 문서 사이트에서 검색하는 것입니다. 이 경우, 설정은 여기 문서 페이지에서 설명되어 있습니다: 

    https://docs.gitlab.com/ee/user/profile/preferences.html

  2. 해당 파일이 /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을 만들 수 있거나 문서를 계속해서 업데이트할 수 있습니다.