Branch: refs/heads/master Author: Matthew Brush matt@geany.org Committer: Matthew Brush matt@geany.org Date: Sun, 04 May 2014 19:14:31 UTC Commit: f94976495d09d3e2b709a51efd6f83577a7eca45 https://github.com/geany/geany/commit/f94976495d09d3e2b709a51efd6f83577a7eca...
Log Message: ----------- Add more details about menu mnemonics
Modified Paths: -------------- README.I18N
Modified: README.I18N 24 lines changed, 21 insertions(+), 3 deletions(-) =================================================================== @@ -25,9 +25,27 @@ When you have finished editing the file, check the file with:
$ msgfmt -c --check-accelerators=_ it.po
-Please take care of menu accelerators(strings containing a "_"). The "_" -character should also be in your translation. Additionally, it would be nice if -these accelerators are not twice for two strings inside a dialog or sub menu. +Please ensure you also translate the mnemonic letters (strings containing a +"_" before a letter, also called "accelerators" on some platforms/toolkits). +When the user wishes to activate a menu item using their keyboard, they will +use this letter to pick an item from the menu. + +Here are a few notes on picking which letter to use: + +* Always follow platform/toolkit conventions (for example "t" for "Cut") even +if they don't necessarily seem obvious. +* Try to choose the first letter of the command name, where this is the most +appropriate letter (for example "S" for "Save"), assuming it's not already +used in the same menu. +* Try not to use the same character more than once in the same menu as this +will cause the user to have to press the mnemonic's key multiple times to +select the correct menu item. +* If there is no letter in the text that can easily be entered from a keyboard +then choose another character that can be, and put it in parenthesis after the +translated text. +* Try not to change which letter is used whenever possible as it is not +user-configurable and users may have become accustomed to using the existing +mnemonic key.
You can also use intl_stats.sh, e.g. by running the following command in the top source directory of Geany:
-------------- This E-Mail was brought to you by github_commit_mail.py (Source: https://github.com/geany/infrastructure).