Howto - Creating a new file filter

Guida di OmegaT: Creazione di un nuovo filtro di file

Questa guida spiega come creare un nuovo filtro di file per l'uso con OmegaT descrivendo la creazione di un filtro rudimentale per il formato TMX. Anche se può sembrare strano voler tradurre file TMX (il motivo usuale per la creazione di un filtro di file), l'aggiunta di un filtro TMX produce l'interessante effetto di permettere la ricerca all'interno dei file TMX da qualsiasi posizione, all'interno di qualsiasi progetto OmegaT, tramite la funzione "Ricerca file", cosa non possibile nell'impianto standard di OmegaT.

Per la compilazione di OmegaT dal codice sorgente, vedere la Guida alla compilazione di OmegaT dal codice sorgente.

Selezionare un filtro esistente per un formato simile a quello per il nuovo filtro. In questo esempio, il filtro Help & Manual è stato selezionato come base.

Individuare la cartella src/org/omegat/filters3/xml e fare una copia della sottocartella /helpandmanual, chiamandola /tmx. In questa cartella, rinominare i due file HelpandManualDialect.java e HelpandManualFilter.java in TmxDialect.java e TmxFilter.java, rispettivamente.

Aprire il file TMXDialect.java e il filtro TMX in un editor di testo. In entrambi i file, cercare (con discriminazione delle maiuscole/minuscole) e sostituire:

"helpandmanual" con "tmx"
"HelpAndManual" con "TMX"
"HELPANDMANUAL" con "TMX"
"Help & Manual" con "TMX"
"Help&Manual" con "TMX"

Identificare i tag a livello di paragrafo per il nuovo formato di file. Per scoprire quali dovrebbero essere i tag di paragrafo, esaminare un file di esempio in un editor di testo. In TMX, il tag di paragrafo corrispondente a un segmento è "tu".

In TMXDialect.java:

Definire i tag di paragrafo, in questo caso modificando la riga:

   defineParagraphTags(new String[] { "caption", "config-value", "variable", "para", "title", "keyword", "li", });

in

   defineParagraphTags(new String[] { "tu", });

È possibile eliminare la riga:

   defineShortcut("link", "li");

in quanto è irrilevante per TMX, sebbene il nuovo filtro continuerà a funzionare anche se non si elimina.

È possibile definire i tag fuori testo. Questi definiscono sottosegmenti che vengono presentati al di fuori del segmento in cui sono contenuti (le note a piè di pagina sono un buon esempio). Per fare questo per il filtro TMX, inserire la riga

   defineOutOfTurnTags(new String[] { "sub", });

sotto la riga

   defineParagraphTags(new String[] { "tu", });

Il filtro continuerà comunque a funzionare anche se non viene inserita.

Sotto queste righe, è possibile anche inserire il codice:

   defineIntactTags(new String[]
   {
   "header",
   "prop",
   "ph",
   "bpt",
   "ept",
   "it",
   "ut",
   });

Questo codice renderà l'aspetto dei file TMX più ordinato ma, ancora una volta, esso non è assolutamente indispensabile.

In TMXFilter.java:

Cambiare l'estensione del file, in questo caso in .tmx, modificando la riga:

   public Instance[] getDefaultInstances() {
   return new Instance[] { new Instance("*.xml", null, null), new Instance("*.hmxp", null, null), };

in:

   public Instance[] getDefaultInstances() {
   return new Instance[] { new Instance("*.tmx", null, null), };

In /src/org/omegat la cartella, aprire il file Bundle.properties in un editor di testo e individuare le righe

   # HelpAndManualFilter.java
   HELPANDMANUAL_FILTER_NAME=Help & Manual Files

Sotto di esse, inserire le righe:

   # TMXFilter.java
   TMX_FILTER_NAME=TMX files

(Se si desidera avviare OmegaT con una lingua di interfaccia utente diversa dall'inglese, apportare la stessa modifica nel file Bundle.properties localizzato interessato.)

Nella cartella principale del codice sorgente, aprire il file manifest-template.mf in un editor di testo. Trovare le righe:

   Name: org.omegat.filters3.xml.helpandmanual.HelpAndManualFilter
   OmegaT-Plugin: filter

Sotto di esse, inserire le righe:

   Name: org.omegat.filters3.xml.tmx.TMXFilter
   OmegaT-Plugin: filter

Compilare come descritto nella Guida alla compilazione di OmegaT da codice sorgente. Avviare la versione appena compilata. Verificare che in "Opzioni > Filtri dei file" sia presente il nuovo filtro. Per verificare la correttezza del suo funzionamento è possibile inserire un file TMX nella cartella /source di un progetto o, ancora meglio, eseguire una Ricerca di testo > operazione di ricerca file su file TMX.

Copyright Marc Prior 2008-2011