Repository navigation
또렷 v0.2.0
또렷 0.2.0입니다. 쪽마다 구성 요소의 이름과 자리를 묻는 기능과, HWPX의 짧은 글 한 군데를 서식 그대로 바꾸는 기능을 더했습니다.
새로 된 것
- 구성 요소 질의.
render_with_components와to_pdf_with_components가 쪽마다 문단·표·칸·개체·머리말 같은 구성 요소의 종류, 이름, 자리(pt)를 돌려줍니다. 기존render,to_pdf의 출력은 그대로입니다. - HWPX 짧은 글 바꾸기.
hwp_core::hwpx::edit의find_text,replace_text로 HWPX의 짧은 글 한 군데를 바꿔 새 HWPX로 씁니다. 글자·문단 속성과 줄 간격은 건드리지 않습니다. 같은 글이 여러 군데면 바꾸지 않고 알리며, 여러 서식에 걸친 글, 암호 문서, 변경 추적이 있는 문서, 이진 HWP는 거절합니다. - MCP
replace_text도구. 원본은 고치지 않고 확장자가.hwpx인 새 파일만 만듭니다.
받는 법
또렷은 창이 뜨는 앱이 아닙니다. 터미널에서 쓰는 명령줄 도구 ttoryeot와, Claude Desktop·Claude Code 같은 AI 도구가 부르는 MCP 서버 ttoryeot-mcp입니다. 운영체제에 맞는 파일 하나를 받으세요. 어느 파일에나 두 실행 파일이 함께 들어 있습니다.
Windows 10·11 (64비트)
- 설치 파일(권장): ttoryeot-v0.2.0-windows-x64-setup.exe
관리자 권한 없이%LOCALAPPDATA%\Programs\ttoryeot에 설치하고, 그 폴더를 사용자Path에 더합니다. 설치한 뒤 새로 연 명령 프롬프트나 PowerShell에서ttoryeot --help를 입력하세요. 지울 때는 설정 › 앱 › 설치된 앱에서또렷 (ttoryeot)을 제거합니다. - 휴대용 zip: ttoryeot-v0.2.0-windows-x64.zip
설치하지 않고 원하는 폴더에 풀어서 씁니다. - Windows 코드 서명을 하지 않았습니다. 그래서 처음 실행할 때 SmartScreen이 "Windows의 PC 보호" 창을 띄울 수 있습니다. 해시를 확인했다면 추가 정보 → 실행을 누르세요. PowerShell에서는
Get-FileHash <파일> -Algorithm SHA256으로 해시를 봅니다.
macOS
- Apple 실리콘(M1 이후): ttoryeot-v0.2.0-macos-apple-silicon.tar.gz
- Intel: ttoryeot-v0.2.0-macos-intel.tar.gz
- 어느 쪽인지는 Apple 메뉴 › 이 Mac에 관하여에서 확인합니다. "칩"이 Apple M1·M2 같은 이름이면 Apple 실리콘이고, "프로세서"가 Intel이면 Intel입니다. 터미널에서
uname -m을 입력해arm64가 나오면 Apple 실리콘,x86_64가 나오면 Intel입니다. - 207 Studio Developer ID(팀 H32W23F7UW)로 서명했고 Apple 공증을 받았습니다. 압축을 풀고 두 실행 파일을
/usr/local/bin처럼PATH에 있는 폴더로 옮기세요.
Linux
- x86_64(glibc 2.17 이상): ttoryeot-v0.2.0-linux-x64.tar.gz
대부분의 배포판에서 돌아갑니다. Arm Linux용 파일은 아직 없으니 소스에서 설치하세요.
확인과 그 밖의 방법
- 해시. SHA256SUMS로 받은 파일을 확인하세요.
- 파일 이름. 처음 올린 0.2.0 파일은
aarch64-apple-darwin같은 대상 이름을 썼습니다. 지금은 운영체제 이름으로 바꿨고, 안의 실행 파일은 그때와 같습니다. - 소스.
git clone https://github.com/207studio-oss/ttoryeot뒤cargo install --path ttoryeot-cli --locked,cargo install --path ttoryeot-mcp --locked로 설치합니다. - crates.io. 아직 올리지 않았습니다.
라이선스
- 엔진 라이브러리(
ttoryeot-hwp-core,ttoryeot)는 AGPL-3.0-only 또는 또렷 상용 라이선스 중 선택입니다. 상용 라이선스 일부 조항은 아직 확정 전이고, 구매 창구는 아직 열리지 않았습니다. - CLI와 MCP 서버는 AGPL-3.0-only입니다. 할당자와 krilla는 MIT OR Apache-2.0입니다.
- 자세한 내용은 LICENSING.md를 보세요.
변경 내용은 CHANGELOG.md에 있습니다.