Extraherar strängar för översättning

Senast uppdaterad: 4 maj 2023

Skapat för:

  • Developer
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

Använd xgettext-maven-plugin för att extrahera strängar från källkoden som behöver översättas. Plugin-programmet Maven extraherar strängar till en XLIFF-fil som du skickar för översättning. Strängar extraheras från följande platser:

  • Java-källfiler
  • Javascript-källfiler
  • XML-representationer av SVN-resurser (JCR-noder)

Konfigurerar strängextrahering

Konfigurera hur xgettext-maven-plugin-verktyget extraherar strängar för ditt projekt.

/filter { }
/parsers {
   /vaultxml { }
   /javascript { }
   /regexp {
      /files {
         /java { }
         /jsp { }
         /extjstemplate { }
      }
   }
}
/potentials { }
AvsnittBeskrivning
/filterIdentifierar de filer som tolkas.
/parsers/vaultxmlKonfigurerar parsning av vaultfiler. Identifierar de JCR-noder som innehåller externa strängar och lokaliseringstips. Identifierar också JCR-noder som ska ignoreras.
/parsers/javascriptIdentifierar de JavaScript-funktioner som gör strängar externt. Du behöver inte ändra det här avsnittet.
/parsers/regexpKonfigurerar tolkningen av Java-, JSP- och ExtJS-mallfiler. Du behöver inte ändra det här avsnittet.
/potentialsFormeln för identifiering av strängar som ska internationaliseras.

Identifiera filerna som ska tolkas

Avsnittet /filter i i18n.any identifierar filerna som xgettext-maven-plugin-verktyget tolkar. Lägg till flera inkluderings- och exkluderingsregler som identifierar filer som tolkas respektive ignoreras. Du bör inkludera alla filer och sedan exkludera de filer som du inte vill analysera. Vanligtvis utesluter du filtyper som inte bidrar till användargränssnittet, eller filer som definierar användargränssnittet men som inte översätts. Reglerna include och exclude har följande format:

{ /include "pattern" }
{ /exclude "pattern" }

Mönsterdelen av en regel används för att matcha namnen på de filer som ska inkluderas eller exkluderas. Mönsterprefixet anger om du matchar en JCR-nod (dess representation i Vault) eller filsystemet.

PrefixEffekt
/Anger en JCR-sökväg. Det innebär att det här prefixet matchar filer under katalogen jcr_root.
*Anger en vanlig fil i filsystemet.
ingenInget prefix, eller ett mönster som börjar med en mapp eller ett filnamn, anger att filen är en vanlig fil i filsystemet.

Vid användning i ett mönster anger tecknet / en underkatalog och det &sista; tecken matchar alla. I följande tabell visas flera exempelregler.

ExempelregelEffekt
{ /include "*" }Inkludera alla filer.
{ /exclude "*.pdf" }Uteslut alla PDF-filer.
{ /exclude "*/pom.xml" }Uteslut POM-filer.
{ /exclude "/content/*" } { /include "/content/catalogs/geometrixx/templatepages" } { /include "/content/catalogs/geometrixx/templatepages/*" }

Uteslut alla filer under noden /content.

Inkludera noden /content/catalogs/geometrixx/templatesPages.

Inkludera alla underordnade noder för /content/catalogs/geometrixx/templates.

Extrahera strängarna

ingen POM:

mvn -N com.adobe.granite.maven:xgettext-maven-plugin:1.2.2:extract  -Dxgettext.verbose=true -Dxgettext.target=out -Dxgettext.rules=i18n.any -Dxgettext.root=.

Med POM: Lägg till detta i POM:

<build>
    <plugins>
        <plugin>
            <groupId>com.adobe.granite.maven</groupId>
            <artifactId>xgettext-maven-plugin</artifactId>
            <version>1.1</version>
            <configuration>
                <rules>i18n.any</rules>
                <root>jcr_root</root>
                <xliff>cq.xliff</xliff>
                <verbose>true</verbose>
            </configuration>
        </plugin>
    </plugins>
</build>

kommandot:

mvn xgettext:extract

Utdatafiler

  • raw.xliff: extraherade strängar

  • warn.log: varningar (om sådana finns), om CQ.I18n.getMessage() API används felaktigt. De behöver alltid en fix och sedan en omstart.

  • parserwarn.log: parservarningar (om sådana finns), t.ex. problem med js-parsern

  • potentials.xliff: "potentiella" kandidater som inte extraheras, men som kan vara läsbara strängar som behöver översättas (kan ignoreras, men ändå skapa en enorm mängd falskt positiva resultat)

  • strings.xliff: förenklad xliff-fil, som ska importeras till ALF

  • backrefs.txt: möjliggör snabb sökning av källkodsplatser för en given sträng

Föregående sida
Nästa sida

Experience Manager