Translation workflow

Mon, 01 Jan 0001 00:00:00 +0000

A translation in Emet is an ordinary entry that happens to live in another language’s directory. There’s no special translation state and nothing to approve; the workflow is just a quicker way of getting a correctly placed copy to start from, with the original beside you while you work.

Creating a translation#

In the entry list, open the card’s More actions menu (the three dots) and click Translate. The action only appears on sites with more than one language.
In the Create Translation dialog, pick the Target Language. The dropdown lists only languages this entry doesn’t have a translation in yet; if it has them all, the dialog says so and there’s nothing to do.
Choose what to Start from:
- Copy of source (the default) duplicates the whole source file, frontmatter and body, so you translate in place with the original text in front of you.
- Blank from archetype gives you a fresh entry from the section’s archetype (the same template a new entry gets), keeping only the source’s title and its translationKey if it has one. Pick this when the body is going to be rewritten rather than translated line by line.
Leave Open side-by-side with source ticked if you want the original visible while you translate. It’s on by default.
Click Start Translation.

The translation goes to the same relative path under the target language’s directory, so content/en/posts/hello.md becomes content/fr/posts/hello.md. The whole path below the language directory is kept, subfolders and page bundles included: content/en/posts/2024/hello.md becomes content/fr/posts/2024/hello.md, and a bundle’s content/en/posts/hello/index.md becomes content/fr/posts/hello/index.md. On a site using translation by filename the copy stays in the same directory and gets the target language’s suffix instead: content/posts/hello.md becomes content/posts/hello.fr.md, and content/posts/hello/index.de.md translated into the default language becomes content/posts/hello/index.md.

Internationalisation on Emet CMS

Translation workflow

Creating a translation#