mozdev.org

russkey

resources:

User Manual

Starting with extension version 1.4.5, there is a settings dialog that allows changing shortcut keys.
Starting with extension version 1.4.0, there are some new shortcut keys.
F2 toggles edit mode.
In FireFox Ctrl+Alt+Shift+E - translates Russian to English. Ctrl+Alt+Shift+R - translates English to Russian.
In Thunderbird Ctrl+Shift+E - translates Russian to English. Ctrl+Shift+R - translates English to Russian.
Ctrl+Shift+M - transforms Translit to Cyrillic.

Note for those who downloaded the extension after the 28th of March. In your version the key sequence ctrl-shift-k acts as a shortcut to Russ Key extension functionality. This change will be updated for the rest of the users in the new udpate release.

Typing with Russ Key

Starting from version 0.3 it is possible to switch the current keyboard mapping to a different one through FF preferences found in about:config
The preference that contains the keyboard map is named russkey.KeyboardMap. Refer to the design page for the map format.
This is the default keyboard mapping assumed on installation (underlined values only exist in full default and not in minimalist default mapping):
a - а
b - б
w - в
g - г
d - д
e - е
/ - ё
v - ж
z - з
i - и
j - й
k - к
l - л
m - м
n - н
o - о
p - п
r - р
s - с
t - т
u - у
f - ф
x - х
c - ц
h - ч
[ - ш
] - щ
= - ь
y - ы
' - ъ
\ - э
` - ю
q - я
Once the extension is installed "Russ Key" menu-item is added to the context menu. To type in Russian, simply right-click on the input field (either Text or TextArea) and select "Russ Key". Alternatively if the text cursor is already in the text box in question, you can click on the 'Russ Key' button on the statusbar. You will notice that due to the implementation of the extension, the russian keyboard will sometimes change back to the default keyboard (English.) This means that you have to right click and select "Russ Key" again. If you are interested to find out why that is, you can visit the design page.

Interesting side-effect of having the status bar button is that if you put the text cursor on the address text bar (where the URL is typed) or on the search text bar, you can then click on the status bar 'Russ Key' button to turn the translator on and type in those input text fields in Russian as well.

Starting from version 0.4 Russ Key can be used in ThunderBird to type in any input field including the text editor in the compose window. The scrolling and focusing behaviour in this window is not well controlled so don't get too mad when the window will lose focus as you type. Maybe I will have a solution for that problem once I understand ThunderBird better.

Transforming Translit Into Cyrillic

It is now possible to transform text typed in Latin (English) letters into Cyrillic. To do so, simply select text that needs to be transformed (text can either be inside a text input field or simply static HTML text and select "Russ Key" menu-item from the context menu or click on the 'Russ Key' button on the statusbar.

Be careful, current implementation of the translit-transformer does not preserve the original HTML structure, so when text is translated it may lose its HTML properties. This maybe fixed in later releases.

Switching Keyboard Layout

It is now possible to switch the keyboard layout to a user defined one. Currently it is a manual process that must be followed precisely that maybe made more user-friendly in the future.
  1. Get the new mapping string from this page or make one yourself by following these instructions.
  2. In the URL text area of the browser type about:config and press Enter.
  3. Find a key-value pair named russkey.KeyboardMap, choose to modify the value of this key and paste the new mapping string into it.
  4. Restart the browser.

Switching Transliteration Mapping

It is now possible to switch the transliteration mapping to a user defined one. Currently it is a manual process that must be followed precisely that maybe made more user-friendly in the future.
  1. Get the new mapping string from this page or make one yourself by following these instructions for character code mapping strings and these instructions for regular expression mapping strings.
  2. In the URL text area of the browser type about:config and press Enter.
  3. Find a key-value pair named russkey.TranslitMapCharCodes.1, choose to modify the value of this key and paste the new character code mapping string into it.
  4. Find a key-value pair named russkey.TranslitMapRegExpCodes.1, choose to modify the value of this key and paste the new regular expression mapping string into it.
  5. Restart the browser.

The russkey project can be contacted through the mailing list or the member list.
Copyright © 2000-2017. All rights reserved. Terms of Use & Privacy Policy.