서문

잘 알려져 있듯이 프로그래밍 개발 분야에서는 영어가 국제 공용어로 사용되는 경우가 많으며, 많은 오픈 소스 프로젝트가 영어 개발자 문서만 제공하고 있습니다. 이로 인해 영어 기초가 탄탄하지 않은 개발자들은 개발 문서를 읽을 때 언어 장벽에 부딪히게 됩니다.

어쩌면 지금은 브라우저 번역 플러그인이 이미 상당히 성숙한 것 아니냐는 의문을 제기하는 사람도 있을 것입니다. 물론 브라우저에 내장된 번역 기능이 대부분의 문서 읽기 문제를 해결할 수 있다는 점은 부정할 수 없습니다. 하지만 일부 형식이 복잡한 상황에서는 브라우저 번역으로 인해 제어하기 어려운 형식 오류가 발생하며, 심한 경우에는 문서의 의미에까지 영향을 줄 수 있습니다.

이전에 Vue.js 중국어 문서 번역에 기여할 때, 대부분의 오픈 소스 프로젝트 문서도 오픈 소스인데, 그렇다면 내 저장소로 하나를 Fork하여 번역한 다음 배포해서 중국어 문서에 접근할 수 있도록 하면 어떨까 하는 생각을 했습니다.

작년 4월, 당시 랴오닝성에 출장을 갔었는데 고객 현장의 생산이 중단된 동안 며칠 연속 호텔에서 유급으로 빈둥거릴 수 있었고, 마침 이 일을 시작할 시간이 있었습니다. 그래서 첫 번째 저장소를 만들었고, 첫 번째 Commit을 커밋하게 되었습니다.

처음에는 단지 문서를 번역해 스스로 사용법을 익히는 데 도움을 받으려는 생각이었기 때문에 문서도 개인 도메인에만 배포했습니다. 그러다 두 번째 프로젝트를 번역하기 시작하면서, 모든 인기 오픈 소스 프로젝트에 지속적으로 발전할 수 있는 중국어 문서 생태계를 제공하고, 거대한 오픈 소스 커뮤니티를 활용해 현지화된 중국어 문서 번역을 함께 유지 관리할 수는 없을까 생각하게 되었습니다.

그렇게 오늘 소개할 오픈 소스 프로젝트인 ‘简中文档’이 탄생했습니다!

프로젝트 소개

2024년 4월 29일, 랴오닝성 출장에서 돌아온 다음 날 zhcndoc이라는 사용자 이름의 Github 조직을 등록했습니다. 동시에 프로젝트의 주요 진입점으로 사용할 zhcndoc.com 도메인도 등록했기 때문에 이날을 프로젝트 설립일로 정했습니다.

BCP 47（Best Current Practice 47）표준에 따르면 zh_CN은 중국어 간체를 의미합니다. 영어 단어 documentation은 ‘문서’로 번역할 수 있으므로, 그 약어인 doc을 zh_CN과 결합하면 zhcndoc이 되며 ‘중국어 간체 문서’라는 뜻을 나타냅니다. 이를 줄여 ‘简中文档’이라고 부릅니다.

프로젝트 공식 웹사이트：https://www.zhcndoc.com

프로젝트 저장소：https://github.com/zhcndoc

현재까지 简中文档은 총 25개 오픈 소스 프로젝트의 중국어 문서를 유지 관리하고 있으며, 그중 7개는 공식 문서의 미러입니다. Nuxt 중국어 문서가 가장 많은 개발자가 방문하는 문서이며, 아래는 추천하는 중국어 문서입니다.

자세한 내용은 简中文档 공식 웹사이트의 프로젝트 탐색에서 확인할 수 있습니다.

1주년

지난 1년 동안 저는 简中文档 프로젝트를 공개적으로 홍보한 적이 없습니다. issues에서 간단히 언급하거나 위챗 그룹에서 교류할 때 그룹 구성원들에게 열람을 추천한 정도였지만, 검색 엔진의 자연 유입에 힘입어 简中文档도 어느 정도 인지도를 얻게 되었습니다.

2024년 5월 Umami 데이터 통계를 연동한 이후, 현재까지 총 45.4만 회의 조회 수와 7.5만 회의 방문 횟수를 기록했으며, 누적 방문자는 약 4만 명입니다. 이 중 83%의 트래픽은 바이두에서, 12%의 트래픽은 Bing에서 유입되었습니다.

웹사이트 SEO 측면에서 웹마스터 도구를 통해 조회한 결과, 현재 바이두 가중치는 2이고, 소거우와 Bing의 가중치는 1입니다.

중국어 인터넷 최대 검색 엔진인 바이두는 색인된 이후 안정적인 키워드 순위와 색인 상태를 계속 유지하고 있습니다. Google은 신규 웹사이트의 색인에 우호적이지 않아 현재 노출이 많지 않습니다. Bing은 지난해 11월 zhcndoc.com 전체 도메인을 차단하여 모든 색인을 삭제했지만, 얼마 전 여러 차례 이의 제기를 거친 끝에 제한이 해제되어 색인과 가중치를 회복했습니다. 소거우 및 기타 검색 엔진에 대해서는 별도의 조치를 취하지 않았습니다.

향후 계획

简中文档이 탄생한 지 1주년이 되었지만, 저는 여전히 이 프로젝트가 구축 초기 단계에 있다고 생각합니다. 아직 번역에 관한 규범 중 정해지지 않은 것이 많고, 번역 기여 프로세스도 완完善되지 않았습니다. 여러 사람의 지혜를 모은다는 취지로, 여러분이 简中文档에 참여하여 함께 의견을 나누고 더 나은 현지화 중국어 문서 지식 기반을 구축해 나가기를 바랍니다.