Knayi Myanmar Script

Standalone Myanmar languages js library, to build Myanmar Unicode standard web.

Announce on breaking API changes from 2.4.2 -> 2.5.0

• All throw Error are now become console.warn and console.error
• If content not found happens, #fontConvert, #spellingCheck, #syllBreak all return empty string
• If content not found happens, #fontDetect return fallback_font_type or 'en'
• You can set silent by setting knayi.setGlobalOptions({silent_mode: true})

Node Version

• Required node version >= 4
  Note: From version >=2.3.0 build step will only support for node >=6

Features

• Detector (Unicode and Zawgyi) Detection now
• Converter (Unicode and Zawgyi)
• SyallBreak (Unicode and Zawgyi)
• Spelling Check (Unicode and Zawgyi)
• Truncate (Unicode and Zawgyi)
• Normalization (Unicode only)

Installation

Using npm

npm install knayi-myscript --save

Using yarn

yarn add knayi-myscript

Using CDN

<script src="https://unpkg.com/[email protected]/dist/knayi-myscript.min.js"></script>

API

Usage

// ES5 Way
var knayi = require('knayi-myscript')

// ES6 Way
import knayi from 'knayi-myscript'

Example

• fontDetect(content [, fallbackFontType [, options]])

knayi.fontDetect('မဂၤလာပါ') // zawgyi
knayi.fontDetect('မင်္ဂလာပါ') // unicode

• fontConvert(content, targetFontType [, orignalFontType])

knayi.fontConvert('မဂၤလာပါ', 'unicode', 'zawgyi') // မင်္ဂလာပါ
knayi.fontConvert('မဂၤလာပါ', 'unicode') // မင်္ဂလာပါ

• syllBreak(content [, fontType [, breakWord]])

knayi.syllBreak('မင်္ဂလာပါ', null, '$$')
// output: 'မင်္ဂလာ$$ပါ'
knayi.syllBreak('မင်္ဂလာပါ')
// output: 'မင်္ဂလာ\u200bပါ'

• spellingFix(content [, fontType])

knayi.spellingFix('မင်္ဂလာာပါါ') 
// output: 'မင်္ဂလာပါ'

• truncate(content [, options])

knayi.truncate('အာယုဝဍ်ဎနဆေးညွှန်းစာကို ဇလွန်ဈေးဘေးဗာဒံပင်ထက် အဓိဋ္ဌာန်လျက် ဂဃနဏဖတ်ခဲ့သည်။', { length: 30, omission: '...' });
// output: "အာယုဝဍ်ဎနဆေးညွှန်းစာကို ဈေး..."

options of truncate

• length: Number default is 30

• omission:String default is '...'

• fontType: String it automatically detect if it not specified

• normalize(content)

knayi.normalize('မိြုင်မိြုင်\nဆိုင်ဆုိင်')
// output: မြိုင်မြိုင်\nဆိုင်ဆိုင်

Using googlei18n/myanmartools in detector.js

In default, knayi use own logic font dector rules, but you can choose knayi to use googlei18n/myanmartoolsTo do that, setuse_myanmartoolsoption to true. By defaultuse_myanmartoolsoption is set tofalse`.

Example::

// Add options for single process
knayi.fontDetect('မဂၤလာပါ', null, {use_myanmartools: true}) // this will use myanmartools
knayi.fontDetect('မင်္ဂလာပါ') // this will use default

// OR set for whole project
knayi.setGlobalOptions({
  detector: {
    use_myanmartools: true
  }
})

You can also set Probability threshold percentages of zawgyi predicting by myanmartools_zg_threshold as [lower, higher]. Which mean if predicting result of myanmartools is < 0.05 detector.js assume as unicode or > 0.95 it assume as zawgyi.

knayi.fontDetect('မင်္ဂလာပါ', null, {
  use_myanmartools: true,
  myanmartools_zg_threshold: [0.05, 0.95]
})

Debugging of font converting

Visit http://tools.kny.co/knayi-myscript#debug-mode and select text to track how converting happened in background.

Build

• Required node >=6
• npm run build
  To build production run webpack -p

License

MIT