p5.js 한국어 번역 프로젝트
p5.js 공식 문서와 웹사이트를 한국어로 옮긴 오픈소스 번역 프로젝트
Overview
Processing Foundation이 p5.js 공식 웹사이트를 새로 만들면서 스페인어, 중국어, 한국어, 힌디어 번역을 동시에 진행했습니다. 한국어 팀의 스튜어드로 참여했습니다. 스튜어드 2명과 기여자 5명으로 팀을 꾸렸고, 2024년 3월부터 4월까지 네 차례의 배치로 기여자 문서 5종, 레퍼런스 361건, 웹사이트 카피와 예제 15종을 옮겼습니다.
스튜어드는 재단에서 오는 배치 공지를 팀 과제로 정리해 공유하고, 기여자들이 올린 번역을 1차와 2차로 검토하고, 논의가 필요한 단어를 함께 결정했습니다. 공지 작성과 리뷰 순서는 두 스튜어드가 번갈아 맡았고, 분량이 많은 배치에서는 번역도 나눠 맡았습니다.
Glossary
번역하기 전에 용어부터 정하기
처음에는 기술 문서 번역이라고 생각했습니다. 기여자가 올린 번역을 읽고 크게 이상한 곳이 없으면 되겠다고 여겼습니다. 실제로는 그렇지 않았습니다.
p5.js는 프로그래밍 라이브러리라 용어의 비중이 큽니다. 같은 단어를 사람마다 다르게 옮기면 문서를 읽는 사람이 매번 다시 배워야 합니다.
그래서 번역을 시작하기 전에 두 가지를 먼저 했습니다. 하나는 용어집입니다. 기여자마다 15개 안팎의 단어를 맡아 번역하고, 애매했던 부분을 함께 적어뒀습니다. deprecated를 "더 이상 사용되지 않는다"로 옮길지 "사용하지 않기를 권장한다"로 옮길지, unit testing을 "단위 테스트"로 쓸지 "유닛 테스트"로 쓸지 같은 문제였습니다.
다른 하나는 어조입니다. 기여자 전원이 기여자 가이드라인의 같은 문단을 각자 번역한 뒤 결과를 나란히 놓고 비교했습니다. 존댓말 수준과 문장부호, 원문 병기 방식을 그 자리에서 정했습니다. 번역을 시작한 뒤에 톤을 맞추려 하면 이미 쓴 문서를 전부 다시 봐야 합니다.
Words
단어 하나가 남기는 것
영어 한 단어에 대응하는 한국어는 하나가 아닙니다. 여러 후보 중에서 가장 가까운 것을 고르는 일이고, 그 선택은 되돌리기 어렵습니다. 문서를 읽는 사람 대부분에게는 그 단어가 p5.js를 처음 만나는 말이 됩니다.
Git의 기본 브랜치 이름이 master에서 main으로 바뀐 일이 있습니다. 기술 용어가 특정한 역사를 떠올리게 한다는 이유였습니다. 번역도 같습니다. 옮긴 사람이 이해했다고 끝나는 게 아니라, 그 한국어가 읽는 사람에게 어떤 인상을 남기는지까지 봐야 합니다.
그래서 작업 중에 의문이 생기는 단어는 저장소의 Discussions에 올려 함께 논의했습니다. 이 스레드는 프로젝트가 끝날 때까지 열어뒀습니다. 혼자 판단하지 않고 기록을 남기면서 결정하는 방식이었습니다.
안녕하세요, 기여자님들이 진행해주신 3월 2주차 연습과제와 더불어, 이 파일상 제기된 여러 논의를 토대로 아래의 제안 사항을 작성해봅니다😀 이 문서는 2024년 p5.js 번역 기여 프로젝트 진행 기간 내내 계속해서 업데이트 됩니다! 음차 번역 표기 관련 (last updated: Mar 12 2024) 다음의 경우 ⭐한글(영문) 병기⭐된 음차번역을 ...
https://github.com/p5-js-KO-Translation/2024/discussions/6Review
기준이 다른 사람들과 함께 읽기
프로그래밍 용어는 대부분 영어에서 왔고, 개발자들은 그 영어를 한국어로 바꿔서가 아니라 영어 그대로 익힙니다. 그래서 한국어로 옮기면 오히려 낯설어지는 경우가 생깁니다.
resource를 두고 논의한 적이 있습니다. 한국어에 "자원"이라는 단어가 있지만 실무에서는 대부분 "리소스"라고 표현합니다. 그렇다고 만약 "자원"으로 번역하게되면 참고할 자료라는 의미보다 자연에서 얻을 수 있는 연료 같은 것을 연상시킵니다. 사전적으로 맞는 번역과 실제로 읽히는 번역이 달랐습니다.
저는 한국어로 옮기고 원문을 병기하는 쪽을 택했습니다. 예를 들어, repository를 처음부터 "저장소"로 번역해 써왔다면 지금 그 말이 어색하지 않았을 것이라고 생각합니다. 익숙하지 않다는 이유로 영어를 그대로 두면 시간이 지날수록 프로그래밍 언어는 한글로는 번역할 수 없는 상태가 되어버립니다.
p5.js는 누구나 프로그래밍에 접근할 수 있어야 한다는 생각에서 출발한 라이브러리입니다. 그래서 여느 기술 문서보다 더 신중해야 했습니다. 기여자가 올린 번역을 검토하다 보면 같은 문장을 저와 다르게 옮긴 지점을 자주 만났습니다. 제가 중요하지 않다고 넘긴 설명이 누군가에게는 그렇지 않았습니다. 그 문장을 이해하지 못하면 다음으로 넘어갈 수 없는 사람도 있었습니다.
Workflow
두 번 검토하고 올리기
기여자들은 원본 저장소를 포크해 번역하고 Pull Request를 올렸습니다. 스튜어드 두 명이 1차와 2차로 나눠 검토하고 코멘트를 남긴 뒤, 양쪽이 승인하면 공식 저장소 담당자에게 머지를 요청했습니다. 레퍼런스는 GitLocalize에서 작업했습니다.
풀 리퀘스트(Pull Request, PR)란 무엇인가요? link 번역 PR 및 리뷰 진행 순서 요약: PR 최초 게시(init) > 스튜어드 2인 및 공동 기여자 쓰기 권한 공유 >1차 번역 커밋 > 1차 리뷰 코멘트 > 1차 리뷰 반영한 2차 번역 커밋 > 2차 리뷰 코멘트 (또는 생략 후 스튜어드 승인) [> 2차 리뷰 반영한 3차 반영 커밋 ...
https://github.com/p5-js-KO-Translation/2024/discussions/7번역만 검토하는 것은 아니었습니다. 작업 파일이 mdx여서 줄바꿈이나 따옴표를 각자 다르게 쓰면 문법 오류가 났습니다. 오류가 있으면 코멘트를 남기고 직접 고쳐 올렸습니다. 기여자들이 번역에 집중할 수 있도록 형식 문제는 리뷰 단계에서 정리했습니다.
3월 4주차 2차 과제 안내 두번째 과제 공지를 업데이트 하였습니다 🙌 보다 원활한 진행을 위해, march-week4-batch2.md 상, 오늘(3/24)중 가급적 빠른 시간 안에 희망 번역 문서 "성함 표기" 요청드립니다 :) 추가 전달 사항 안내 빠른 번역을 위한 기존 p5.js 레퍼런스 페이지 번역문 재활용/수정 권장 참고자료: p5.js 한...
https://github.com/p5-js-KO-Translation/2024/discussions/12#discussioncomment-8947510분량은 배치마다 단어 수로 나눴습니다. 문서마다 길이가 다르고 하나를 둘이 나눠 맡는 경우도 있어서, 기여자별 누적 번역량을 스프레드시트에 기록했습니다. 한 주에 많은 분량을 맡은 사람에게는 다음 주에 적은 분량을 배정했습니다.
Outcome
2024년 4월 30일 p5.js 공식 웹사이트가 새로 공개되었고, 한국어 번역이 함께 반영되었습니다.
2024 p5.js Korean Translation Project. Contribute to p5-js-KO-Translation/2024 development by creating an account on GitHub.
https://github.com/p5-js-KO-Translation/2024
