Extraherar strängar för översättning extracting-strings-for-translating
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 configuring-string-extraction
Konfigurera hur xgettext-maven-plugin-verktyget extraherar strängar för ditt projekt.
/filter { }
/parsers {
/vaultxml { }
/javascript { }
/regexp {
/files {
/java { }
/jsp { }
/extjstemplate { }
}
}
}
/potentials { }
Identifiera filerna som ska tolkas identifying-the-files-to-parse
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.
När det används i ett mönster anger tecknet / en underkatalog och det sista tecknet i matchar alla. I följande tabell visas flera exempelregler.
Extrahera strängarna extracting-the-strings
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 output-files
-
raw.xliff
: extraherade strängar -
warn.log
: varningar (om sådana finns)CQ.I18n.getMessage()
API används felaktigt. De behöver alltid en fix och sedan en omstart. -
parserwarn.log
: parservarningar (om sådana finns), till exempel 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
: tillåter snabb sökning av källkodsplatser för en given sträng