# Gtranslator Manual

2008 Igalia
2001 Emese Kovacs
GNOME Documentation Project
This is version &manualversion; of &app; manual.

Feedback Information

To report a bug or make a suggestion regarding this application or this documentation, please see the GNOME Feedback Page

Pablo Sanxiao
Igalia

    	    psanxiao@gmail.com

Emese Kovacs
GNOME Documentation Project

    	    emese@gnome.hu

&app; Manual V&manualversion;
September 2008

Pablo Sanxiao

Igalia

&app; Manual V&manualversion;
August 2003

Abel Cheung

GNOME Documentation Project

&app; Manual V0.4
August 2001

Emese Kovacs

GNOME Documentation Project

&app; is an enhanced gettext PO file editor for the GNOME desktop environment.

## Introduction

&app; 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.

&app; 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.

&app; 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 &app;, select Programs Development &app; from the Main Menu, or type `gtranslator` on the command line.

## Using &app;

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

### Basic usage

Starting &app; opens the Main window.

Main Window

&app; Main Window

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.

#### Configuration

&app; settings can be modified by choosing Edit Preferences menuitem.

#### Loading a PO file

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.

#### Editing PO file

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.

#### Saving PO file

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:

Close Dialog

&app; Close Dialog

### Advanced features

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

#### Profiles

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, &app; will fill the header fields with the information from the active profile.

Profiles Dialog

&app; Profiles Dialog

#### Translation Memory

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

&app; 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.

Translation Memory

&app; Translation Memory

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

### Toolbar

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:

Tool Bar

&app; Tool Bar

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.

Open

  Brings up the Open file for translation dialog.

Save

  Saves the PO file.

Save as

  Saves the PO file under a different name.

Header

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

Undo

  Reverts your last action.

#### Navigation buttons in the toolbar

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

First

  Jumps to the first message.

Last

  Jumps to the last message.

Forward

  Jumps to the next message.

Back

  Jumps to the previous message.

Next Fuzzy

  Jumps to next fuzzy message.

Previous Fuzzy

  Jumps to the previous fuzzy message.

Next Untranslated

  Jumps to the next untranslated message.

Previous Untranslated

  Jumps to the previous untranslated message.

Next Fuzzy or Untranslated

  Jumps to the next fuzzy or untranslated message.

Previous Fuzzy or Untranslated

  Jumps to the previous fuzzy or untranslated message.

Jump to

  Jumps to the specified message number.

Find

  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.

Replace

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

### Menu Bar

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

File

  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.

Edit

  This menu contains:

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

View

  This menu contains:

  - Context This shows or hides the context panel.

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

Go

  This menu contains:

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

Search

  This menu contains:

  - Find This command opens the Find dialog.

  - Replace This opens the Replace dialog.

Help

  This menu contains:

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

  - &app; website This opens the &app; webpage.

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

### Available command line options

&app; understands a number of command line options:

`--help`

  Shows you a short help message on the command line.

## Customization

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

Preferences Dialog

&app; Preferences Dialog

### File Tab

The properties in the File tab are:

Autosave files every x minutes

  This option determines how often &app; must save the current file.

Create a backup copy of files before saving

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

### Editor Tab

The properties in the Editor tab are:

Editor Tab

&app; Editor Tab

Highlight message syntax

  This option activates syntax highlighting in the original and translated message boxes.

Make whitespace visible

  With this option actived whitespaces in the original and translated message boxes are shown as dots.

Use custom font

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

Remove fuzzy status if message is changed

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

Check spelling

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

### Profiles Tab

The Editor tab contains:

Profiles Tab

&app; Profiles Tab

Add button

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

Edit button

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

Delete button

  Removes the selected profile.

The entries in the Profiles dialog are:

Profiles Dialog

&app;Profiles Dialog

Profile Name

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

Translator Name

  This is the name of the translator to fill the value in the header.

Translator Email

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

Language

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

Language Code

  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.

Character Set

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

Transfer Encoding

  This is the encoding used to store the PO file.

Team Email

  This is the email address of the language team.

Plural Forms

  Information about the plural forms in the PO files.

### Interface Tab

The Interface tab contains:

Interface Tab

&app;Interface Tab

Anchor Style

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

Scheme Color

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

### Translation Memory Tab

The Translation Memory tab contains:

Translation Memory Tab

&app;Translation Memory Tab

Show options in translated messages

  With this option activated &app; 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.

Use only files with this name

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

Max # of missing words

  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.

### Plugins Tab

## Known Bugs and Limitations

You can query for bugs related to &app; in the GNOME bug tracking database. .

## Authors

### Application Authors

&app; 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 &app; 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 &app;, 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.

### Contributors

People who have contributed to the &app; project:

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

- Thomas Ziehmer thomas@kabalak.net for the find dialog implementation.

- All translators of &app;.

- The GNOME I18N mailing list gnome-i18n@gnome.org

- Alexandre Hautequest hquest@fesppr.br

- Denis Pleić dpleic@linux.hr

- Josh Jackson pturing@mailandnews.com

- Robert Brady robert@suse.co.uk

### Packagers

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

- Josh Jackshon pturing@mailandnews.com for his Mandrake packages of &app; 0.34

- Mike Newman mike@gtnorthern.demon.co.uk for his RH7 (S)RPMs of &app;.

- Martijn van de Streek martijn@foodfight.org for his Debian packages of &app;.

- Maxim Sobolev sobomax@freebsd.org for his FreeBSD ports of &app;.

### Documentation Authors

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 .

## License

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