Estrazione di stringhe per la traduzione

ATTENZIONE

AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Utilizza xgettext-maven-plugin per estrarre stringhe dal codice sorgente che richiedono la traduzione. Il plug-in Maven estrae le stringhe in un file XLIFF che invii per la traduzione. Le stringhe vengono estratte dalle posizioni seguenti:

  • File di origine Java
  • File di origine JavaScript
  • Rappresentazioni XML delle risorse SVN (nodi JCR)

Configurazione dell’estrazione della stringa

Configura come lo strumento xgettext-maven-plugin estrae le stringhe per il progetto.

/filter { }
/parsers {
   /vaultxml { }
   /javascript { }
   /regexp {
      /files {
         /java { }
         /jsp { }
         /extjstemplate { }
      }
   }
}
/potentials { }
Sezione Descrizione
/filter Identifica i file analizzati.
/parser/vaultxml Configura l'analisi dei file Vault. Identifica i nodi JCR che contengono stringhe esternalizzate e suggerimenti di localizzazione. Identifica anche i nodi JCR da ignorare.
/parser/javascript Identifica le funzioni JavaScript che esternalizzano le stringhe. Non è necessario modificare questa sezione.
/parser/regexp Configura l’analisi dei file di modello Java, JSP e ExtJS. Non è necessario modificare questa sezione.
/potenziale Formula per il rilevamento di stringhe da internazionalizzare.

Identificazione dei file da analizzare

La sezione /filter del file i18n.any identifica i file analizzati dallo strumento xgettext-maven-plugin. Aggiungi diverse regole di inclusione ed esclusione che identificano i file analizzati e ignorati rispettivamente. È necessario includere tutti i file ed escludere i file che non si desidera analizzare. In genere, si escludono i tipi di file che non contribuiscono all’interfaccia utente o i file che definiscono l’interfaccia utente ma che non vengono tradotti. Le regole di inclusione ed esclusione hanno il formato seguente:

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

La parte pattern di una regola viene utilizzata per corrispondere ai nomi dei file da includere o escludere. Il prefisso del pattern indica se si sta facendo corrispondenza a un nodo JCR (la relativa rappresentazione in Vault) o al file system.

Prefisso Effetto
/ Indica un percorso JCR. Pertanto, questo prefisso corrisponde ai file sotto la directory jcr_root.
* Indica un file regolare sul file system.
nessuno Nessun prefisso o un pattern che inizia con un nome di cartella o file indica un file regolare nel file system.

Se utilizzato all'interno di un pattern, il carattere / indica una sottodirectory e * il carattere corrisponde a tutti. Nella tabella seguente sono elencate diverse regole di esempio.

Regola di esempio Effetto
{ /include "*" } Includi tutti i file.
{ /exclude "*.pdf" } Escludere tutti i file PDF.
{ /exclude "*/pom.xml" } Escludere i file POM.
{ /exclude "/content/*" } { /include "/content/catalogs/geometrixx/templatepages" } { /include "/content/catalogs/geometrixx/templatepages/*" }

Escludi tutti i file sotto il nodo /content.

Includi il nodo /content/catalogs/geometrixx/templatepages .

Includi tutti i nodi figlio di /content/catalogs/geometrixx/templatepages.

Estrazione delle stringhe

nessun 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=.

Con POM: Aggiungi questo a 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>

il comando:

mvn xgettext:extract

File di output

  • raw.xliff: stringhe estratte

  • warn.log: eventuali avvertenze, se CQ.I18n.getMessage() L’API viene utilizzata in modo errato. Questi hanno sempre bisogno di una correzione e poi di una riesecuzione.

  • parserwarn.log: avvisi sul parser (se presenti), ad esempio problemi di parser js

  • potentials.xliff: candidati "potenziali" che non sono estratti, ma potrebbero essere stringhe leggibili dall'uomo che necessitano di traduzione (può essere ignorato, produce ancora una grande quantità di falsi positivi)

  • strings.xliff: file xliff appiattito, da importare in ALF

  • backrefs.txt: consente la ricerca rapida delle posizioni del codice sorgente per una stringa specificata

In questa pagina