Internationaliserende componenten internationalizing-components

Internationaliseer uw componenten en dialogen zodat hun koorden UI in verschillende talen kunnen worden voorgesteld. Componenten die zijn ontworpen voor internationalisatie maken het mogelijk om UI-tekenreeksen te extern maken, te vertalen en vervolgens te importeren in de opslagplaats. Tijdens runtime bepaalt de taalvoorkeuren van de gebruiker of de landinstelling van de pagina welke taal wordt weergegeven in de gebruikersinterface.

i18n-components-1.png

Gebruik het volgende proces om uw componenten te internationaliseren en de gebruikersinterface in verschillende talen te bieden:

  1. voer uw componenten uit gebruikend code die koorden internationaliseert. De code identificeert de tekenreeksen die moeten worden vertaald en selecteert de taal die moet worden weergegeven bij uitvoering.
  2. Maak woordenboeken en voeg de Engelse tekenreeksen toe die u wilt vertalen.
  3. Exporteer het woordenboek naar de XLIFF-indeling, vertaal de tekenreeksen en importeer de XLIFF-bestanden weer in AEM.
  4. Neem het woordenboek op in het releasebeheerproces van uw toepassing.
NOTE
De hier beschreven methoden voor het internationaliseren van componenten zijn bedoeld voor het omzetten van statische tekenreeksen. Wanneer componenttekenreeksen naar verwachting zullen veranderen, moet u conventionele vertaalworkflows gebruiken. Wanneer ontwerpers bijvoorbeeld een UI-tekenreeks kunnen bewerken met eigenschappen in het dialoogvenster Bewerken van een component, mogen ze geen taalwoordenboek gebruiken om de tekenreeks te internationaliseren.

Taalwoordenboeken language-dictionaries

Het AEM internationalisatiekader gebruikt woordenboeken in de repository om Engelse tekenreeksen en hun vertalingen in andere talen op te slaan. Het framework gebruikt Engels als de standaardtaal. Tekenreeksen worden geïdentificeerd met behulp van hun Engelse versie. Bij internationalisatieframes worden doorgaans alfanumerieke id's gebruikt voor UI-tekenreeksen. Het gebruik van de Engelse versie van de tekenreeks als de id heeft verschillende voordelen:

  • Code is gemakkelijk te lezen.
  • De standaardtaal is altijd beschikbaar.

De vertalingsveranderingen moeten van Git via de CI/CD pijpleidingin AEM als wolkendienst komen.

i18n-componenten-2

Tekenreeksen in systeemwoordenboeken overschrijven overlaying-strings-in-system-dictionaries

Als uw componenten tekenreeksen gebruiken die in de systeemwoordenboeken van het AEM zijn opgenomen, dupliceert u de tekenreeks in uw eigen woordenboek. Alle componenten gebruiken de tekenreeksen uit uw woordenboek.

U kunt niet voorspellen welke vertaling wordt gebruikt wanneer tekenreeksen worden gedupliceerd in woordenboeken die zich allemaal onder het knooppunt /apps bevinden.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab