Internazionalizzazione dei componenti internationalizing-components

Internazionalizza i componenti e le finestre di dialogo in modo che le relative stringhe dell’interfaccia utente possano essere presentate in lingue diverse. I componenti progettati per l’internazionalizzazione consentono di esternalizzare, tradurre e importare le stringhe dell’interfaccia utente nell’archivio. In fase di esecuzione, le preferenze della lingua dell’utente o le impostazioni locali della pagina determinano quale lingua viene visualizzata nell’interfaccia utente.

chlimage_1-9

Utilizza il seguente processo per internazionalizzare i componenti e fornire l’interfaccia utente in diverse lingue:

  1. Implementa i componenti utilizzando codice che internazionalizza le stringhe. Il codice identifica le stringhe da tradurre e seleziona la lingua da presentare in fase di esecuzione.

  2. Creare dizionari e aggiungi le stringhe inglesi da tradurre.

  3. Esporta il dizionario in formato XLIFF, traduci le stringhe, quindi importa l’XLIFF torna nell’AEM. In alternativa, è possibile: aggiungere manualmente le traduzioni sul dizionario.

  4. Integrare il dizionario nel processo di gestione delle versioni dell'applicazione.

NOTE
I metodi qui descritti per l’internazionalizzazione dei componenti sono destinati alla traduzione di stringhe statiche. Quando ci si aspetta che le stringhe dei componenti cambino, è necessario utilizzare i flussi di lavoro di traduzione convenzionali. Ad esempio, se gli autori possono modificare una stringa dell’interfaccia utente utilizzando le proprietà nella finestra di dialogo Modifica di un componente, non utilizzare un dizionario della lingua per internazionalizzare la stringa.

Dizionari di lingua language-dictionaries

Il framework di internazionalizzazione AEM utilizza i dizionari nel repository per memorizzare le stringhe inglesi e le loro traduzioni in altre lingue. Il framework utilizza l'inglese come lingua predefinita. Le stringhe vengono identificate utilizzando la loro versione inglese. In genere, i framework di internazionalizzazione utilizzano ID alfanumerici per le stringhe dell’interfaccia utente. L’utilizzo della versione inglese della stringa come ID presenta diversi vantaggi:

  • Il codice è facile da leggere.
  • La lingua predefinita è sempre disponibile.

Le stringhe localizzate possono essere memorizzate in diversi dizionari dell'archivio. I dizionari di sistema AEM si trovano sotto /libs nodo. È possibile creare dizionari per i componenti sotto /apps nodo. Il framework di internazionalizzazione dell’AEM combina i dizionari e li rende disponibili in Sling come un unico ResourceBundle oggetto. Quando i componenti vengono sottoposti a rendering, recuperano le stringhe tradotte dal bundle di risorse. I dizionari combinati vengono distribuiti anche sul server web in formato JSON per fornire stringhe tradotte nel codice JavaScript nelle pagine web.

Inoltre, il Strumento di traduzione consente di gestire tutti i dizionari da un'unica posizione centrale.

chlimage_1-10

NOTE
Non modificare i dizionari di sistema dell'AEM che si trovano sotto /libs nodo.

Sovrapposizione di stringhe nei dizionari di sistema overlaying-strings-in-system-dictionaries

Stringhe nei dizionari sotto /apps nei dizionari che si trovano al di sotto del /libs nodo. Se i componenti utilizzano stringhe incluse nei dizionari di sistema AEM, duplicare la stringa nel proprio dizionario. Tutti i componenti utilizzeranno le stringhe del dizionario.

Si noti che non è possibile prevedere quale traduzione viene utilizzata quando le stringhe vengono duplicate nei dizionari che si trovano tutti sotto /apps nodo.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2