Using Catalog Manager
Prev
Next

Chapter 3. Using Catalog Manager


Screenshot of Catalog Manager

The Catalog Manager merges two folders into one tree and displays all the PO and POT files in these folders. The display allows you to easily see if a new template has been added or an old one has been removed. Some information is shown along with each file name: total number of entries, number of fuzzy entries, number of untranslated entries, the date of the last revision and the last translator of the file.

Important

KBabel's Catalog Manager is meant for projects structured like KDE, where the POT and PO files share a same name, save the extensions. However this is not the case of GNU projects and of many projects structured like GNU ones. Typically in such projects, the PO file is named following the language code and so is very different than the name of the POT files. Also such projects have one POT file sharing a directory with all its translated PO files. Unfortunately, all these reasons mean that the Catalog Manager is not suitable for such projects. (See KDE bug #76495.)

To make it easier for you to find files that need work or are missing the status of each file is also displayed using an icon:

If an icon is marked with this icon , like , it indicates that this file or folder does not exist in the folder of the POT files.

You can mark or unmark a file by selecting Toggle Marking in the context menu of a file.

If you want to toggle or remove all markings in a folder, press the right mouse button over the folder and select Toggle Markings or Remove Markings. The markings are automatically saved when leaving KBabel.

To open a file either double-click on the file, select Open from the context menu or press either Return or Ctrl+O.

You can configure the Catalog Manager by Project-> Configure.... See section Project Settings for more details.

Catalog Manager Features

Besides the main feature for opening the files in KBabel Catalog Manager supports number of other features for maintaining a tree of PO-files.

Find and replace in multiple files

One of the most requested features for KBabel was a possibility to search and replace in multiple files at once. Catalog Manager supports this feature with a tight integration with KBabel

Statistics

Catalog Manager can show you a number of statistics about a single file or about the whole folders. The statistics contain number of files, how many of the files have their templates, how many templates are missing. It also counts number of messages in the files and shows statistics about how large parts of the messages are translated, fuzzy-translated or untranslated.

Checking the syntax

This allows you to check the syntax of multiple PO-files using msgfmt. If a file fails this check, it cannot be used for generating a MO-file for binary distribution. Such an incorrect file will typically result in failing compilation of the package the PO-file belongs to.

User-defined commands

Because Catalog Manager cannot provide any functionality you would like to use, you can extend it by defining your own commands.

There are two sets of commands. One for folders and one for single files. You can set them in configuration dialog and access by pressing right mouse button on an entry in the file list.

Prev
Next
Home


Would you like to comment or contribute an update to this page?
Send feedback to the TDE Development Team