Open Source Library, Converting Misspelled English characters into Korean letters (& vice versa)

• 영타를 한글로 쳤을 때, 혹은 한타를 영어로 변환해주는 기능을 가진 자바스크립트 오픈소스 라이브러리입니다.
• Inko Offical Website has been launched!
• Inko 한영타변환기 Chrome Extension has been launched! (2019.03.25)
• inko.py has been launched! (2020.04.29) (Thanks to JackCme)
• inko.kt has been launched! (2020.07.19) (Thanks to kimcore)

Available on npm and jsDelivr.

• Fix package loading in Node.js, bundlers, and Vitest.
• Correct standalone compound-consonant conversion and keep conversion methods working when used as callbacks.
• Fix TypeScript declarations and strict-mode Web Worker support.
• Remove runtime dependencies and refresh the build tools and CI checks.

See CHANGELOG.md for the full list of fixes. The default two-set keyboard mapping is unchanged.

Install or upgrade to 1.1.2 using your package manager.

npm install inko@1.1.2

yarn add inko@1.1.2

CDN

<script src="https://cdn.jsdelivr.net/npm/inko@1.1.2/inko.min.js"></script>

Bower

bower install inko

var Inko = require('inko');
var inko = new Inko();

// ES6
import Inko from 'inko';
let inko = new Inko();

inko.en2ko('dkssudgktpdy tptkd!');
// 안녕하세요 세상!

inko.ko2en('ㅗ디ㅣㅐ 재깅!');
// hello world!

// allowDoubleConsonant의 기본값은 false입니다
var option = {
  allowDoubleConsonant: true,
};

1. 인스턴스 생성할 때 생성자의 인자로 설정 부여

var inko = new Inko(option);

2. config 함수로 설정 부여

inko.config(option);

3. en2ko 함수의 인자로 설정 부여

inko.en2ko('rtrt', option);
// output: ㄳㄳ
inko.en2ko('rtrt', { allowDoubleConsonant: false });
// output: ㄱㅅㄱㅅ

The package includes type declarations for CommonJS and ES module consumers.

import Inko, { type InkoOption } from 'inko';

const options: InkoOption = { allowDoubleConsonant: true };
const inko = new Inko(options);

For CommonJS TypeScript projects without esModuleInterop, use import Inko = require('inko').

Conversion methods keep their instance configuration when used as callbacks:

const { ko2en } = new Inko();
['안녕', 'ㄻㄳ'].map(ko2en); // ['dkssud', 'fart']

Inko converts the standard Korean two-set (두벌식) keyboard layout. Three-set (세벌식) support is tracked in #11.

Shifted consonants retain their original key mapping: ㅉㅈ. becomes Ww.. Inko does not guess whether the intended text was www.; that enhancement is tracked in #23.

Use Node.js 22 or newer and npm to work on the library:

npm ci
npm run verify

verify runs conversion tests, rebuilds the browser bundle, and checks the packed npm artifact with CommonJS, ES modules, TypeScript, browser, AMD, and Web Worker consumers. The runtime library has no dependencies.

See the release guide for publishing instructions.

• inko-cli - Use inko on the command line
• inko-web - Inko official website
• inko-chrome-extension - Inko chrome extension
• alfred-inko - Alfred 3 workflow to convert misspelled English characters into Korean letters (& vice versa)
• inko.py - Python implementation of inko.js
• inko.kt - Kotlin implementation of inko.js (Also works in Java)

738 (Jon Jee)	algoshipda	ahnsv	hyoungsp	joonghyeob-shin

이 오픈소스 프로젝트에 누구나 기여할 수 있습니다. 기여하고 싶은 분들은 이 레포지토리를 포크한 후 풀리퀘스트 요청해주세요!

Inko.js is released under the MIT License. See LICENSE file for details.