Dokki Docs logo

翻譯

已發布的網站可以以多種語言提供文件。訪客可以從公開網站選擇語言,而原始語言仍然可用。

設定語言

  • 開啟 發佈 → 網站設定

  • 選擇網站的原始語言。

  • 新增訪客應能選擇的其他語言。

  • 儲存設定並發佈或更新相關文件。

原始語言始終包含在內,且不會進行機器翻譯。對於一個
同時服務中文讀者的英文文件網站,請將 English
保留為原始語言,並啟用 簡體中文 (zh)。您也可以啟用
繁體中文 (zh-TW) 作為獨立的翻譯;它不會被視為與
簡體中文相同的變體。

訪客看到的內容

當網站提供至少兩種語言時,語言選單會出現。訪客
在瀏覽網站時可以切換語言。Dokki 使用 lang 查詢
參數,將其保留在內部導覽連結中,並記住選擇,以便
日後再次造訪同一個網站。在沒有已儲存選擇的首次造訪時,Dokki
可以選擇與瀏覽器語言相符的已啟用語言。

例如,?lang=zh 選擇簡體中文,?lang=zh-TW 選擇
繁體中文。不支援或停用的語言不會變為
有效。如果請求的翻譯尚未就緒,則會顯示原始內容
而不是在頁面請求期間產生翻譯。

翻譯更新時

在您發佈文件或新增語言後,Dokki 會在
背景中排入翻譯佇列,因此可能需要短暫時間才會顯示。新增語言
會回填網站已發佈的文件。後續的來源編輯不會
變更公開或翻譯的頁面,直到您發佈新的凍結版本。

文件更新後,請至少驗證同一文件的原始英文頁面和
簡體中文頁面。檢查標題、正文、
麵包屑、側邊欄連結、上一頁/下一頁連結,以及頁面之間的導覽。
如果啟用繁體中文,請使用 ?lang=zh-TW 重複檢查。

翻譯的內容

  • 文件標題和正文內容。

  • 支援的首頁和導覽文字。

  • 首頁標題、描述、文件名稱和摘要。

  • 當有目前翻譯可用時,提供麵包屑和導覽標籤。

表格和 Artifacts 內的結構化內容可能無法像文件文字一樣翻譯。在提供翻譯網站之前,請單獨審查這些資源。

搜尋和語言連結

對於文件頁面,Dokki 只會宣告目前
已發佈內容的快取翻譯。準備好的翻譯頁面會獲得其自己的 canonical URL,包含
語言查詢參數,並且該頁面會宣告語言替代方案。快取
未命中時會保持相對於原始頁面的 canonical,這樣搜尋引擎就不會被導向
到重複的未翻譯內容。

透過及時發佈重要的
來源更新,使原始語言和翻譯頁面保持一致。不要僅因為
語言出現在網站設定中,就認為語言推出已完成:請開啟具有代表性的公開 URL 並驗證
目前翻譯是否已完成處理。