Con l’estensione Supertext, TYPO3 traduce le pagine nel passaggio che Lei già conosce: la procedura guidata Localize. Questa guida La accompagna dall’installazione a una pagina tradotta in tedesco standard svizzero.

Le occorrono: TYPO3 13.4 o 14.3 LTS installato con Composer, un account Supertext e circa dieci minuti.

Tedesco standard svizzero o dialetto?

I siti web della Svizzera tedesca sono scritti in tedesco standard svizzero: tedesco standard con «ss» al posto di «ß» e con parole e grafie svizzere. In Supertext corrisponde a de-CH, ed è la variante usata in questa guida. Per un tono volutamente locale, Supertext scrive anche in svizzero tedesco (dialetto), zurighese o bernese (gsw-u-sd-chzh, gsw-u-sd-chbe), cosa che la maggior parte delle traduzioni automatiche non sa fare.

1. Ottenga la Sua chiave API

Acceda a Supertext o crei un account, poi generi una chiave in Integrations → API. Per farlo occorre il ruolo Admin nel Suo account Supertext; altrimenti si rivolga all’amministratore del Suo account.

2. Installi l’estensione

L’estensione non è ancora disponibile su Packagist, quindi aggiunga il suo repository GitHub e la richieda:

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. Inserisca la chiave

Nel backend apra System → Settings → Extension Configuration → supertext_translation (TYPO3 13: Admin Tools → Settings) e incolli la chiave in Supertext API key. Su un server può invece impostare la variabile d’ambiente SUPERTEXT_API_KEY, così la chiave non viene salvata nel database. Il blocco Status in alto conferma che la connessione funziona.

4. Aggiunga il tedesco svizzero come lingua del sito

Apra Sites → Setup, modifichi il Suo sito e, nella scheda Languages, aggiunga una lingua con la locale de_CH.UTF-8 (ad esempio Deutsch (Schweiz)). Nella sua palette Supertext:

  • Supertext language: per questa locale è preselezionato Default (de-CH). Lo mantenga.
  • Supertext tone: Formal per «Sie», oppure informale per «du».

Salvi. La lingua predefinita del sito è la lingua di partenza.

5. Traduca una pagina

  1. Apra Content → Layout e selezioni la pagina nell’albero delle pagine.
  2. Nel menu delle lingue in alto a destra, scelga Deutsch (Schweiz) sotto Create new translation.
  3. Nella procedura guidata Localize, lasci selezionati tutti gli elementi di contenuto, scelga Translate (modalità connessa) e clicchi su Localize.

Dopo qualche secondo un messaggio verde conferma che cosa ha tradotto Supertext, ad esempio "Supertext translated 30 field(s) in 14 record(s) into Deutsch (Schweiz) (de-CH)." Vengono tradotti titolo della pagina, testi SEO, intestazioni, rich text, didascalie, testi alternativi e tabelle; l’URL viene ricostruito a partire dal titolo tradotto, ad esempio /about-us diventa /de/ueber-uns.

6. Verifichi e pubblichi

Come di consueto in TYPO3, le nuove traduzioni sono nascoste. Rilegga la pagina, modifichi ciò che formulerebbe diversamente e renda visibili la traduzione della pagina e i suoi elementi di contenuto. Fatto.

Prossimi passi

  • Contenuti aggiunti in seguito: li traduca da Display mode → Language Comparison con il pulsante Translate nella colonna del tedesco.
  • Molte pagine in una volta o traduttori propri: consulti la pagina dell’integrazione TYPO3 e la relativa esportazione XLIFF e HTML.
  • Il francese e l’italiano per la Svizzera funzionano allo stesso modo, con fr-CH e it-CH.