bryce/mediawiki-extensions-UniversalLanguageSelector
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update jquery.ime to 7edcc7b from upstream

Browse Source 
Changes:
* Added IMEs for Eritrean languages: Tigrinya (ti), Tigre (tig),
  Blin (byn).
* Documentation updates.

Change-Id: Iec9e45711308d0b7a4670c64d3c2c9ae6debd0d9
This commit is contained in:
Kartik Mistry
2017-02-17 17:21:48 +05:30
parent aff7087e8f
commit d3106d5d57
5 changed files with 1320 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

64
lib/jquery.ime/rules/README.md
View File

@@ -1,33 +1,42 @@
<!-- markdownlint-disable MD010 -->
jQuery.ime Input method specification
=====================================
Input methods are defined in javascript files. An input method is a javascript
object and it is passed to $.ime.register() method to register with jquery.ime
object and it is passed to `$.ime.register()` method to register with `jquery.ime`
eg: $.ime.register( hebrewStandardKeyboard );
eg: `$.ime.register( hebrewStandardKeyboard );`
Input methods can be built by reusing parts of other methods, this is especially
interesting for complex patterns. If rules are reused then the methods must be
loaded first. This is done through configurations in `jquery.ime.inputmethods.js`.
For examples on reuse, see the rules "nb-normforms" or "hi-inscript".
Metadata fields
---------------
id: A mandatory unique identifier that represents the input method.
eg: "hindi-inscript"
eg: `"hindi-inscript"`
name: A mandatory short name for the input method. eg: Hindi InScript
name: A mandatory short name for the input method. eg: `"Hindi InScript"`
Note that the names used in the menu comes from [jquery.ime.inputmethods.js](../src/jquery.ime.inputmethods.js)
description: An optional short description about the input method.
eg: "keyboard layout as per inscript standard"
eg: `"keyboard layout as per inscript standard"`
date: An optional string to represent when this input method was written.
Format should be: yyyy-mm-dd
author: An optional string containing the authors name. Can contain email
address as well. eg: "Santhosh Thottingal, <santhosh.thottingal@gmail.com>"
address as well. eg: `"Santhosh Thottingal, <santhosh.thottingal@gmail.com>"`
URL: A mandatory string containing URL for source where keyboard is defined,
information about trademark restrictions if any, layout and help.
license: An optional string containing licence information. Eg: "CC-BY-SA" or
"GPLv3".
license: An optional string containing licence information. Eg: `"CC-BY-SA"` or
`"GPLv3"`.
version: An optional string containing version information.
@@ -38,6 +47,8 @@ patterns: A regular expression table that maps the original inputs to the
target language.
eg:
```javascript
patterns: [
[ 'q', '/' ],
[ 'w', '\'' ],
@@ -49,37 +60,55 @@ patterns: [
[ 'i', 'ן' ],
[ 'o', 'ם' ],
[ 'p', 'פ' ]
...
// ...
// These characters are mirrored in RTL languages
[ '\\(', ')' ],
[ '\\)', '(' ],
[ '\\[', ']' ],
[ '\\]', '[' ]
]
```
Any valid regular expression is possible as first element of each array item.
More examples
[ '([ക-ഹ])a', '$1ാ' ]
[ '(([ൺ-ൿം])\u200c+)?I', '$2ഐ' ]
ex: `[ '([ക-ഹ])a', '$1ാ' ]`
ex: `[ '(([ൺ-ൿം])\u200c+)?I', '$2ഐ' ]`
In the above example, $1, $1 etc are according to the normal regular expression
replace syntax.
The second member of pattern can be a function as well. For eg:
The second member of the pattern can be a function as well.
eg:
```javascript
patterns: [ [ '[a-z]', function ( $1 ) {
return $1.toUpperCase();
} ] ]
```
This rule replace all key strokes to its upper case character.
contextLength: Length of the context to remember. jquery.ime can replace the
text based on the previously typed characters. eg:
patterns_x: Defined the same way as ordinary patterns, but active while holding down the alt key or
alt graph key. When active the normal patterns will be excluded. These two modifier keys can be
handled differently on various hardware. It might be necessary to define ordinary patterns in
addition to patterns_x to catch all cases.
patterns_shift: Defined the same way as ordinary patterns, but active while holding down the shift
key. When active the normal patterns will still be run, but only after the rules listed in
patterns_shift is run.
contextLength: Length of the context to remember. jquery.ime can replace the
text based on the previously typed characters.
eg:
```javascript
[ 'ൿh', 'c', 'ച്' ]
```
Note that this pattern definition has 3 members, the middle one is the context.
This rule is interpreted as
This rule is interpreted as as an override to pattern definitions with 2 members.
The current key is h, previous key is c. For the previous key press c, we have
a transliteration ൿ. But if it is followed by h and ൿ is indeed from key press
@@ -105,4 +134,5 @@ Examples
For complete examples, please refer the existing input method definitions.
Documentation of input methods are available at https://www.mediawiki.org/wiki/Help:Extension:UniversalLanguageSelector/Input_methods
Documentation of input methods are available at
[mw:Help:Extension:UniversalLanguageSelector/Input methods](https://www.mediawiki.org/wiki/Help:Extension:UniversalLanguageSelector/Input_methods)