Skip to content

Conversation

@jk-kim0
Copy link
Contributor

@jk-kim0 jk-kim0 commented Jan 23, 2026

Summary

한국어 MDX 문서의 구조적 변경사항을 영어/일본어 문서에 동기화하는 도구를 추가합니다.

추가된 도구

  1. sync_ko_commit.py: 한국어 커밋의 변경사항을 영어/일본어 파일에 덮어쓰기
  2. restore_alt_from_diff.py: git diff에서 기존 영어/일본어 alt 텍스트 복원

워크플로우

한국어 커밋 분석 → 영어/일본어에 덮어쓰기 → git diff로 번역 대상 식별 → 기존 번역 복원 → LLM 번역

사용 예시

cd confluence-mdx

# 1. 한국어 커밋 변경을 en/ja에 동기화
python3 bin/sync_ko_commit.py ae93da7e

# 2. 기존 alt 텍스트 복원
python3 bin/restore_alt_from_diff.py --apply

# 3. 검증
python3 bin/mdx_to_skeleton.py --recursive --max-diff=10

문서

  • Claude skill 추가: .claude/skills/sync-ko-to-en-ja.md

Related tickets & links

Added/updated tests?

  • Yes
  • No, and this is why: CLI 도구로 수동 검증 완료
  • I need help with writing tests

🤖 Generated with Claude Code

- sync_ko_commit.py: 한국어 MDX commit의 변경사항을 영어/일본어 파일에 동기화
- 워크플로우: commit 분석 → 라인 덮어쓰기 → git diff 생성 → LLM 번역
- 한국어 변경 라인을 영어/일본어 파일의 같은 위치에 복사
- git diff를 통해 번역이 필요한 부분 식별 (마커 불필요)
- dry-run 모드로 미리보기 지원

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Jan 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
querypie-docs Ready Ready Preview, Comment Jan 23, 2026 6:11pm

Request Review

@jk-kim0 jk-kim0 changed the title feat(confluence-mdx): 한국어 commit 변경사항을 영어/일본어에 동기화하는 도구를 추가합니다 feat(confluence-mdx): 한국어 commit 변경사항을 영어/일본어에 동기화하는 도구를 추가 Jan 23, 2026
@jk-kim0 jk-kim0 changed the title feat(confluence-mdx): 한국어 commit 변경사항을 영어/일본어에 동기화하는 도구를 추가 feat(confluence-mdx): 한국어 commit 변경사항을 영어/일본어에 동기화하는 도구 Jan 23, 2026
@jk-kim0 jk-kim0 changed the title feat(confluence-mdx): 한국어 commit 변경사항을 영어/일본어에 동기화하는 도구 feat: 한국어 commit 변경사항을 영어/일본어에 동기화하는 도구 Jan 23, 2026
@jk-kim0 jk-kim0 self-assigned this Jan 23, 2026
- restore_alt_from_diff.py: 한국어 덮어쓰기 후 기존 영어/일본어 alt 텍스트 복원
- sync_ko_commit.py와 함께 사용하여 번역 텍스트 보존

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jk-kim0 jk-kim0 changed the title feat: 한국어 commit 변경사항을 영어/일본어에 동기화하는 도구 feat(confluence-mdx): 한국어 commit 변경사항을 영어/일본어에 동기화하는 도구를 추가합니다 Jan 23, 2026
@jk-kim0 jk-kim0 changed the title feat(confluence-mdx): 한국어 commit 변경사항을 영어/일본어에 동기화하는 도구를 추가합니다 feat: 한국어 MDX 변경사항을 영어/일본어에 동기화하는 도구 추가 Jan 23, 2026
fix whitespaces by claude
- sync_ko_commit.py와 restore_alt_from_diff.py 사용법 문서화
- 전체 워크플로우 및 예시 포함

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jk-kim0 jk-kim0 merged commit ee329f5 into main Jan 24, 2026
6 checks passed
@jk-kim0 jk-kim0 deleted the jk/sync-ko-commit-tool branch January 24, 2026 03:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants