Skip to main content

Enterprise Server 3.15 은(는) 현재 릴리스 후보로 제공됩니다.

번역할 콘텐츠 작성

설명서는 여러 언어로 번역됩니다. 영어 설명서를 작성하는 방법을 사용하면 번역 품질이 크게 향상될 수 있습니다.

번역에 친숙한 콘텐츠 작성 정보

다음 지침을 사용하여 만든 콘텐츠를 성공적으로 번역할 수 있는지 확인합니다. 자세한 내용은 “스타일 가이드”를 참조하세요.

  • 일반적이고 대부분의 사용자가 이해할 수 있는 예제를 사용합니다.
  • 그룹에 대해 논란의 여지가 있거나 문화적으로 특정한 예제는 사용하지 않습니다.
  • 활성 음성으로 작성합니다.
  • 간단하고 짧고 이해하기 쉬운 문장을 작성합니다.
  • 텍스트를 불분명하게 만들 수 있는 대명사를 너무 많이 사용하지 마십시오.
  • 속어와 농담을 사용하지 마십시오.
  • 음수 문장을 사용하지 마십시오.
  • 가능하면 업계 표준 약어를 사용하고 사용자 지정 약어를 설명합니다.
  • 표시 분위기를 사용합니다.
  • 중복 및 단어 식을 제거합니다.
  • 누적 한정자(명사 문자열)를 과도하게 사용하지 마세요. 번역기는 수정 중인 명사 중 어떤 명사인지 오해할 수 있습니다.
  • 첫 번째 명사에서 단수 또는 복수로 되어 있는지 명확하지 않은 보이지 않는 복수를 피합니다.
  • 명목화를 피하십시오.
  • 모호한 모달 보조 동사를 사용하지 마십시오.
  • 성별별 단어를 사용하지 마세요.
  • 전치사 구를 사용하지 마세요.
  • 모호한 명사 및 대명사(모호한 문장 제목)를 피합니다.
  • 인라인 링크를 최소한으로 유지합니다. 필요한 경우 "자세한 내용은 "링크 제목"을 참조하세요. 또는 항목의 끝에 있는 "추가 읽기" 섹션에 관련 링크를 추가합니다.

예제

이 섹션에서는 번역에 친숙한 설명서를 작성하기 위한 지침을 따르는 방법에 대한 예제를 제공합니다.

국가별 정보 방지

예를 들어 800개의 숫자와 국가별 주소를 사용하지 않도록 합니다. 필요한 경우 정보가 적용되는 국가를 멘션.

누적 한정자(명사 문자열)의 과도한 사용 방지

누적 한정자가 많으면 수정할 항목을 쉽게 확인할 수 없기 때문에 잘못된 번역이 발생할 수 있습니다. 예를 들어 "퍼블릭 리포지토리 기본 원본 설정" 대신 "퍼블릭 리포지토리 기본 원본 설정"을 사용합니다.

보이지 않는 복수 방지

예를 들어 "파일 검색"이라는 용어를 사용하는 경우 파일 하나 또는 모든 파일을 검색하는지 여부가 불분명합니다. 모호성을 제거하기 위해 더 많은 컨텍스트를 제공합니다. 지정된 예제에서는 "모든 파일 검색" 또는 "source.md 파일 검색"을 사용할 수 있습니다.

명목화 방지

예를 들어 "결론에 도달하기 위해" 대신 "결론"을 사용합니다.

모호한 모달 보조 동사를 사용하지 마십시오.

"may" 및 "might"와 같은 단어를 사용하지 마세요. 모호성을 방지하려면 더 명확하게 해야 합니다.

전치사 구 방지

"여러 번 시도한 후" 또는 "리포지토리 로그에 따라"를 작성하는 대신 더 직접 씁니다. 예를 들어 "세 번 시도한 후"입니다.

모호한 명사 및 대명사 방지

모호한 명사 및 대명사는 특히 콘텐츠를 번역해야 할 때 누가 또는 무엇을 참조하는지 불분명하게 만들 수 있습니다. 예를 들어 "유지 관리 관리자 및 기여자 파일 및 주석에 액세스할 수 있습니다. 끌어오기 요청에서 변경합니다." 이 문장에서는 파일 또는 주석이 변경되고 있는지 명확하지 않습니다. 대명사가 둘 이상의 선행을 참조하는 것처럼 보이는 경우 선행을 명확하게 하기 위해 문장을 다시 입력하거나 명사를 명사로 바꿔 모호성을 제거합니다.

가능한 경우 스타일 가이드에 따라 링크를 명확하게 소개합니다. 예를 들면 다음 문장을 대신

Read [more about OAuth2.](/apps/building-integrations/setting-up-and-registering-oauth-apps/) Note that OAuth2 tokens can be [acquired programmatically](/rest/reference/oauth-authorizations/#create-a-new-authorization), for applications that are not websites.

를 사용해야 합니다.

OAuth2 tokens can be acquired programmatically for applications that are not websites. For more information, see "[Setting up and registering OAuth Apps](apps/building-integrations/setting-up-and-registering-oauth-apps/)" and "[Create a new authorization](/rest/reference/oauth-authorizations/#create-a-new-authorization)."