Snipp 번역하기

Snipp는 커뮤니티가 번역하며, 여러분의 도움을 기다립니다. 다른 언어에 능숙하다면 기존 번역을 개선하거나 Snipp를 새 언어로 가져오는 데 도움을 줄 수 있습니다. 이 가이드는 필요한 모든 것을 다룹니다.

보상

  • 의미 있는 기여를 하면 Snipp 프로필에 독점 번역가 배지를 받습니다.

  • Discord 서버의 번역가 역할도 받게 됩니다.

  • 기여가 많은 분은 감사의 표시로 Snipp PLUS를 받을 수 있습니다.

시작하기

시작하기 가장 좋은 곳은 저희의 Discord 서버 로, 번역가들이 조율하고, 언어를 맡고, 도움을 받는 곳입니다. 작업이 중복되지 않도록 어떤 언어를 작업하고 싶은지 알려주세요.

번역하는 두 가지 방법

번역에 기여하는 방법은 두 가지입니다. 자신에게 맞는 방법을 고르세요. 둘 다 사용할 필요는 없습니다.

Crowdin

가장 쉬운 방법입니다. JSON이나 Git 지식 없이 브라우저에서 바로 번역하세요. Crowdin은 각 문자열을 맥락과 함께 보여주고 형식을 자동으로 처리합니다. 대부분의 번역가에게 권장됩니다.

Crowdin 열기

GitHub

Git에 익숙한 개발자를 위한 방법입니다. 로케일 JSON 파일을 직접 편집하고 풀 리퀘스트를 여세요. 완전한 제어를 원하거나 새 언어를 추가할 때 가장 좋습니다.

저장소 열기

파일 작동 방식

모든 로케일은 평면 JSON 파일입니다. 키는 안정적인 ID이며 절대 변하지 않습니다. 값은 사용자에게 표시되는 텍스트이며, 그것만 번역하면 됩니다:

{
  "SETTINGS_PREFS_AUTO_COMPRESSION_LABEL": "Automatic Compression",
  "SETTINGS_PREFS_PARTY_MODE_LABEL": "Party Mode"
}

영어 파일이 원본입니다. 다른 모든 로케일은 정확히 같은 키 집합을 가지므로, 값만 변경하면 됩니다.

규칙

  • 키를 추가, 제거, 이름 변경하지 마세요. 새 키는 Snipp 코드베이스에서 옵니다. 로케일에 키가 없으면 사이트는 영어로 대체합니다.

  • 플레이스홀더를 동일하게 유지하세요. {count}나 {username} 같은 텍스트는 런타임에 대체됩니다. 정확히 같은 플레이스홀더를 유지하되, 언어의 어순에 맞게 위치는 옮길 수 있습니다.

  • 대소문자 규칙을 맞추세요. 짧은 UI 레이블은 모든 언어에서 Title Case를 사용합니다. 완전한 문장은 해당 언어의 일반 문장 표기를 사용합니다.

  • 브랜드나 기술 토큰은 번역하지 마세요. Snipp, Discord, ShareX, URL, API, PLUS, 파일 확장자는 그대로 두세요.

  • 유효한 JSON을 유지하세요. 큰따옴표를 사용하고, 마지막 항목을 제외한 모든 항목 뒤에 쉼표를 넣되, 후행 쉼표는 넣지 마세요.

  • 값에 앞뒤 공백이 있으면 그대로 유지하세요. 의도적인 것이며 문장을 연결하는 데 사용됩니다.

GitHub를 통한 제출

GitHub 경로를 선택했다면 흐름은 다음과 같습니다. Crowdin 번역가는 이 섹션을 건너뛰어도 됩니다. 변경 사항은 Crowdin 내에서 제출됩니다.

번역은 다음을 통해 제출됩니다: GitHub의 i18n 저장소 표준 포크 앤 풀 리퀘스트 흐름을 사용합니다:

  • 저장소를 포크한 다음, 포크를 클론하고 변경을 위한 새 브랜치를 만드세요.

  • 해당 언어의 로케일 파일을 편집하고 개선하고 싶은 값을 번역하세요.

  • 저장소 루트에서 검증 스크립트를 실행하고 제출 전에 보고된 문제를 모두 수정하세요.

  • 커밋하고 포크에 푸시한 후 메인 브랜치에 풀 리퀘스트를 여세요. 관리자가 검토하고 병합합니다.

명령줄 사용을 원하지 않나요? GitHub의 웹 편집기도 됩니다. 로케일 파일을 열고, 연필 아이콘을 클릭하고, 편집한 후 변경 사항을 제안하세요.

새 언어 추가하기

Snipp가 아직 여러분의 언어를 지원하지 않나요? GitHub에 해당 언어와 로케일 코드를 제안하는 이슈를 열고, 영어 원본 파일을 시작점으로 복사해 모든 값을 번역한 후 풀 리퀘스트를 여세요. 관리자가 사이트에 새 로케일을 등록합니다.

도울 준비가 되셨나요?

Discord 서버에 참여해 언어를 맡고, 다른 번역가를 만나고, 시작하세요.

더 많은 글