紹介

Gukhanmun은 韓國語 텍스트를 爲한 漢字-한글 變換器입니다. 한글과 漢字가 함께 섞인 國漢文混用體 入力을 받으면, 한글 專用 出力이나 倂記된 出力을 純粹 텍스트, Markdown, HTML(<ruby> 마크업 包含) 等 여러 形式으로 生成합니다.

이 變換器는 《標準國語大辭典》을 바탕으로 하며, 南韓(ko-KR)과 北朝鮮(ko-KP)의 正書法 프리셋, 設定 可能한 分割, 數詞 處理, 同音異義 區別, 文字別 倂記 指示를 支援합니다.

境界面 選擇

境界面쓰임새
CLI터미널이나 셸 파이프라인에서 파일을 變換할 때
Rust變換器를 Rust 應用 프로그램이나 라이브러리에 內藏할 때
JavaScriptNode.js·Deno·Bun이나 브라우저에서 使用할 때

CLI

gukhanmun 命令줄 道具는 파일이나 標準 入力에서 읽어 標準 出力이나 파일로 씁니다. 파일 擴張子(.html, .md)로부터 形式을 自動 感知하며, 모든 變換 옵션을 플래그로 支援합니다.

여기서부터 始作하면 됩니다: 〈設置〉.

Rust

gukhanmun 크레이트는 Builder/Converter API를 提供합니다. 變換器를 한 番 만들어 여러 呼出에 걸쳐 再使用하고, 必要하면 出力을 토큰 單位로 스트리밍할 수 있습니다. 피처 플래그로 HTML·Markdown·內藏 辭典을 꺼서 바이너리 크기를 줄일 수 있습니다.

여기서부터 始作하면 됩니다: 〈設置〉.

JavaScript

두 패키지가 各各 다른 環境을 다룹니다:

  • @gukhanmun/wasm은 WebAssembly를 通하여 어떤 JavaScript 런타임에서도 動作합니다. 브라우저, 서버리스 函數, 또는 네이티브 애드온을 쓸 수 없는 어디서든 使用합니다.
  • @gukhanmun/napi는 處理量이 더 높은 네이티브 Node.js 애드온입니다. Node.js 20 以上, Deno 2.0 以上, Bun 1.0 以上을 支援합니다.

둘은 같은 load() API를 共有하며 同一한 옵션을 받습니다.

여기서부터 始作하면 됩니다: 〈設置〉.