# Gtranslator do Manual

2008 Igalia
2001 Emese Kovacs
2010 Fran Diéguez (frandieguez@ubuntu.com)
Proxecto de documentación de GNOME
Esta é a versión do manual do Gtranslator.

Información de contacto

Para informar dun erro ou facer unha suxestión sobre este aplicativo ou esta documentación, vexa a Páxina de axuda do GNOME

Pablo Sanxiao
Igalia

    	    psanxiao@gmail.com

Emese Kovacs
Proxecto de documentación de GNOME

    	    emese@gnome.hu

Manual do Gtranslator v0.6
Setembro do 2008

Pablo Sanxiao

Igalia

Manual do Gtranslator v0.6
Agosto de 2003

Abel Cheung

Proxecto de documentación de GNOME

Manual do Gtranslator v0.4
Agosto do 2001

Emese Kovacs

Proxecto de documentación de GNOME

Gtranslator é un editor de ficheiros PO gettext mellorado para o contorno de escritorio GNOME.

## Introdución

Gtranslator offers you a comfortable graphical interface to edit gettext PO files. It allows you to easily navigate among fuzzy, translated and untranslated messages and has a status bar displaying the number of messages for each category.

Gtranslator features opening and editing some PO files at the same time including to manage their headers, seeing the developer's information for each message (comments, context) and set new personal comments.

The profiles function allows you to have different accounts with the necessary information to fill the header. The option use my options to complete the following entries in the edit header dialog takes the information from the active profile in order to fill the header values.

The new system of translation memories lets you use any translated PO files in order to create a database that will offer you suggestions how to translate the current message.

Gtranslator provides a plugin system which makes it easily extending. It includes some useful plugins such as a svn plugin in that does the checkouts from the repository and commits the new translations. There are also plugins to visualize the source code where a message is located, to search in translation databases of web services like Open Tran and many others.

To run Gtranslator, select Programs Development Gtranslator from the Main Menu, or type `gtranslator` on the command line.

## Usar Gtranslator

Gtranslator is a full featured graphical environment that makes it possible to translate PO files painlessly. This section describes basic usage of Gtranslator.

### Uso básico

Starting Gtranslator opens the Main window.

Xanela principal

Xanela principal do Gtranslator

The Main window is divided into three main areas:

- The menubar allows you the access the application menu.

- The toolbar allow you quick access to frequently used file management, navigation and compile functions.

- The workspace allows you to visualize and edit the messages contained in the PO file. This area is divided further into three areas. At the top is the message area with all messages of the PO file and its state. Below the message area on the left the original message is shown and next to it is the text input field into which one writes the translation. Finally, on the right there is a panel with auxiliary information to help in the translation process.

#### Configuración

Gtranslator settings can be modified by choosing Edit Preferences menuitem.

#### Cargar un ficheiro PO

To load a PO file, use the File Open menuitem. It will bring up the Open file for translation dialog box. Browse through your computer file system, choose the PO file you wish to open and click OK.

#### Editar un ficheiro PO

The message area shows all the messages in the PO file and their state. It is possible to go to one specific message by clicking on it directly. You can also move through the messages with the forward and back buttons in the toolbar. In the menu using Go next fuzzy and Go previous fuzzy it is possible to move directly among fuzzy messages and using Go next untranslated and Go previous untranslated it is possible to move directly among untranslated messages.

#### Gardar un ficheiro PO

When a PO file has been modified (in a message or in the header) a * appears before its name in the window title or in the tab if you are editing some PO files at the same time.

If you close the PO file at this moment, then the close dialog will be shown to you with this aspect:

Pechar o diálogo

Diálogo de pechar do Gtranslator

### Características avanzadas

Gtranslator offers to translator many features in order to do the translation process easier and more comfortable.

#### Perfiles

The profiles feature provides to translator the possibility of having different accounts with individual basic information about the translator and language settings.

There is always only one profile active at a time. You can Add, Edit and Remove accounts. When you save a PO file and you have activated the option use my options to complete the following entries in the header dialog, Gtranslator will fill the header fields with the information from the active profile.

Diálogo de perfiles

Gtranslator Profiles Dialog

#### Memoria de tradución

The translation memory lets you reuse the translations. It is a database that contains messages and their correspondent translation for a specific language.

Gtranslator offers the possibility of creating translation memories in two different ways. You can create the translation memory from a directory that contains PO files (see ). The program will create also a new entry in the translation memory each time that you translate a new message.

The manner of using the translation memory it is very easy. With the translation memory panel active (if it is not active go to View Translation Memory ) you will can see the options that the translation memory offers you in order to translate the current message. If you can choose one of them, just use the keyboard accelerator associated to that option.

Memoria de tradución

Memoria de tradución do Gtranslator

The level column shows you in percent how well each option matches the selected message. The options are sorted by how well they match.

### Barra de ferramentas

The toolbar provides access to several commonly used routines. It is easily customizable. You can add or remove buttons as follow:

Go to Edit Toolbar . The next dialog it will be showed you:

Barra de ferramentas

Barra de ferramentas do Gtranslator

You can add or remove buttons just drag and drop them between the toolbar and the toolbar editor.

#### File management buttons in the toolbar

The file management buttons lets you access frequently used file management functions quickly.

Abrir

  Brings up the Open file for translation dialog.

Gardar

  Garda o ficheiro PO.

Gardar como

  Garda o ficheiro PO con un nome diferente.

Cabeceira

  Brings up the Edit Header dialog box with a form that lets you fill in the fields of the PO files header.

Desfacer

  Desfai a súa última acción.

#### Botóns de navegación na barra de ferramentas

The navigation buttons allow you to navigate among messages. They also let you search for strings, or search and replace strings.

Primeira

  Salta á primeira mensaxe.

Última

  Salta á última mensaxe.

Adiante

  Salta á seguinte mensaxe.

Atrás

  Salta á anterior mensaxe.

Seguinte dubidosa

  Salta á seguinte mensaxe dubidosa

Anterior dubidosa

  Salta á anterior mensaxe dubidosa

Seguinte sen traducir

  Salta á seguinte mensaxe sen traducir

Anterior sen traducir

  Salta á anterior mensaxe sen traducir

Next Fuzzy or Untranslated

  Jumps to the next fuzzy or untranslated message.

Previous Fuzzy or Untranslated

  Jumps to the previous fuzzy or untranslated message.

Saltar a

  Salta a unha mensaxe cun número especificado

Buscar

  Opens the Find dialog box. This dialog lets you search for strings in the PO file. You can choose to find strings inside original messages only, translated messages, comments or all of the above.

Substituír

  Opens the Replace dialog box. This dialog lets you enter a string to search for and a string to replace it with.

### Barra de menú

The menu bar, located at the top of the Main Window, contains the following menus:

Ficheiro

  This menu contains:

  - Control O Open This opens a PO file.

  - Recent Files This shows a list of your recently opened PO files.

  - Ctrl S Save This saves your file.

  - Ctrl Shift S Save As This saves your PO file under a different name.

  - Ctrl W Close This closes your file.

  - Ctrl Q Exit This quits the application.

Editar

  Este menú contén:

  - Ctrl Z Undo This undoes your last change.

  - Ctrl X Cut This removes any text or data which is selected and places it in the buffer.

  - Ctrl C Copy This copies any text or data which is selected into the buffer.

  - Ctrl V Paste This pastes any text or data which is copied into the buffer.

  - Clear This removes the selected text.

  - Header... This opens a dialog box which allows you to edit information stored in the PO file header.

  - Comment... This allows to write a comment associates to one message.

  - Ctrl Space Copy Message to Translation This pastes the text from the original message in the translated message.

  - Ctrl U Toggle Fuzzy Status This toggles the current message fuzzy status.

  - Translation memory This shows the options in the translation memory for the current message.

  - Toolbar This opens the Toolbar Editor.

  - Preferences This opens the Preferences dialog.

Ver

  Este menú contén:

  - Context This shows or hides the context panel.

  - Translation Memory This shows or hides the translation memory panel.

Ir

  Este menú contén:

  - First Go to the first message.

  - Back Go to the previous message.

  - Next Go to the next message.

  - Last Go to the last message.

  - Next fuzzy Go to the next fuzzy message.

  - Previous fuzzy Go to the previous fuzzy message.

  - Next untranslated Go to the next untranslated message.

  - Previous untranslated Go to the previous untranslated message.

  - Next fuzzy or untranslated Go to the next fuzzy or untranslated message.

  - Previous fuzzy or untranslated Go to the previous fuzzy or untranslated message.

  - Jump to Go to the message with a specific number.

Buscar

  Este menú contén:

  - Find This command opens the Find dialog.

  - Replace This opens the Replace dialog.

Axuda

  Este menú contén:

  - Contents This opens the GNOME Help Browser (or Nautilus) and displays this manual.

  - Gtranslator website This opens the Gtranslator webpage.

  - About This opens the About dialog which shows basic information about Gtranslator, such as author name, the application version number, and the URL for the application web page.

### Available command line options

Gtranslator understands a number of command line options:

`--help`

  Mostra unha mensaxe de axuda curta na liña de ordes.

## Personalización

To change the application settings, select Edit Preferences . This opens the Preferences dialog.

Diálogo de preferencias

Diálogo de preferencias do Gtranslator

### Separador Ficheiros

The properties in the File tab are:

Gardar automáticamente cada x minutos

  This option determines how often Gtranslator must save the current file.

Crea unha copia de respaldo dos ficheiros antes de gardar

  If this option is activated, a backup copy of the current files is created before saving them. If Gtranslator crashes while saving, the files can be restored with the backup copies.

### Separador Editor

The properties in the Editor tab are:

Separador Editor

Separador do editor de Gtranslator

Resaltar a sintaxe da mensaxe

  Esta opcións activa o resaltado de sintaxe nas caixas de mensaxe orixinal e traducida.

Facer visibles os espazos en branco

  Con esta opción activada os espazos en branco nas caixas de mensaxe orixinal e traducida móstranse como puntos.

Usar tipo de letra personalizada

  This option lets you set a custom font for the original and translated message boxes.

Eliminar o estado dubidoso se a mensaxe é modificada

  If this option is active the status will change automatically if you edit a message.

Comprobar ortografía

  This option enables the spell-checking for your language in the original and translated message boxes.

### Separador Perfiles

The Profiles tab contains:

Separador Perfiles

Gtranslator Profiles Tab

Botón de engadir

  Shows the Profile dialog in order to create a new profile.

Botón de editar

  Shows the Profile dialog in order to edit an exists profile.

Botón de eliminar

  Elimina o perfíl seleccoinado.

As entradas do diálogo Perfiles son:

Diálogo de perfiles

Diálogo de perfiles do Gtranslator

Nome do perfíl

  It is the name of the profile. It identifies the profile and must be unique.

Nome do tradutor

  Este é o nome do tradutor para completar o valor da cabeceira.

Correo electrónico do tradutor

  This is the email address of the translator to fill the value in the header.

Idioma

  The name of the language into which the translations will be done.

Código de idioma

  This is the ISO 639-2 language code used for the language chosen above. The name of the PO file will be based on this setting.

Conxunto de caracteres

  This is the character set for the PO files. Gnome 2.x uses UTF-8 encoding for all languages.

Codificación de transferencia

  This is the encoding used to store the PO file.

Correo electrónico do grupo

  This is the email address of the language team.

Formas plurais

  Information about the plural forms in the PO files.

### Separador Interface

The Interface tab contains:

Separador Interface

Separador Interface do Gtranslator

Estilo da áncora

  Lets you choose if you want to see only icons in the toolbar, icons with text or use the Gnome preferences.

Esquema de cor

  This is the scheme color in the original and translated boxes.

### Separador Memoria de tradución

The Translation Memory tab contains:

Separador Memoria de tradución

GtranslatorTranslation Memory Tab

Mostrar as opcións das mensaxes traducidas

  With this option activated Gtranslator shows you the translation memory options for all messages including the translated ones. If it is not active options are ony shown for fuzzy and untranslated messages.

Usar só ficheiros con este nome

  If this option is used the translation memory will be created only using the files with this name into the directory selected.

Número máximo de palabras incorrectas

  Maximum number of words that can be missing from a message displayed as a match by the translation memory.

Max difference in sentence length

  Maximum difference in length between messages displayed as matches by the translation memory.

### Separador de engadidos

## Erros coñecidos e limitacións

You can query for bugs related to Gtranslator in the GNOME bug tracking database. .

## Autores

### Autores do aplicativo

Gtranslator was written originally by Fatih Demir kabalak@kabalak.net and Gediminas Paulauskas menesis@kabalak.net. Ross Golder rossg@golder.org was the maintainer of GTK+ 2.x port of Gtranslator until October 2007.

Most of the new version 2.0 was written by Pablo Sanxiao psanxiao@gmail.com and Ignacio Casal Quinteiro nacho.resa@gmail.com. The current maintainers are Pablo Sanxiao and Juan José Sánchez Penas jjsanchez@igalia.com.

To find more information about Gtranslator, please visit the Gtranslator Web page. Please send all comments, suggestions, and bug reports to the GNOME bug tracking database. (Instructions for submitting bug reports can be found on-line.) You can also use Bug Report Tool (`bug-buddy`), available in the Application Development menu, for submitting bug reports.

### Contribuidores

Persoas que contribuíron ao proxecto Gtranslator:

- Seán de Búrca leftmostcat@gmail.co

- Thomas Ziehmer thomas@kabalak.net pola implementación do diálogo de busca.

- Todos os tradutores do Gtranslator.

- A rolda de correo GNOME I18Ngnome-i18n@gnome.org

- Alexandre Hautequest hquest@fesppr.br

- Denis Pleić dpleic@linux.hr

- Josh Jackson pturing@mailandnews.com

- Robert Brady robert@suse.co.uk

### Empaquetadores

We would want to thank those persons for providing packages in the corresponding formats of Gtranslator.

- Josh Jackshon pturing@mailandnews.com polos paquetes para Mandrake do Gtranslator 0.34

- Mike Newman mike@gtnorthern.demon.co.uk polos seus (S)RPM RH7 do Gtranslator.

- Martijn van de Streek martijn@foodfight.org (2000-2001), Ryan Murray rmurray@debian.org (2001-2002) and Jordi Mallachjordi@debian.org (2003-2012) for their Debian packages of Gtranslator.

- Maxim Sobolev sobomax@freebsd.org for his FreeBSD ports of Gtranslator.

### Autores da documentación

This manual was written by Pablo Sanxiao (psanxiao@gmail.com) based on the last version of the manual written by Emese Kovacs (emese@gnome.hu). Please send all comments and suggestions regarding this manual to the GNOME Documentation Project by sending an email to docs@gnome.org. You can also add your comments online by using the GNOME Documentation Status Table .

## Licenza

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, of (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License is included as an appendix to the GNOME Users Guide . You may also obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to

    Free Software Foundation, Inc.
    	59 Temple Place - Suite 330
    	Boston,
    	MA
    	02111-1307
    	USA