Avec l’extension Supertext, TYPO3 traduit les pages à l’étape que vous connaissez déjà : l’assistant Localize. Ce guide vous accompagne de l’installation jusqu’à une page traduite en allemand standard de Suisse.

Prérequis : TYPO3 13.4 ou 14.3 LTS installé avec Composer, un compte Supertext et une dizaine de minutes.

Allemand standard de Suisse ou dialecte ?

Les sites web de Suisse alémanique sont rédigés en allemand standard de Suisse : de l’allemand standard avec « ss » au lieu de « ß », ainsi que des mots et des graphies suisses. Dans Supertext, il s’agit de de-CH, et c’est ce qu’utilise ce guide. Pour un ton délibérément local, Supertext rédige aussi en suisse allemand (dialecte), zurichois ou bernois (gsw-u-sd-chzh, gsw-u-sd-chbe), ce dont la plupart des traductions automatiques sont incapables.

1. Obtenir votre clé API

Connectez-vous à Supertext ou créez un compte, puis générez une clé sous Integrations → API. Il faut pour cela le rôle Admin dans votre compte Supertext ; sinon, adressez-vous à l’administrateur de votre compte.

2. Installer l’extension

L’extension n’est pas encore disponible sur Packagist : ajoutez donc son dépôt GitHub et installez-la avec require :

composer config repositories.supertext-typo3 vcs https://github.com/Supertext/Typo3-Supertext-Translation
composer require supertext/typo3-translation:dev-main
vendor/bin/typo3 extension:setup -e supertext_translation
vendor/bin/typo3 cache:flush

3. Saisir la clé

Dans le backend, ouvrez System → Settings → Extension Configuration → supertext_translation (TYPO3 13 : Admin Tools → Settings) et collez la clé dans Supertext API key. Sur un serveur, vous pouvez à la place définir la variable d’environnement SUPERTEXT_API_KEY, ce qui évite de stocker la clé dans la base de données. Le bloc Status en haut confirme que la connexion fonctionne.

4. Ajouter l’allemand de Suisse comme langue du site

Ouvrez Sites → Setup, modifiez votre site et, dans l’onglet Languages, ajoutez une langue avec la locale de_CH.UTF-8 (par exemple Deutsch (Schweiz)). Dans sa palette Supertext :

  • Supertext language: Default (de-CH) est présélectionné pour cette locale. Conservez-le.
  • Supertext tone: Formal pour « Sie », ou informel pour « du ».

Enregistrez. La langue par défaut du site sert de langue source.

5. Traduire une page

  1. Ouvrez Content → Layout et sélectionnez la page dans l’arborescence.
  2. Dans le menu des langues en haut à droite, choisissez Deutsch (Schweiz) sous Create new translation.
  3. Dans l’assistant Localize, laissez tous les éléments de contenu sélectionnés, choisissez Translate (mode connecté) et cliquez sur Localize.

Après quelques secondes, un message vert confirme ce que Supertext a traduit, par exemple "Supertext translated 30 field(s) in 14 record(s) into Deutsch (Schweiz) (de-CH)." Le titre de la page, les textes SEO, les en-têtes, le texte enrichi, les légendes, les textes alternatifs et les tableaux sont traduits ; l’URL est reconstruite à partir du titre traduit, par exemple /about-us devient /de/ueber-uns.

6. Relire et publier

Les nouvelles traductions sont masquées, comme d’habitude dans TYPO3. Relisez la page, modifiez ce que vous formuleriez autrement, puis rendez visibles la traduction de la page et ses éléments de contenu. C’est terminé.

Étapes suivantes

  • Contenu ajouté ultérieurement : traduisez-le depuis Display mode → Language Comparison avec le bouton Translate dans la colonne allemande.
  • Beaucoup de pages à la fois, ou vos propres traducteurs : consultez la page de l’intégration TYPO3 et son export XLIFF et HTML.
  • Le français et l’italien de Suisse fonctionnent de la même manière, avec fr-CH et it-CH.