Command Reference

The KBabel menu

The File Menu
Ctrl O File Open 	 Open PO-file. If current file is modified you will be prompted to save it first.
File Open Recent 	 More used documents list menu is displayed, allowing you to open recently edited PO-files.
Ctrl S File Save 	 Saves current PO-file. If it's not modified no action is taken.
File Save As 	 Save current PO-file under new name.
File New View 	 Open a new window with current file loaded. Very useful if you have to translate large files and you need to keep an eye back to some strings.
File New Window 	 Open a new empty window.
Ctrl Q File Quit 	 Quits KBabel

The Edit Menu
Ctrl Z Edit Undo 	 Undo last edit action in translation edit box.
Ctrl Shift Z Edit Redo 	 Redo last undoed edit action in translation edit box.
Ctrl X Edit Cut 	 Cut selected text and move it in clipboard.
Ctrl C Edit Copy 	 Copy selected in clipboard.
Ctrl V Edit Paste 	 Paste clipboard content at current cursor position in translation edit box.
Edit Select All 	 Select all text from translation edit box.
Ctrl F Edit Find... 	 Open Find dialog for searching strings in current PO-file.
F3 Edit Find Next 	 Find next occurrence of string from previous search action.
Ctrl R Edit Replace... 	 Open Replace dialog for searching and replacing strings in current PO-file.
Ctrl Space Edit Copy msgid to msgstr 	 Original english string is copied below in translation edit box. This useful when you need to make from no adjustment to minor changes in original english text (msgstr).
Ctrl Alt Space Edit Copy search result to msgstr 	 String found after translation searching is copied in MsgStr edit box. This very useful if you don't want to work on retranslating same message again and again.
Ctrl U Edit Unset Fuzzy Status 	 Reset fuzzy status for all entries in current PO-file. You should not do this unless you know what you are doing. Probably this will let many strings bad translated.
Edit Edit Header... 	 Edit PO-file header. Actually there are many header lines, which keep last translated date, translator name and email, language and translated text encoding etc.

The Go Menu
PgUp Go Previous 	 Skip to previous entry in PO-file.
PgDown Go Next 	 Skip to next entry in PO-file.
Go Go to... 	 Open dialog to jump to specified entry number from PO-file.
Go First Entry 	 Jump to first entry in PO-file.
Go Last Entry 	 Jump to last entry in PO-file.
Ctrl Alt PgUp Go Previous fuzzy or untranslated 	 Jump to first previous entry which is untranslated or marked as fuzzy.
Ctrl Alt PgDown Go Next fuzzy or untranslated 	 Jump to first next entry which is untranslated or marked as fuzzy.
Ctrl PgUp Go Previous fuzzy 	 Jump to first previous fuzzy entry.
Ctrl PgDown Go Next fuzzy 	 Jump to first next fuzzy entry.
Alt PgUp Go Previous untranslated 	 Jump to first previous untranslated entry.
Alt PgDown Go Next untranslated 	 Jump to first next untranslated entry.
Shift PgUp Go Previous error 	 Jump to previous entry with error. It's likely to happen when you forget to escape doublequotes or original string end in "return" (\n) char and translated string don't (and vice versa).
Shift PgDown Go Next error 	 Jump to next entry with error. It's likely to happen when you forget to escape doublequotes or original string end in "return" (\n) char and translated string don't (and vice versa).
Alt Left Go Back 	 Jump to last visited entry in PO-file.
Alt Right Go Forward 	 Jump to previous visited entry in PO-file.

The Dictionaries Menu
Note that this menu is dynamic. It depend on installed dictionaries plugins. By default are three.
Dictionaries Search Text KDE Database Search Engine 	 Start searching translation for current original english message using KDE Database Search Engine.
Dictionaries Search Text PO Auxiliary 	 Start searching translation for current original english message in PO file defined by user.
Dictionaries Search Text PO Compendium 	 Start searching translation for current original english message in compendium file (made by merging all translated messages for one language).
Dictionaries Search Selected Text KDE Database Search Engine 	 Start searching selected text using KDE Database Search Engine.
Dictionaries Search Selected Text PO Auxiliary 	 Start searching selected text using file defined by user.
Dictionaries Search Selected Text PO Compendium 	 Start searching selected text using compendium file with all language translated messages.
Dictionaries Edit Dictionary 	 Allow you to edit content of current dictionary. Usefull if you found errors in dictionary and want to not be bored by errors when searching and replacing strings. (Not implemented yet)

The Tools Menu
Tools Spelling Spell check... 	 Bring up spell check configuration dialog. After you select desired options hit OK and the normal spell checking dialog will appear.
Tools Spelling Check All... 	 Start spell checking all words for opened PO file.
Tools Spelling Check From Curson Position... 	 Start spell checking from current cursor position.
Tools Spelling Check Current... 	 Spell check only current entry from PO-file.
Tools Spelling Check Marked Text... 	 Spell check only selected text in MsgStr editbox.
Ctrl T Tools Validation Check Syntax 	 Check syntax for current PO-file. Errors may appear from CVS merging or users mistakes when translating process is made by hand.
Ctrl D Tools Validation Check Arguments 	 Check if number of arguments, types ans order is same in strings C-format like.
Ctrl H Tools Validation Check Accelerators 	 Check if number of accelerator characters is same both in original and translated text.
Ctrl K Tools Validation Look for Translated Context Info 	 Check if PO file contain context information translated by mistake.
Ctrl J Tools Validation Check Equations 	 Check if left side from translated string is same with left side from original string. Sides are delimited by equal sign character.
Tools Catalog Manager... 	 Open Catalog Manager window. Read Catalog Manager section for more details.

The Settings Menu
Settings Show Toolbar 	 When checked, standard toolbar is displayed.
Settings Show Statusbar 	 When checked, bottom statusbar is displayed.
Settings Show Navigationbar 	 When checked, navigationbar is displayed.
Settings Show Comments 	 When checked, upper right part of main window which contain current entry comments will be displayed.
Settings Show Tools 	 When checked, bottom right part of main window which contain search results through dictionary will be displayed.
Settings Configure Key Bindings... 	 Open configure dialog for keys bindings to actions. This will let you to customize default key bindings to suite your needs.
Settings Configure Toolbars... 	 Standard toolbars configuration dialog will open. You can choose which actions will go in toolbars and what toolbar you customize.
Settings Configure Kbabel... 	 All KBabel specific settings go here. Please read Preferences section for specific topics.
Settings Configure Dictionary KDE Database Search Engine 	 Open dialog for KDE Database Search Engine configuration.
Settings Configure Dictionary PO Auxiliary 	 Open dialog for PO auxiliary file configuration.
Settings Configure Dictionary PO Compendium 	 Open dialog for PO compendium file configuration.

The Help Menu
F1 Help Contents 	 Open the KBabel handbook. It's what you read now.
Shift F1 Help What's This? 	 Cursor change to arrow with question mark and you can click with it on various elements on main window. A quick help window will open.
Help Gettext Info 	 Open the gettext manual page in KDE Help Center. This package of tools help in process of POT and PO files handling.
Help Report Bug... 	 This will open KDE standard error reporting dialog. It's useful if you experience abnormal behavior of KBabel. KBabel developer will be glad to receive any comments, wishes and bug reports.
Help About KBabel... 	 Open message box which inform you about KBabel's version, developer name and e-mail address.
Help About KDE... 	 Open message box which inform you about KDE project, contact information and how you can report bugs and whishes.
Help About Dictionary KDE Database Search Engine 	 Show up an message box with information about people who made KDE Database Search Engine.
Help About Dictionary PO Auxiliary 	 Show up an message box with information about people who made searching in auxiliary file.
Help About Dictionary PO Compendium 	 Show up an message box with information about people who made searching in compendium file.

The KBabel toolbars

Standard Toolbar
Open 	 Load PO-file in KBabel for editing.
Save 	 Save current PO-file if it's modified.
Undo 	 Undo last operation.
Redo 	 Redo last operation.
Cut 	 Cut selected text and move it in clipboard.
Copy 	 Copy selected text in clipboard.
Paste 	 Paste text from clipboard at current cursor position.
Find 	 Find specified string in current PO-file.
Previous 	 Skip to previous entry in PO-file.
Next 	 Skip to next entry in PO-file.
Copy msgid to msgstr 	 Copy original string to translated string edit box.
Search Translations 	 Drop down toolbar for searching selected text using: KDE Database Search Engine, PO auxiliary file, PO compendium file and others dictionary plugins if available.
Stop 	 Stop current searching in progress.
Catalog Manager 	 Open Catalog Manager window.

Navigation Toolbar
Previous 	 Skip to previous entry in PO-file.
Next 	 Skip to next entry in PO-file.
First Entry 	 Jump to first entry in PO-file.
Last Entry 	 Jump to last entry in PO-file.
Previous fuzzy or untranslated 	 Jump to previous fuzzy or untranslated entry in PO-file.
Next fuzzy or untranslated 	 Jump to next fuzzy or untranslated entry in PO-file.
Previous fuzzy 	 Jump to previous fuzzy entry in PO-file.
Next fuzzy 	 Jump to next fuzzy entry in PO-file.
Previous untranslated 	 Jump to previous untranslated entry in PO-file.
Next untranslated 	 Jump to next untranslated entry in PO-file.
Previous error 	 Jump to previous error in PO-file.
Next error 	 Jump to next error in PO-file.
Back 	 Jump to last visited entry in PO-file.
Forward 	 Jump to previous visited entry in PO-file.

Status Bar
Current 	 Current message in edited PO-file.
Total 	 Total number of messages in PO-file.
Fuzzy 	 Number of messages marked as fuzzy. They should be revised and translated if needed.
Untranslated 	 Number of yet untranslated messages.
Editor status 	 INS - insert, and OVR - overwrite. Same meaning like in every ordinary text editor.
PO-file status 	 RO - read-only file, RW - read-write access on file. When file is read-only you cannot modify entries in editor.
Progress bar 	 Usualy, this bar is hidden. It is displayed only when saving is done or you search messages in PO-file, compendium or else.