依共同的內容與用途對應已翻譯的文件頁面,然後記錄各語言的確切網址。網址路徑不同也沒關係。這套 Mac 工作流程可協助公共文件編輯者建立對應表,並準備正確的語言連結與搜尋標註。

為什麼網址路徑不必相同

假設有一份英文文件說明如何排列一組彩色方格。法文譯本說明的是同一項任務,但兩個網址的結尾不同。Google 明確允許網址使用本地化文字,並建議不同語言版本使用不同網址。你不必為了讓路徑一致而重新命名譯本。管理多地區和多語言網站。

有兩個不同的問題需要回答:「這些網址是否相同?」以及「這些文件是否彼此為翻譯版本?」WHATWG URL 標準透過比較序列化後的網址來定義網址相等性。這種比較無法證明不同網址之間存在翻譯關係。這套工作流程會根據文件判定兩者的關係,再明確記錄下來。URL 標準:URL 等價性。

以下範例是 example.com 下的虛構公共文件網址;它們用來示範擬議中的對應關係,並非實際擷取的線上頁面。任務是連結內容等同的英語與法語說明,同時保留各頁面原有的網址。

在 Mac 上建立對應紀錄

先從一組文件開始。將來源頁面與擬議的譯文分別開在 Safari 的兩個分頁中,並同時開啟本機對應文件。你需要兩個版本的全文;若要實際發布,還需要能存取控制語言關係或頁面中繼資料的發布設定。

擷取確切網址

在 Safari 中按下 Command-L 選取 智慧型搜尋欄位,再按 Command-C 複製網址。等譯文載入完成後,也照樣操作。Apple 說明了這兩個快速鍵。記錄導覽後到達的網址,也讓你能察覺是否被帶到意料之外的目的地。Mac 版 Safari 的鍵盤快速鍵與手勢。

少量資料用「文字編輯」就夠了。建立新文件,選擇 格式 > 製作純文字,並將檔案儲存為 translation-map.txt。將現有的富文字文件轉換為純文字會移除格式,因此請為這份紀錄建立新文件。這些操作依循 Apple 的「文字編輯」說明。在 Mac 上使用「文字編輯」建立、打開及轉換文件。

使用能描述底層任務的穩定文件識別碼。以下是完整的示意紀錄,不是發布系統會自動讀取的設定檔:

Document ID: tile-grid
Reader task: Arrange a four-column grid of colored squares
English URL: https://example.com/en/docs/arrange-tiles
French URL: https://example.com/fr/guides/disposer-les-carres
English language code: en
French language code: fr
Scope check: Same instructions, diagram, and document edition
Mapping decision: Translation pair

標題或網址路徑改變時,這個識別碼仍可做為定位依據。請將網址分別存於不同欄位,不要從其中一個推算另一個。在此範例中,把 /en/ 換成 /fr/ 會產生未經驗證的網址,也會漏掉實際譯本的路徑。

確認文件是否完成相同任務

比較引言、說明、圖示標籤、範例與版本。翻譯後的標題不必逐字相似。請改問:選擇另一種語言的讀者,是否會收到完成同一項活動所需的等同說明?

將頁面加入對應表前,請先使用以下判斷表。這是根據辨識相同內容不同版本的需求整理出的編輯輔助工具:

發現的情況 對應判斷
方格說明與版本相同,文字經過翻譯 記錄為一組翻譯
一頁介紹方格,另一頁介紹如何選色 保持為不同文件
其中一個譯本描述較早的版本 先釐清版本差異,再歸為一組
只有導覽列翻譯了 不要將主文件記錄為完整譯本
沒有對應文件 在這份文件的對應表中省略該語言

例如,提供多種繪畫活動連結的法文概覽,不能取代特定的英文方格說明。請將缺少的譯本記錄為待處理的內容工作。概括性的目的地仍可做為實用導覽,但無法提供此對應表所需的等同文件。

連結對應頁面,方便讀者與 Google 使用

本機紀錄是編輯者判定頁面關係的依據。已發布頁面也需要有表達這種關係的方法。先加入醒目的語言連結,讓讀者能直接前往對應頁面。Google 建議在語言版本間加入連結,讓讀者自行選擇語言,並建議不要根據推測的語言自動重新導向訪客。管理多地區和多語言網站。

搜尋標註方面,Google 支援三種等效方法:HTML 元素、HTTP 回應標頭和 XML Sitemap。選擇一種方便維護的方法。每個語言版本都應使用完整網址標示自身及其替代版本,並設置互相對應的連結。向 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">

兩個頁面都放入相同的一組連結。目的地網址仍然不同,包括網址路徑。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 定義了 HTTP 連結語法,包括以尖括號括住的目標,以及 hreflang 參數。這些是回應設定;將標頭打在 PDF 的可見文字中並不會完成設定。RFC 8288:Web Linking。

如果你的發布系統無法編輯 HTML 中繼資料或回應標頭,Google 也支援使用含有語言標註的 Sitemap。每個網址項目都會列出所有版本,包括自身。請透過發布系統或其維護者,採用文件所述的 Sitemap 結構。僅有本機對應檔並不會實作上述任何方法。向 Google 說明網頁的本地化版本。

將翻譯關係與重新導向和標準網址分開處理

語言替代版本、偏好的重複網址和已移動的頁面,分別代表不同關係。清楚區分它們,可避免原本好意的對應設定變更,反而讓讀者離開自己選擇的文件。

機制 文件所述用途 在此任務中的應用
rel="alternate" 搭配 hreflang 指出其他語言版本 連結已對應的譯本
rel="canonical" 在重複或極相似的頁面中指出偏好的網址 處理同一語言中的重複網址
重新導向回應中的 Location 指出重新導向目的地 處理已移動的網址
Content-Language 描述該表示內容預期面向的語言受眾 標示回應的目標受眾
Content-Location 指出與所包含表示內容相對應的資源 描述表示內容的位置

Google 建議使用 hreflang 時,標準網址應使用相同語言;若沒有相同語言的頁面,則使用最佳替代頁面。對於這些內容各異的譯本,在每個偏好的語言網址上設定指向自身的標準網址,是直接明瞭的做法。不要只因英文是先撰寫的版本,就讓法文標準網址指向英文頁面。如何使用 rel="canonical" 及其他方法指定標準網址。

RFC 9110 分別定義了重新導向回應中的 Location、Content-Language 和 Content-Location。後者是表示內容的中繼資料,不能取代目標網址。這些欄位本身都不會列出此文件的翻譯配對;請保留替代版本連結來表達這種關係。RFC 9110:HTTP 語意。

確認雙向連結並維護對應表

將對應表交付實作前,請逐項檢查。之後每次變更發布內容時,也要針對公開頁面重複檢查;紀錄正確與已發布中繼資料正確,是兩件不同的事。

  1. 打開紀錄中的兩個網址,並比較實際文件內容。
  2. 點擊可見的語言連結,從英文前往法文,再返回英文。確認每次都到達特定的對應頁面。
  3. 逐字比對已設定的替代網址與對應紀錄。
  4. 確認兩個版本都指向同一組譯本,其中也包括自身。
  5. 分別檢查各語言的標準網址設定。
  6. 若網址變更,請更新對應表,以及這組頁面中引用該網址的所有位置。

謹慎處理網址格式。RFC 9110 規定,配置與主機名稱不區分大小寫;依其正規化規則,其他組成部分則區分大小寫。不要只為了讓兩筆紀錄看起來一致就把路徑轉成小寫或移除結尾斜線;請保留已驗證的目的地。RFC 9110,HTTP(S) 正規化與比較。

對於這組虛構的頁面,實用成果是一筆穩定的 tile-grid 紀錄,將兩個確切網址連結起來,內容等同且雙向連結正常。請將這筆紀錄與文件維護備註一併保存,方便日後有譯本或網址路徑變更時,能審慎更新兩者關係。

資料來源