9front ktrans 한글 입력 고치기

작성, 수정

English: Fixing Korean input in 9front ktrans

9front의 입력기인 ktrans에는 한국어 모드가 있다. 있기는 했다만, 망가진 채 방치되어 있어서 제대로 쓸 수 없었다. hangul.map을 새로 만들고 두벌식 입력에 맞는 조회 코드를 작성하여 2024년 4월 9front에 패치를 넣었다.

수정 전

ktrans(1) 매뉴얼에는 한국어 입력에 대해 아래와 같은 설명이 있었다.

Mapping is done by emulating a Dubeolsik layout, with each Latin
character mapping to a single Jamo. Sequences of up to three Jamo
are automatically converted to Hangul syllables.

두벌식 자판을 흉내 내며 자모가 세 개까지 모이면 자동으로 음절로 변환된다고 한다. 실제로 입력해 보면 gksrmf(한글)은 입력되지만 rk(가)는 rk 그대로 남고, tkfkd(사랑)은 살ㅏd가 된다. zhem(코드)도 입력할 수 없었다. 자음 하나(r)가 입력되지 않았지만, 모음 하나(k, ㅏ)는 입력이 가능했다.

우선 /lib/ktrans/hangul.map 파일부터 두벌식이 아니었다. hangul.map은 한 줄에 키 TAB 글자를 적어 둔 표다. 유니코드 한글 음절 11,172자 중 완성형(KS X 1001) 2,350자만 들어 있었고, 그마저도 겹모음과 겹받침에 때 아닌 Shift 키가 배정되어 있었다. 두벌식에서 '과'는 rhk지만 수정 전 파일에는 이렇게 적혀 있었다.

rK	과
rH	괘
rL	괴

파일의 줄 순서 또한 문제였다. ktrans는 map 파일을 위에서부터 읽으면서 각 키의 앞부분을 '아직 출력하지 않고 다음 키를 기다리는 항목'으로 덮어쓰며 동작한다. 수정 전 파일은 짧은 키부터 등록되어 있었다. 앞에서 rk 가를 등록해도 뒤에 나오는 rkr 각이 rk를 미출력 항목으로 덮어쓰게 된다. 받침 없는 음절 대부분과 단일 자음이 이러한 방식으로 지워졌다. 모음으로 시작하는 음절은 없으니 단일 모음만 살아남은 것이다. 일본어나 중국어 모드에는 현재 입력을 수동으로 변환하는 ctl-\가 있지만 한국어 모드에는 연결되어 있지 않았다.

설령 map 파일이 정상이었다 해도 조회(lookup) 코드가 한글을 처리할 수 없었다. 한국어 전용 코드 없이 일본어와 동일한 공용 코드를 쓰고 있었다. 공용 코드는 입력된 키를 모아 두었다가 더 이어질 수 있는 키가 없을 때에만 글자를 확정한다. 받침이 다음 음절의 초성으로 넘어가는 동작은 없다. tkfkd(사랑)을 치면 tkf에서 더 이어질 키가 없으니 '살'로 끝나고, 뒤의 k와 d는 흩어지는 셈이다.

새 map

유니코드 한글 음절 11,172자는 0xAC00('가')부터 초성 19개, 중성 21개, 종성 28개(받침 없음 포함) 순서로 배열되어 있다.

genmap.go를 작성하여 각 음절의 초성, 중성, 종성 번호를 구하고 대응하는 두벌식 로마자 키를 이어 붙였다. 겹모음과 겹받침 또한 두벌식 그대로 두 키를 쓴다. ㅘ는 hk, ㄺ은 fr이다.

	for r := 0xAC00; r <= 0xD7A3; r++ {
		cho := choseong[(r-0xAC00)/(28*21)]
		jung := jungseong[(r-0xAC00)/28%21]
		jong := jongseong[(r-0xAC00)%28]
		if jong == "" {
			fmt.Printf("%s%s	%c\n", cho, jung, r)
		} else {
			fmt.Printf("%s%s%s	%c\n", cho, jung, jong, r)
		}
	}

음절 11,172줄 뒤에 낱자 입력을 위한 초성 19줄, 중성 21줄을 더해 총 11,212줄을 생성했다.

ktrans가 map을 읽을 때 긴 키가 짧은 키의 출력을 지우지 않으려면 긴 키가 먼저 등장해야 한다. 로마자 키의 길이 역순으로 정렬하여 hangul.map을 만들었다.

go run genmap.go | awk '{printf "%d%s\n", length($1), $0}' | sort -nr | sed 's/^[0-9]//' > hangul.map

이렇게 정렬하면 rkr 각을 먼저 읽고 나중에 rk 가를 읽게 되어, rk가 '가'라는 출력을 유지한 채 다음 입력을 기다릴 수 있다.

조회 코드

새 map에서는 z(ㅋ), zh(코), zhe(콛)처럼 키의 앞부분도 모두 글자에 대응한다. 기존 공용 코드는 키를 입력할 때마다 화면에 로마자를 먼저 내보내고, 일치하는 항목이 있으면 지금까지 모은 키 개수만큼 백스페이스를 보내 지운 뒤 변환된 글자를 출력한다. 앞부분이 이미 한 글자로 합쳐져 화면에 출력되어 있으면 백스페이스가 과하게 전달되어 앞 글자까지 지우게 된다.

한글 입력을 위해 키 입력을 처리하는 dubeollkup과 백스페이스를 처리하는 dubeolbksp를 별도로 작성했다. 조합 중인 한 음절의 키만 line 버퍼에 유지한다.

키를 하나 입력하면 화면 끝에는 조합 중이던 음절과 방금 입력한 영문 키 하나가 출력된 상태가 된다. line에 키가 하나뿐이면 방금 입력한 키만 지우면 되고(백스페이스 1번), 조합 중이던 음절이 있으면 그 음절과 방금 입력한 키 두 글자를 지우면 된다(백스페이스 2번).

새 키가 붙은 line을 받은 dubeollkup은 먼저 line 전체가 map에 있는지 찾는다. z(ㅋ)에서 zh(코), zhe(콛)로 이어질 때처럼 line 전체가 map에 있으면 백스페이스를 보내고 새 음절을 출력한다.

line 전체는 map에 없지만 마지막 두 키(buf)가 map에 있다면, 앞 음절의 받침이 새 음절의 초성으로 넘어가는 경우다. zhe(콛) 상태에서 m(ㅡ)을 입력하면 zhem은 없지만 em(드)은 있다. 이때는 line에서 마지막 두 키를 빼내어 앞 음절을 받침이 빠진 글자(zh, 코)로 다시 출력하고, 그 뒤에 새 음절(em, 드)을 출력한다. line에는 em만 남긴다. 겹받침 또한 같은 방식으로 분리된다. rkfr(갉) 뒤에 k(ㅏ)를 입력하면 rk가 넘어가 '갈가'가 된다.

둘 다 해당하지 않으면 이전 음절의 조합이 끝난 것이므로 새 키 하나로 line을 다시 시작한다.

	if(hmapget(hangul, line->b, &lkup) < 0){
		if(hmapget(hangul, buf, &lkup) < 0){
			resetstr(line, nil);
			line->p = pushutf(line->p, strend(line), e1, utflen(e1));
			if(hmapget(hangul, line->b, &lkup) < 0)
				return;
		}else{
			/* treat Jongseong as Choseong when it matches with new Jamo */
			popstr(line);
			popstr(line);
			hmapget(hangul, line->b, &lkup);
			emitutf(output, backspace, 2);
			emitutf(output, lkup.kana, 0);

			hmapget(hangul, buf, &lkup);
			emitutf(output, lkup.kana, 0);
			line->p = pushutf(line->b, strend(line), buf, utflen(buf));
			return;
		}
	}
	if(utflen(line->b) == 1)
		emitutf(output, backspace, 1);
	else
		emitutf(output, backspace, 2);
	emitutf(output, lkup.kana, 0);

백스페이스 또한 다른 키처럼 화면에 먼저 전달되어 마지막 글자를 지운다. 그 뒤 호출되는 dubeolbksp는 line에서 마지막 키 하나를 빼고, 남은 키에 해당하는 글자를 다시 화면에 출력한다.

static void
dubeolbksp(Str *line)
{
	Map lkup;

	popstr(line);
	/* lookup and emit remaining Jamo to output */
	if(hmapget(hangul, line->b, &lkup) < 0)
		return;
	emitutf(output, lkup.kana, 0);
}

'코드'까지 입력한 상태에서 백스페이스를 누르면 화면의 '드'가 지워지고, line은 em에서 e가 되어 화면에 다시 'ㄷ'이 출력된다. 이어서 k를 입력하면 '코다'가 된다. 이미 조합이 끝난 앞 글자들은 line에 남아 있지 않으니 백스페이스 한 번에 한 음절씩 지워진다.

test.c에는 받침 넘기기와 백스페이스를 확인하는 테스트를 추가했다. \b는 백스페이스다.

gpffhdnjfemsms wlruqwksw\bgdk, wha tlstjsgks rj djqtdj?
헬로월드는 지겹잖아, 좀 신선한 거 없어?

wksw까지 입력하면 '잕'이 되고, 백스페이스로 '잔'으로 되돌린 뒤 g를 입력하여 '잖'을 만든다.

패치 반영과 사용법

2024년 3월 24일 9front 메일링 리스트에 패치를 보냈고(메일 스레드), 4월 2일 커밋되었다(68512a3f6). 같은 달 나온 9front-10522 릴리스부터 반영되어 있다.

rio 창에서 아래와 같이 실행한다.

ktrans /dev/kbdtap

ctl-s를 누르면 한국어 입력, ctl-t를 누르면 영문 입력으로 전환된다. 처음부터 한국어로 시작하려면 -l ko 플래그를 준다. ㄲ, ㄸ, ㅃ, ㅆ, ㅉ, ㅒ, ㅖ를 제외한 모든 자모는 Shift 없이 두벌식 그대로 입력한다.