공유하는 콘텐츠와 목적을 기준으로 번역 문서 페이지를 매핑한 다음, 각 언어의 정확한 URL을 기록하세요. 슬러그가 달라도 괜찮습니다. 이 Mac 워크플로를 사용하면 공개 문서 편집자가 매핑을 만들고 정확한 언어 링크와 검색 주석을 준비할 수 있습니다.

슬러그가 일치할 필요가 없는 이유

영어 문서에서 색깔이 있는 정사각형을 격자 형태로 배열하는 방법을 설명한다고 가정해 보겠습니다. 프랑스어 번역본도 같은 작업을 설명하지만 두 주소의 끝부분은 다릅니다. Google은 URL에 현지화된 단어를 사용해도 된다고 명시하며, 언어별 버전에는 별도의 URL을 사용할 것을 권장합니다. 경로를 일치시키려고 번역본의 이름을 바꿀 필요는 없습니다. 다지역 및 다국어 사이트 관리.

답해야 할 질문은 서로 다릅니다. “이 URL은 동일한가?”와 “이 문서는 서로 번역본인가?”입니다. WHATWG URL 표준은 직렬화된 URL을 비교해 URL의 동일성을 정의합니다. 이 비교만으로는 서로 다른 주소의 문서가 번역 관계인지 알 수 없습니다. 이 워크플로에서는 문서를 바탕으로 관계를 판단한 다음 명시적으로 기록합니다. URL 표준, URL 동등성.

아래 예시는 example.com 아래의 가상 공개 문서 주소입니다. 실제로 접속해 가져온 페이지가 아니라 제안된 매핑을 보여 줍니다. 목표는 각 페이지의 기존 주소를 유지하면서 서로 동등한 영어와 프랑스어 안내문을 연결하는 것입니다.

Mac에서 매핑 기록 만들기

문서 쌍 하나부터 시작합니다. 원문 페이지와 번역이 제안된 페이지를 Safari의 별도 탭에서 열고, 로컬 매핑 문서도 함께 엽니다. 두 버전의 전체 텍스트와 나중에 구현할 때 언어 관계나 페이지 메타데이터를 설정하는 게시 도구의 접근 권한이 필요합니다.

정확한 주소 기록하기

Safari에서 Command-L을 눌러 스마트 검색 필드를 선택한 다음 Command-C를 눌러 주소를 복사합니다. 페이지 로딩이 끝난 후 번역본에서도 반복합니다. Apple은 두 단축키를 모두 안내합니다. 이동 후 도달한 주소를 기록해 두면 예상하지 못한 목적지로 연결되는지도 확인할 수 있습니다. Mac용 Safari의 키보드 단축키 및 제스처.

문서가 몇 개뿐이라면 TextEdit으로 충분합니다. 새 문서를 만들고 포맷 > 일반 텍스트로 만들기를 선택한 다음 translation-map.txt로 저장합니다. 기존 서식 있는 텍스트 문서를 변환하면 서식이 제거되므로 이 기록은 새 문서에 작성하세요. 이 작업은 Apple의 TextEdit 안내를 따릅니다. Mac용 TextEdit에서 문서 생성, 열기 및 변환하기.

기반이 되는 작업을 설명하는 안정적인 문서 식별자를 사용합니다. 다음은 전체 예시 기록이며, 게시 시스템이 자동으로 읽는 설정 파일이 아닙니다.

문서 ID: tile-grid
독자의 작업: 색깔이 있는 정사각형으로 4열 격자 배열하기
영어 URL: https://example.com/en/docs/arrange-tiles
프랑스어 URL: https://example.com/fr/guides/disposer-les-carres
영어 언어 코드: en
프랑스어 언어 코드: fr
범위 확인: 동일한 안내, 그림 및 문서 판본
매핑 결정: 번역본 쌍

제목이나 슬러그가 바뀌어도 식별자를 기준으로 추적할 수 있습니다. 주소를 서로 별개의 필드로 기록하고, 한 주소에서 다른 주소를 만들어 내지 마세요. 이 예에서 /en/을 /fr/로 바꾸면 검증되지 않은 주소가 만들어지고 실제 번역 경로를 놓치게 됩니다.

문서가 같은 작업을 완료하도록 안내하는지 확인하기

도입부, 안내, 그림의 레이블, 예시 및 판본을 비교합니다. 번역된 제목이 단어별로 서로 비슷할 필요는 없습니다. 대신 독자가 다른 언어를 선택했을 때 같은 활동에 대해 동등한 안내를 받는지 확인하세요.

페이지를 매핑에 추가하기 전에 다음 판단표를 사용합니다. 같은 콘텐츠의 대체 버전을 식별하기 위한 편집 보조 자료입니다.

확인한 내용 매핑 결정
판본은 같고 격자 안내만 번역됨 번역본 쌍으로 기록
한 페이지는 격자를 다루고 다른 페이지는 색 선택을 다룸 별도 문서로 유지
한 번역본이 이전 판본을 설명함 묶기 전에 판본 차이 해결
탐색 메뉴만 번역됨 주요 문서가 완전히 번역된 것으로 기록하지 않음
대응하는 문서가 없음 해당 문서의 언어별 매핑에서 그 언어를 제외

예를 들어 여러 그리기 활동으로 연결되는 프랑스어 개요 페이지는 특정한 영어 격자 안내문을 대체하지 않습니다. 번역본이 없는 상태를 미완료 콘텐츠 작업으로 기록하세요. 더 넓은 범위의 페이지가 탐색에 유용할 수 있지만, 이 매핑에 필요한 동등한 문서를 제공하지는 않습니다.

매핑한 페이지를 독자 및 Google과 연결하기

로컬 기록은 관계를 나타내는 편집상의 기준 자료입니다. 게시된 페이지에도 이 관계를 표현하는 방법이 필요합니다. 먼저 독자가 매핑된 대응 페이지로 바로 이동할 수 있는 눈에 보이는 언어 링크를 추가하세요. Google은 독자가 언어를 선택할 수 있도록 언어 버전끼리 연결할 것을 권장하며, 방문자의 언어를 추측해 자동으로 리디렉션하지 말라고 안내합니다. 다지역 및 다국어 사이트 관리.

검색 주석의 경우 Google은 HTML 요소, HTTP 응답 헤더, XML 사이트맵의 세 가지 방법을 지원합니다. 유지 관리가 가능한 방법 하나를 선택하세요. 각 언어 버전은 자기 자신과 다른 언어 버전을 완전한 URL로 식별하고, 양방향 링크를 설정해야 합니다. 페이지의 현지화 버전을 Google에 알리기.

HTML 페이지의 대체 링크 준비하기

WHATWG HTML 표준은 alternate 요소의 hreflang 값이 다른 경우 번역본을 나타낸다고 정의합니다. 다음은 가상의 문서 쌍을 위한 HTML 메타데이터 조각으로, 각 페이지의 기존 head 요소 안에 넣습니다. 완전한 HTML 문서는 아닙니다. HTML 표준, 링크 유형 “alternate”.

<link rel="alternate" hreflang="en" href="https://example.com/en/docs/arrange-tiles">
<link rel="alternate" hreflang="fr" href="https://example.com/fr/guides/disposer-les-carres">

두 페이지 모두에 같은 쌍을 넣습니다. 슬러그를 포함해 대상 URL은 서로 다릅니다. Google 문서에 따르면 링크는 상호 연결되어야 하며 en, fr와 같이 언어만 나타내는 코드도 사용할 수 있습니다. 페이지의 현지화 버전을 Google에 알리기.

PDF에는 지원되는 게시 방법 사용하기

PDF에는 앞의 조각을 HTML head에 넣을 수 없습니다. Google은 HTML이 아닌 파일에 HTTP Link 응답 헤더를 사용하는 방법을 안내합니다. 가상의 PDF 문서 쌍에 사용할 전체 헤더 필드는 다음과 같습니다. 페이지의 현지화 버전을 Google에 알리기.

Link: <https://example.com/en/files/tile-grid.pdf>; rel="alternate"; hreflang="en", <https://example.com/fr/fichiers/grille-de-carres.pdf>; rel="alternate"; hreflang="fr"

각 PDF의 응답에 해당 필드를 설정합니다. RFC 8288은 꺾쇠괄호 안의 대상과 hreflang 매개변수를 포함한 HTTP 링크 구문을 정의합니다. 이는 응답 설정입니다. PDF에 표시되는 텍스트에 헤더를 입력해도 헤더가 설정되지는 않습니다. RFC 8288: 웹 링크.

게시 시스템에서 HTML 메타데이터나 응답 헤더를 수정할 수 없다면 Google이 지원하는 언어 주석이 포함된 사이트맵을 사용할 수도 있습니다. 각 URL 항목은 자기 자신을 포함해 모든 버전을 나열합니다. 게시 시스템이나 유지 관리 담당자를 통해 문서에 안내된 사이트맵 구조를 사용하세요. 로컬 매핑 파일만으로는 이 방법 중 어느 것도 구현되지 않습니다. 페이지의 현지화 버전을 Google에 알리기.

번역 관계를 리디렉션 및 표준 URL과 구분하기

언어별 대체 페이지, 선호하는 중복 URL, 이동한 페이지는 각각 다른 관계를 나타냅니다. 이 차이를 구분하면 매핑 변경으로 독자가 선택한 문서에서 다른 곳으로 이동하는 일을 방지할 수 있습니다.

메커니즘 문서에 명시된 목적 이 작업에 적용하는 방법
rel="alternate"와 hreflang 언어별 대체 페이지 식별 매핑된 번역본 연결
rel="canonical" 중복 페이지 또는 매우 유사한 페이지 중 선호하는 URL을 나타냄 해당 언어 내에서 적절한 중복 주소 처리
리디렉션 응답의 Location 리디렉션 대상 식별 주소가 이동한 경우 처리
Content-Language 표현이 대상으로 삼는 언어 독자층 설명 응답의 대상 독자층 표시
Content-Location 포함된 표현에 해당하는 리소스 식별 표현의 위치 설명

Google은 hreflang을 사용할 때 같은 언어의 표준 URL을 권장하며, 그런 URL이 없다면 가장 적절한 대체 URL을 사용하라고 안내합니다. 서로 다른 번역 문서에는 각 언어의 선호 URL이 자기 자신을 가리키도록 설정하는 것이 간단한 구현 방법입니다. 영어가 먼저 작성되었다는 이유만으로 프랑스어 표준 URL을 영어 페이지로 지정하지 마세요. rel="canonical" 및 기타 방법으로 표준 URL 지정하기.

RFC 9110은 리디렉션 응답의 Location, Content-Language 및 Content-Location을 각각 별도로 정의합니다. Content-Location은 표현의 메타데이터이며 대상 URL을 대체하지 않습니다. 이 필드 중 어느 것도 단독으로 해당 문서의 번역본 쌍을 열거하지 않으므로, 그 관계에는 대체 링크를 계속 사용하세요. RFC 9110: HTTP 의미론.

양방향으로 확인하고 매핑을 관리하기

매핑을 구현 담당자에게 전달하기 전에 다음 항목을 확인합니다. 나중에 게시 내용을 변경한 뒤에도 공개 페이지를 다시 확인하세요. 올바른 기록과 올바른 게시 메타데이터는 별도로 점검해야 합니다.

  1. 기록된 두 주소를 열고 실제 문서 내용을 비교합니다.
  2. 영어에서 프랑스어로, 다시 프랑스어에서 영어로 눈에 보이는 언어 링크를 따라갑니다. 각 목적지가 정확한 대응 페이지인지 확인합니다.
  3. 설정된 대체 URL을 매핑 기록과 문자 단위로 비교합니다.
  4. 두 버전이 자기 자신을 포함해 같은 번역본 집합을 식별하는지 확인합니다.
  5. 각 언어의 표준 URL 설정을 따로 확인합니다.
  6. 주소가 변경되면 매핑과 해당 주소를 참조하는 쌍의 모든 항목을 업데이트합니다.

URL 정리에는 주의하세요. RFC 9110에 따르면 스킴과 호스트는 대소문자를 구분하지 않지만, 정규화 규칙에 따라 다른 구성 요소는 대소문자를 구분해 비교합니다. 두 기록을 일관되게 보이게 하려고 경로를 소문자로 바꾸거나 마지막 슬래시를 제거하지 마세요. 검증된 목적지 주소를 그대로 유지합니다. RFC 9110, HTTP(S) 정규화 및 비교.

가상의 문서 쌍에서 얻어야 할 결과는 정확한 주소 두 개를 연결하는 안정적인 tile-grid 기록, 그리고 양방향으로 작동하는 링크와 동등한 콘텐츠입니다. 향후 번역이나 슬러그가 변경될 때 관계를 의도적으로 업데이트할 수 있도록 이 기록을 문서의 유지 관리 메모와 함께 보관하세요.

출처