Published sites can offer documents in more than one language. Visitors choose a language from the public site, while the original language remains available.
Configure languages
Open Publish → Site settings.
Choose the original language of the site.
Add the additional languages visitors should be able to select.
Save the settings and publish or update the relevant documents.
The original language is always included and is not machine-translated. For an
English documentation site that also serves Chinese readers, keep English
as the original language and enable 简体中文 (zh). You can also enable
繁體中文 (zh-TW) as a separate translation; it is not treated as the same
variant as Simplified Chinese.
What visitors see
The language menu appears when the site offers at least two languages. Visitors
can switch languages while browsing the site. Dokki uses the lang query
parameter, keeps it on internal navigation links, and remembers the choice for
later visits to the same site. On a first visit without a saved choice, Dokki
can select an enabled language that matches the browser language.
For example, ?lang=zh selects Simplified Chinese and ?lang=zh-TW selects
Traditional Chinese. An unsupported or disabled language does not become
active. If a requested translation is not ready, the original content is shown
instead of generating a translation during the page request.
When translations update
After you publish a document or add a language, Dokki queues translations in the background, so they may take a short time to appear. Adding a language backfills the site's already-published documents. A later source edit does not change the public or translated page until you publish a new frozen version.
After a documentation update, verify at least the original English page and the
Simplified Chinese page for the same document. Check the title, body,
breadcrumbs, sidebar links, previous/next links, and navigation between pages.
If Traditional Chinese is enabled, repeat the check with ?lang=zh-TW.
What is translated
Document titles and body content.
Supported home-page and navigation text.
Home-page titles, descriptions, document names, and excerpts.
Breadcrumbs and navigation labels when a current translation is available.
Structured content inside tables and Artifacts may not be translated in the same way as document text. Review those resources separately before offering a translated site.
Search and language links
For document pages, Dokki advertises only translations cached for the current published content. A ready translated page gets its own canonical URL with the language query parameter, and the page advertises language alternatives. A cache miss stays canonical to the original page so search engines are not sent to duplicate untranslated content.
Keep the original language and translated pages aligned by publishing important source updates promptly. Do not consider a language rollout complete merely because it appears in Site settings: open representative public URLs and verify that current translations have finished processing.