# Filtros de ficheiro

OmegaT inclúe filtros altamente personalizábeis, o que lle permitirá configurar numerosos aspectos. Os filtros de ficheiro son partes de código capaces de:

- Ler o documento nalgúns formatos de ficheiro específicos. Por exemplo, ficheiros de texto plano.

- Extraer o contido traducíbel do ficheiro.

- Automatizar modificacións dos nomes de ficheiro do documento traducido cambiando os contidos traducíbeis coa súa tradución.

Para ver que formatos permite OmegaT, vexa o menú Opcións > Filtros de ficheiro...

A maioría dos usuarios atoparán suficientes opcións de filtrado de ficheiros predeterminadas. Se este non é o seu caso, abra o diálogo principal seleccionando Opcións > Filtros de ficheiro... desde o menú principal. Tamén pode activar filtros de ficheiro específicos para cada proxecto, que só se empregarán no proxecto actual, seleccionando a opción Filtros de ficheiro... nas propiedades do proxecto.

Pode activar filtros específicos para o proxecto mediante o menú Proxecto > Propiedades.... Faga clic en Filtros de ficheiro e marque a caixa de verificación Permitir filtros específicos para o proxecto. Gardarase unha copia da configuración dos filtros xunto co proxecto. Se despois cambia os filtros, só se actualizarán os filtros do proxecto, mentres que os filtros do usuario se manterán sen ningún cambio.

Filtros de ficheiro Filtros de ficheiro específicos para o proxecto

Atención! Se cambia as opcións dos filtros mentres está aberto un proxecto, debe reabrir o proxecto para que se efectúen os cambios.

## Diálogo de filtros de ficheiro

Filtros de ficheiro Diálogo

Este diálogo amosa a lista dos distintos filtros de ficheiro dispoñíbeis. Se non quere empregar OmegaT para traducir ficheiros dalgún tipo en concreto, pode desactivar o filtro correspondente desmarque a caixa de verificación ao seu carón. OmegaT omitirá entón os ficheiros apropiados á hora de cargar proxectos, e copiará os devanditos ficheiros sen modificar cando se creen os documentos de destino. Cando desexe empregar o filtro de novo, active a caixa de verificación. Faga clic en Predeterminados para volver os filtros de ficheiro ao estado predeterminado. Para editar que ficheiros e codificacións procesará cada filtro, seleccione o ficheiro da lista e prema en Editar.

## Opcións de filtrado

Filtros de ficheiro Opcións

Moitos filtros (ficheiros de texto, ficheiros XHTML, ficheiros HTML e XHTML, ficheiros OpenDocument e ficheiros Microsoft Open XML) teñen unha ou máis opcións específicas. Para modificar as opcións, seleccione o filtro da lista e faga clic en Opcións. As opcións dispoñíbeis son:

Ficheiros de texto

- Segmentación por parágrafos en saltos de liña, liñas baleiras ou nunca:

  se están activadas as regras de segmentación por frase, o texto será segmentado segundo a opción seleccionada.

Ficheiros PO

- Permitir traducións en branco no ficheiro de destino:

  se esta opción está activada, cando non se traduce un ficheiro PO (que pode ser un parágrafo enteiro), a tradución podería estar baleira no ficheiro de destino. Tecnicamente, o segmento `msgstr` do ficheiro PO, se se crea, deixarase baleiro. Xa que este é o comportamento normal para os ficheiros PO, está activado por defecto. Se se desactiva esta opción, o texto orixinal será copiado no segmento de destino.

- Omitir cabeceira de PO

  Se se activa esta opción, as cabeceiras de PO serán omitidas e deixaranse sen cambiar.

- Substituír automaticamente 'nplurals=INTEGER; &plural=EXPRESSION;' na cabeceira

  Esta opción permite que OmegaT sobrescriba a especificación na cabeceira do ficheiro PO e empregue as opcións predeterminadas para o idioma de destino seleccionado.

Ficheiros XHTML

- Engadir ou reescribir o código de ficheiros HTML e XHTML: moitas veces os ficheiros de destino teñen que ter un conxunto de codificación de caracteres diferente ao do ficheiro de orixe (tanto se está definido explícita coma implicitamente). Empregando esta opción, o tradutor pode especificar se os ficheiros de destino terán unha declaración de codificación incluída. Por exemplo, se os filtros de ficheiro especifican UTF8 coma esquema de codificación para os ficheiros de destino, seleccionar Sempre asegurará que esta información se inclúe nos ficheiros traducidos.

- Traducir os seguintes atributos: os atributos seleccionados aparecerán coma segmentos na xanela de edición.

- Iniciar un novo parágrafo en: a etiqueta HTML <br> creará un novo parágrafo para os efectos de segmentación.

- Omitir as expresións regulares de coincidencia de texto: omitirase o texto que coincida coas expresións regulares. Amosarase en vermello na validación de etiquetas. O texto no segmento de orixe que coincide amósase en cursiva.

- Non traducir o atributo de contido das metaetiquetas...: As seguintes metaetiquetas non serán traducidas.

- Non traducir o contido das etiquetas cos seguintes pares chave-valor dos atributos (separados por comas):: unha coincidencia na lista de pares chave-valor causará que se ignore o contido das etiquetas.

  Ás veces é útil ser capaz de facer algunhas etiquetas intraducíbeis baseándose no valor dos atributos. Por exemplo, `<div class="hide"> <span translate="no">` Pode definir pares chave-valor para que algunhas etiquetas se deixen sen traducir. No exemplo anterior, o campo debería conter: `class=hide, translate=no`

Ficheiros Microsoft Office XML

Pode seleccionar que elementos se van traducir. Aparecerán coma segmentos separados na tradución.

- Word: texto de instrución non visíbel, comentarios, notas a pé, notas ao final, rodapés

- Excel: comentarios, nome das follas

- Power Point: comentarios das diapositivas, padróns de diapositivas, deseño das diapositivas

- Global: gráficas, diagramas, debuxos, WordArt

- Outras opcións:

  - Agregar etiquetas: se se marca, as etiquetas sen texto traducíbel entre elas agregaranse coma etiquetas simples.

  - Manter os espazos para todas as etiquetas: se se marca, manterase o «espazo en branco» (é dicir, espazos e quebras de liña), incluso se non se estabelecen tecnicamente no documento

Ficheiros HTML e XHTML

- Engadir ou reescribir a declaración de codificación de ficheiros HTML e XHTML: Sempre (predeterminado), Só se o ficheiro (X)HTML ten un cabezallo, Só se o ficheiro (X)HTML ten unha declaración de codificación, Nunca.

- Traducir os seguintes atributos: os atributos seleccionados aparecerán coma segmentos na xanela de edición.

- Iniciar un novo parágrafo en: a etiqueta HTML <br> creará un novo parágrafo para os efectos de segmentación.

- Omitir as expresións regulares de coincidencia de texto: o texto que coincida coas expresións regulares se omitirá.

- Non traducir o atributo de contido das metaetiquetas...: As seguintes metaetiquetas non serán traducidas.

- Non traducir o contido das etiquetas cos seguintes pares chave-valor dos atributos (separados por comas):: unha coincidencia na lista de pares chave-valor causará que se ignore o contido das etiquetas.

Ficheiros de texto

- Segmentación por parágrafos en saltos de liña, liñas baleiras ou nunca:

  se están activadas as regras de segmentación por frase, o texto será segmentado segundo a opción seleccionada.

Ficheiros en formato Open Document (ODF)

- Pode seleccionar cal dos seguintes elementos serán traducidos:

  entradas do índice, marcadores, referencias dos marcadores, notas, comentarios, notas das presentacións, ligazóns (URL), nomes das follas

## Diálogo de edición de filtros

Filtros de ficheiro Edición

Este diálogo permítelle configurar os padróns de nome de ficheiro orixe dos ficheiros que se procesarán, personalizar os nomes de ficheiro dos ficheiros traducidos, e seleccionar a codificación a empregar na carga e gardado do ficheiro. Para modificar un padrón de filtro de ficheiro, pode modificar os campos directamente ou ben facer clic en Editar. Para engadir un novo padrón de filtros de ficheiro, faga clic en Engadir. Emprégase o mesmo diálogo para engadir un padrón ou para editar un padrón en particular. O diálogo é útil porque inclúe un editor especial de padróns de nomes de ficheiro de destino que pode configurar os nomes dos ficheiros creados.

### Tipo de ficheiro de orixe, padrón do nome do ficheiro

Ficheiros de orixe Tipo de ficheiro e padrón do nome
Filtros de ficheiro Tipo de ficheiro e padrón do nome

Cando OmegaT atopa un ficheiro no cartafol de orixe, intenta seleccionar o filtro baseándose na extensión dos ficheiros. Para ser precisos, OmegaT intenta coincidir cada padrón dos nomes do ficheiro de orixe dos filtros co nome do ficheiro. Por exemplo, o padrón `*.xhtml` fai coincidir calquera ficheiro coa extensión `.xhtml`. Se se atopa o filtro apropiado, asígnase o ficheiro para ser procesado. Por exemplo, de xeito predeterminado, empréganse os filtros XHTML para o procesado de ficheiros coa extensión .xhtml. Pode cambiar o engadir padróns de nomes de ficheiro para que os ficheiros sexan xestionados por cada filtro. Os padróns de nome de ficheiro de orixe utilizan caracteres comodín similares aos empregados nas Buscas. O carácter '*' coincide con ningún ou máis caracteres. O carácter '?' coincide con exactamente un carácter. O resto de caracteres represéntanse a eles mesmos. Por exemplo, se desexa que o filtro de textos xestione os ficheiros léame (`leame, lea.me`, e `leame.txt`) debería empregar o padrón `lea*`.

### Codificación dos ficheiros de orixe e destino

Só un número limitado de formatos de ficheiro especifican unha codificación obrigatoria. Os formatos de ficheiros que non especifican a codificación, empregarán a codificación estabelecida por vostede para a extensión que coincida co seu nome. Por exemplo, de modo predeterminado, os ficheiros `.txt` cargaranse empregando a codificación predeterminada do seu sistema operativo. Pode cambiar a codificación de orixe para cada padrón de nome de ficheiro de orixe diferente. Estes ficheiros tamén poden producirse en calquera codificación. De modo predeterminado, a codificación do ficheiro traducido é a mesma que a codificación do ficheiro de orixe. Os campos de codificación de orixe e destino empregan caixas de combinación que inclúen todas as codificacións admitidas. <auto> deixa a escolla de codificación a OmegaT. Así é como funciona:

- OmegaT identifica a codificación do ficheiro de orixe mediante o emprego da declaración de codificación, de habela (ficheiros HTML, ficheiros baseados en XML)

- OmegaT está construído para empregar unha codificación obrigatoria para certos formatos de ficheiros (propiedades de Java, etc.)

- OmegaT emprega a codificación predeterminada do sistema operativo para os ficheiros de texto.

Ficheiros orixe Codificación
Ficheiros de destino Codificación
Filtros de ficheiro Orixe, destino - codificación

### Nome de ficheiro de destino

Ficheiros de destino Nomes de ficheiro

Ás veces pode que desexe renomear os ficheiros que traduciu automaticamente, por exemplo, engadindo un código de idioma despois do nome do ficheiro. O padrón de nome de ficheiro de destino emprega unha sintaxe especial, así que se desexa editar este campo, debe facer clic en Editar... e empregar o Diálogo de edición de padróns. Se quere recuperar a configuración predeterminada do filtro, faga clic en Predeterminados. Tamén pode modificar o nome directamente no campo de padrón do nome de ficheiro de destino ou no diálogo de filtros de ficheiro. O diálogo de edición de padróns ofrece, entre outras, as seguintes opcións:

Filtros de ficheiro Diálogo

- O predeterminado é `${filename}`– nome do ficheiro completo do ficheiro de orixe con extensión: neste caso o nome do ficheiro traducido é o mesmo que o do ficheiro orixinal.

- `${nameOnly}`– permítelle inserir só o nome do ficheiro orixinal sen extensión.

- `${extension}` – a extensión do ficheiro orixinal.

- `${targetLocale}`– código de idioma de destino (coa forma «xx_YY»).

- `${targetLanguage}`– código do país e do idioma xuntos (coa forma «XX_YY»).

- `${targetLanguageCode}` – o idioma de destino - só «XX».

- `${targetCountryCode}`–o país de destino - só «YY».

- `${timestamp-????}` – hora do sistema no momento da creación do ficheiro en diferentes padróns.

  Vexa a Documentación de Oracle para máis exemplos dos padróns «SimpleDateFormat».

- `${system-os-name}` - sistema operativo do computador empregado

- `${system-user-name}` - nome de usuario do sistema

- `${system-host-name}` - nome do servidor do sistema

- `${file-source-encoding}` - codificación do ficheiro orixinal

- `${file-target-encoding}` - codificación do ficheiro de destino

- `${targetLocaleLCID}` - idioma de destino de Microsoft

Hai outras variantes adicionais para as variábeis ${nameOnly} e ${Extension}. Se o nome do ficheiro é ambivalente, pode aplicar variábeis da forma `${name only`-extension number} e `${extension`-extension number} . Se por exemplo, o ficheiro orixinal se chama Documento.xx.docx, as seguintes variábeis darán os seguintes resultados:

- `${nameOnly-0}` Documento

- `${nameOnly-1}` Documento.xx

- `${nameOnly-2}` Documento.xx.docx

- `${extension-0}` docx

- `${extension-1}` xx.docx

- `${extension-2}` Documento.xx.docx