diff --git a/docs/index.html b/docs/index.html index 8d61589..24c90dd 100644 --- a/docs/index.html +++ b/docs/index.html @@ -563,6 +563,13 @@ Blocks reference +
+
Localization
+ + + Translation & localization + +
@@ -854,6 +861,80 @@

+ +
+

+ + + + Translation & localization +

+
+

Document Authoring ships with a built-in Translate app for producing localized versions of pages. Before translating, decide on a localization strategy (which languages, and whether locales are variants of a source or independent). Translation behavior is controlled by a small config sheet in the site's hidden .da configuration folder.

+
+ + Full reference: docs.da.live — Set up translation. Setup requires DA administrator access. +
+ +

Configure translation for this site

+
+
+
+
+
Open the hidden config folder
+

Append /.da to the site path in DA to reach the configuration folder:

+
https://da.live/#/AdobeDevXSC/hal/.da
+
+
+
+
+
+
Set up the sheets
+

Inside .da, create a new sheet named translate, and rename the default data sheet to config.

+
+
+
+
+
+
Add key/value headers
+

On the config sheet, make the first row a two-column structure with headers key and value. Add one row per option below.

+
+
+
+
+
+
Set the translation options
+ + + + + + + +
keyvalueWhat it does
translate.behavioroverwrite · mergeHow returned content is applied. Overwrite replaces old content (no-touch translation); merge keeps existing content you want to retain.
translate.stagingon · offOn copies the source to a separate folder before translating; off sends it directly to the translation service.
rollout.behavioroverwrite · mergeSame overwrite/merge choice, applied to hybrid and locale-based rollout strategies.
+
+
+
+
+
+
Publish the config
+

Click Publish and confirm to activate the settings.

+
+
+
+
+
+
Create a translation project
+

Open the Translate app and create a new project. Your configured options now appear in the project's confirmation dialog.

+
+
+
+
+ + Choose merge when localized pages carry market-specific content you don't want a re-translation to clobber; choose overwrite for fully automated, no-touch translation. +
+
+
AdobeDevXSC / hal  ·  Holland America Line on AEM Edge Delivery Services