• 한국어 (한글)
    • Rust
    JSR

      소개

      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를 공유하며 동일한 옵션을 받습니다.

      여기서부터 시작하면 됩니다: 〈설치〉.