하드트랜스 (hdTrans)

일본어를 한국어로 번역하는 오프라인 번역 프로그램입니다. 기본 사전과 번역 엔진이 함께 들어 있어 압축을 풀면 바로 쓸 수 있습니다. Windows 번역 창, 명령줄 프로그램, 이지트랜스용 도구 연결을 제공합니다.

제작자: 소쿠릿 (홈페이지, X)

설치 전에 웹 번역기에서 문장을 번역해 볼 수 있습니다.

원본 ezTrans 열은 공개 비교 글에서 인용했고, hdTrans 열은 아래 벤치마크의 고정 C++ 엔진으로 직접 번역한 결과입니다.

공개 회귀 벤치마크 66문장에서 기대 출력 일치는 0.2.0 소스 빌드의 36/66에서 개선 C++ 엔진의 66/66으로 늘었습니다. 수정 대상 30문장을 고쳤고, 유지 대상 30문장과 위 6개 예시는 같은 출력을 유지했습니다. 수정 사례와 주변 표현을 골라 만든 테스트이며 일반 번역 정확도를 뜻하지 않습니다.

전체 결과, 사전과 규칙 개선 내용, 재현 방법

Windows 번역 창이나 네이티브 엔진을 쓰는 도구에 연결하려면 배포판을 사용합니다.

Releases에서 운영체제에 맞는 파일을 받습니다. Source code가 아니라 아래 배포 파일을 고르세요.

1. 원하는 폴더에 압축을 풉니다. 별도 설치 프로그램이나 소스 빌드는 필요 없습니다.
2. Windows에서는 hdTransGUI.exe를 실행합니다. Linux와 macOS에서는 아래 CLI 사용법을 따릅니다.
3. 다른 도구에 연결하려면 도구별 설치 안내를 보세요.

모든 운영체제에서 실행 파일 옆에 아래 폴더를 둡니다.

hdtrans-data/
  dicts.hdsnap
  dicts.txt
  user/
    hdtrans.config.example.yaml
    userdict.example.txt
  ehnd/
    README.txt
    PreFilter_example.txt
    PostFilter_example.txt
    UserDict_example.txt

dicts.hdsnap은 필수이고, dicts.txt는 사전 버전입니다. user/, 설정 파일과 ehnd/는 선택입니다. 다른 사전은 --dicts PATH, 다른 설정은 --config FILE로 지정합니다. 원본 TSV는 따로 받을 필요가 없습니다.

0.6.2 이하 버전을 쓰던 경우: 사용자 사전, 설정(user/)과 Ehnd 사전을 hdtrans-data/ 아래로 옮겨 주세요.

Node.js 22 이상에서 설치합니다. WASM 엔진과 기본 사전이 패키지에 포함되어 있습니다.

npm install hdtrans

JavaScript와 TypeScript에서 같은 API를 씁니다.

import { HdTrans } from 'hdtrans';

const translator = await HdTrans.init();
try {
  console.log(translator.getInfo()); // 엔진 버전, 사전 버전, 실행 방식
  console.log(translator.translate('今日は本を読みます。'));
} finally {
  translator.close();
}

버전만 확인하려면 await HdTrans.getInfo()를 씁니다. 엔진과 사전을 실제로 로드해 확인하고 임시 인스턴스를 닫습니다. 사용자 사전 등록, JSON 결과와 자세한 사용법은 JavaScript와 TypeScript API를 보세요.

npm으로 명령을 설치할 수 있습니다.

npm install -g hdtrans
hdtrans --version
hdtrans --in input.ja.txt --out output.ko.txt

배포판을 받았다면 터미널에서 압축을 푼 폴더로 이동합니다. 입력 파일 input.ja.txt를 읽어 번역 결과를 output.ko.txt에 저장합니다. 입력과 출력은 UTF-8입니다.

Windows:

.\hdtrans.exe --in input.ja.txt --out output.ko.txt

Linux, macOS:

./hdtrans --in input.ja.txt --out output.ko.txt

기본 사전은 자동으로 읽습니다. 배포판에서 줄마다 독립적으로 번역하려면 --each를 추가합니다. --verbose는 읽은 사전 정보를 표준 오류에 보여 줍니다. --version(-v)과 함께 쓰면 버전 한 줄만 출력합니다. npm CLI와 배포판 CLI 사용법

번역문의 문장 끝을 -다로 둘지 반말(해체)로 쓸지 정합니다. 기본은 strict입니다.

• strict(기본): -다를 그대로 둡니다. 원문에 반말 표지(よ, ね, ！ 등)가 있는 곳만 반말로 씁니다.
• soft: 「」 안의 대사를 반말로 씁니다. 「」가 없는 줄도 대사로 보이면 반말로 씁니다. 지문을 반말로 잘못 바꾸지 않도록 애매한 줄은 -다로 둡니다. 。로 끝나고 반말 표지가 없는 줄, 이름：설명 같은 줄, 대사를 「」로 쓰는 글의 「」 밖 줄이 그렇습니다.

소설과 문서는 strict, 게임 대사나 채팅처럼 짧은 대화는 soft가 잘 맞습니다. CLI는 --speech soft, 설정 파일은 speech: soft, 웹 번역기는 대사 말투에서 고릅니다.

• 한 줄씩(--each, 게임 연결 도구, 줄마다 부르는 API): 앞에서 번역한 줄이 다음 줄 결과를 바꾸지 않습니다. 같은 줄은 언제 넣어도 같은 결과가 나옵니다.
• 문서(CLI 기본, 여러 줄을 한 번에 넣음): 그 안에서만 앞뒤 줄을 참고합니다. 앞에서 확인한 이름을 뒤에서도 같게 읽고, 여러 줄에 걸친 「」를 이어서 읽고, 대사를 「」로 쓰는 글이면 「」 밖의 줄을 지문으로 보고 -다로 둡니다.

같은 두 줄을 soft로 번역하면 둘째 줄이 이렇게 다릅니다.

「そろそろ帰る」と彼は言った。
それは違う

연결 도구에서 무엇이 결과를 바꾸는지는 번역 결과에 영향을 주는 것에 있습니다.

hdTransGUI.exe를 실행하고 위 칸에 일본어를 넣은 뒤 번역하기를 누릅니다. 텍스트 파일은 문서 번역 탭에서 파일을 하나 또는 여러 개 골라(창에 끌어 놓아도 됨) 번역합니다. 결과는 기본으로 원본 파일 옆에 이름_번역.txt로 저장됩니다. 사전 탭에서 사용자 사전을 켜고 끄거나 항목을 고칠 수 있습니다.

Windows 배포판의 네이티브 엔진을 LunaTranslator, 투컨트롤, 아네모네, XUnity.AutoTranslator, 아랄트랜스, VNR 등에 연결할 수 있습니다. 도구에 엔진 경로를 설정하면 원본 이지트랜스를 따로 설치할 필요가 없습니다.

• J2KEngine.dll과 hdtrans-data 폴더를 함께 둡니다.
• 도구에 따라 DLL 파일이나 폴더를 선택합니다. 도구별 설치 안내의 설정을 따르세요.

프로그램 폴더의 hdtrans-data/user/userdict.txt에 작성합니다.

UTF-8로 저장하고 한 줄에 일본어와 한국어를 탭으로 구분해 적습니다.

灯台	등대
山道	산길

userdict-place.txt처럼 userdict로 시작하는 .txt 파일로 나누어도 됩니다. 번역 창과 연결 도구에서는 저장한 내용이 다음 번역부터 반영됩니다. 품사와 자세한 형식은 사용자 사전 안내를 보세요.

hdtrans-data/user/hdtrans.config.example.yaml을 같은 폴더의 hdtrans.config.yaml로 복사해 수정합니다.

꿀도르 같은 Ehnd 사전은 기본으로 꺼져 있습니다. 필요할 때 설정에서 켤 수 있지만 번역 품질이 낮아질 수 있습니다. Ehnd 설정 안내

실행 중인 번역 창과 연결 도구를 끄고 새 버전을 같은 폴더에 덮어 풉니다. 직접 만든 userdict*.txt와 hdtrans.config.yaml은 배포 파일에 없으므로 유지됩니다. *.example.* 견본 파일은 업데이트 때 교체되니 견본을 직접 수정하지 말고 복사해서 쓰세요.

• DLL을 불러오지 못함: 도구에 지정한 경로에 J2KEngine.dll이 있는지 확인합니다.
• 사전을 찾지 못함: DLL이나 실행 파일 옆 hdtrans-data/dicts.hdsnap이 있는지 확인합니다. DLL을 복사할 때 hdtrans-data 폴더도 함께 복사하세요.
• 계속 예전 엔진으로 번역됨: 도구의 엔진 경로를 확인합니다. XUnity는 J2KEngineH.dll을 먼저 읽으므로 기존 파일이 있으면 제거합니다.
• 사용자 사전이 적용되지 않음: 파일 경로와 userdict로 시작하는 이름, UTF-8 인코딩, 항목 사이의 탭을 확인합니다.

이슈에 사용한 버전, 도구 이름, 재현 방법을 적어 주세요.

• 문서 목록: 사용 안내, 빌드와 API
• 오역 고치기: 사전과 번역 규칙 수정
• 기여 안내: PR은 develop 브랜치로 보냅니다.

Copyright (c) Sokcuri (소쿠릿, https://github.com/sokcuri)

MPL-2.0

외부 라이브러리의 라이선스는 THIRD-PARTY-NOTICES.txt에 있습니다.