<div id="readability-page-1" class="page"><div>
  <main>
    <h3 id="postgressql에-번역으로-기여하기">PostgresSQL에 번역으로 기여하기</h3>
<hr>
<p><img src="https://dl.dropbox.com/s/4pyc184bly5p3qi/Screen%20Shot%202021-12-09%20at%203.38.16%20PM%20copy.png" alt=""></p>
<ul>
<li>
<p><a href="https://www.postgresql.org/developer/coding/">PostgresSQL - Develoer</a> 페이지에서 정보를 확인하다가, 번역이라는 섹션을 보았다.</p>
</li>
<li>
<p>번역이라면, 충분히 기여할 수 있고 또한 개발처럼 부담이 많이 되는 것도 아니라서 개발 프로세스 및 메일링 리스트로 대화를 하는데 많은 도움이 될 것 같다는 생각을 했다.</p>
</li>
<li>
<p>또한 기능을 파악하는데 많은 도움이 될 것이다. 문서화, 번역, 테스트 코드는 처음 관심 있는 오픈 소스에 기여하기 위한 좋은 방법이다.</p>
</li>
<li>
<p>그리고 주변 개발자들이나, 오픈 소스에 기여하고 싶은 분들께 처음 시도를 해보면 좋을 것 같은 마음에 정리를 해보았다.</p>
</li>
</ul>
<h3 id="한국어-번역-상황">한국어 번역 상황</h3>
<hr>
<p><img src="https://dl.dropbox.com/s/oiq1fpw8cu0vdrr/Screen%20Shot%202021-12-09%20at%203.47.30%20PM%20copy.png" alt=""></p>
<ul>
<li>
<p>해당 사이트 (<a href="https://babel.postgresql.org/">https://babel.postgresql.org/</a>)에 들어가보면 14 버전을 기준으로 번역이 완료된 부분과 아직 완료되지 않은 부분을 테이블 형태로 보여준다.</p>
</li>
<li>
<p>많이 번역된 모듈도 있지만, 거의 번역되지 않은 모듈도 존재하였다. <code>PostgresSQL</code>은 꾸준하게 개발되므로, 계속 번역할 곳이 생길 것 같다.</p>
</li>
</ul>
<p><img src="https://dl.dropbox.com/s/6f21gls1j1vpbjw/Screen%20Shot%202021-12-09%20at%203.53.49%20PM.png" alt=""></p>
<ul>
<li>또한 해당 사이트에 접속하면 번역된 파일이 언제 머지되었는지, 시황을 확인할 수 있다. 커밋된 메시지를 확인해보니까 서두에 번역된 언어 로케일을 적고 나서, 그 뒤에 메시지를 적는 것 같았다.</li>
</ul>
<p><img src="https://dl.dropbox.com/s/sezodbt8nxsky4m/Screen%20Shot%202021-12-09%20at%204.02.53%20PM.png" alt=""></p>
<ul>
<li>
<p>또한 한국어로 작성된 패치 파일도 확인하였다. 커밋 메시지 중에 번역팀 정보가 있어 만약 번역을 한다면 이 팀에게 연락을 해보는 것도 좋을 것 같다.</p>
</li>
<li>
<p>번역 진행 사항은 메일링 리스트로 관리되어지고 있다. 따라서, 번역을 진행하기 전에 진행하고 싶다는 의사를 <a href="https://www.postgresql.org/list/pgsql-translators/">pgsql - translators</a> 로 보내보는 것도 좋을 것 같다.</p>
</li>
</ul>
<h3 id="번역을-진행하는-법">번역을 진행하는 법</h3>
<hr>
<p><img src="https://dl.dropbox.com/s/xl2nm4hk09nl6gx/Screen%20Shot%202021-12-09%20at%205.49.45%20PM.png" alt=""></p>
<ul>
<li>
<p><a href="https://wiki.postgresql.org/wiki/NLS">https://wiki.postgresql.org/wiki/NLS</a> 에서 번역을 하는 방법에 대해서 알려주고 있다.</p>
</li>
<li>
<p>번역은 <code>GNU</code>에서 만든 도구인 <a href="https://www.gnu.org/software/gettext/manual/gettext.html">GNU Gettext - 메뉴얼</a> 을 사용한다.</p>
</li>
</ul>
<h4 id="번역-프로세스">번역 프로세스</h4>
<ol>
<li>
<p><a href="https://babel.postgresql.org/">번역 현황판</a>에 가서, PO 파일을 다운로드 받아라 그리고 나서, 그 파일에다가 번역을 하면 된다.</p>
</li>
<li>
<p>새로운 번역을 시작하려면 표 맨 왼쪽에 있는 모듈 (카탈로그) 이름 중에 번역하고 싶은 것을 클릭하여서 <code>.POT</code> 파일을 다운로드 한다. 헤더 부분의 모든 필드를 채우고 나면, 퍼지 플래그를 지워준다.</p>
</li>
</ol>
<p><img src="https://dl.dropbox.com/s/kkkspu2zehyalcv/Screen%20Shot%202021-12-09%20at%206.22.25%20PM.png" alt=""></p>
<ul>
<li><code>VIM</code> 플러그인에서 오류나는 부분을 자동으로 알려준다. 따라서 이러한 부분을 모두 채우면 다음과 같고, 아까 검증하는 명령어를 터미널에 입력하면 아래와 같이 번역된 숫자와 번역되지 않은 숫자를 알려준다.</li>
</ul>
<p><img src="https://dl.dropbox.com/s/2f62jigczemeem3/Screen%20Shot%202021-12-09%20at%206.30.09%20PM.png" alt=""></p>
<p><img src="https://dl.dropbox.com/s/3z6triu9si3jqr4/Screen%20Shot%202021-12-09%20at%206.30.23%20PM.png" alt=""></p>
<ol start="3">
<li>
<p>편집을 마치고 나서 파일에 오류가 있는지를 확인한다. 오류를 확인하는 방법은 다음과 같다. 터미널에 <code>msgfmt -o /dev/null -v -c yourfile.po</code> 명령어를 실행한다. 또는 <code>PostgresSQL</code> 소스코드에 파일을 복사한 후에, <code>gmake maintainer-check-po</code> 명령어를 입력한다. 만약 이러한 확인 작업을 하지 않으면 사용자가 프로그램을 사용하는 도중에 버그가 발생할 수 있으므로 꼭 확인을 해야한다.</p>
</li>
<li>
<p>확인까지 문제 없이 모두 마쳤다면, 결과물을 <a href="https://redmine.postgresql.org/projects/pgtranslation">패치 - 트래커</a>에 첨부하여 작업을 했다는 것을 알린다. 파일을 첨부할 때 패치파일을 보내는 것이 아니라, 그냥 번역한 파일 그대로 보내면 된다. 오히려 간편하다.</p>
</li>
</ol>
<ul>
<li>파일은 이름을 변경하지 말고, 다운로드 받은 당시의 파일 이름 그대로 사용하면 된다.</li>
</ul>
<ol start="5">
<li>마지막으로 메인테이너가 소스코드에 병합 시켜주면, 번역한 파일이 반영된다.</li>
</ol>
<h3 id="유용한-도구">유용한 도구</h3>
<hr>
<ul>
<li>
<p>텍스트 편집기를 사용해도 되지만, 전용 편집기를 사용하면 더욱 편리하게 작성할 수 있다.</p>
</li>
<li>
<p><a href="https://poedit.net/">poedit</a> 이라고 하는 편집기다.</p>
</li>
</ul>
<h3 id="이전에-기여한-사람에게-연락하기">이전에 기여한 사람에게 연락하기</h3>
<hr>
<ul>
<li>해당 파일을 작업하기 전에 파일에 나와있는 마지막으로 수정한 팀이나 번역가에게 연락을 해야한다. 왜냐하면 중복해서 작업을 하는 불상사를 피하기 위해서이다.</li>
</ul>
<h3 id="참고-문헌">참고 문헌</h3>
<hr>
<ul>
<li>
<p><a href="https://babel.postgresql.org/">postgres - babel</a></p>
</li>
<li>
<p><a href="https://git.postgresql.org/gitweb/?p=pgtranslation/messages.git;a=summary">pgtranslation - gitlog</a></p>
</li>
<li>
<p><a href="https://wiki.postgresql.org/wiki/NLS">postgres - Wiki (NLS)</a></p>
</li>
</ul>

    <a href="../../../../"> &gt;&gt; Home</a>
  </main>
</div></div>

Home on 개발자 이동욱

Lee Dong Wook

PostgresSQL에 번역으로 기여하기
PostgresSQL - Develoer 페이지에서 정보를 확인하다가, 번역이라는 섹션을 보았다.
번역이라면, 충분히 기여할 수 있고 또한 개발처럼 부담이 많이 되는 것도 아니라서 개발 프로세스 및 메일링 리스트로 대화를 하는데 많은 도움이 될 것 같다는 생각을 했다.
또한 기능을 파악하는데 많은 도움이 될 것이다. 문서화, 번역, 테스트 코드는 처음 관심 있는 오픈 소스에 기여하기 위한 좋은 방법이다.
그리고 주변 개발자들이나, 오픈 소스에 기여하고 싶은 분들께 처음 시도를 해보면 좋을 것 같은 마음에 정리를 해보았다.
한국어 번역 상황
해당 사이트 (https://babel.postgresql.org/)에 들어가보면 14 버전을 기준으로 번역이 완료된 부분과 아직 완료되지 않은 부분을 테이블 형태로 보여준다.
많이 번역된 모듈도 있지만, 거의 번역되지 않은 모듈도 존재하였다. PostgresSQL은 꾸준하게 개발되므로, 계속 번역할 곳이 생길 것 같다.
또한 해당 사이트에 접속하면 번역된 파일이 언제 머지되었는지, 시황을 확인할 수 있다. 커밋된 메시지를 확인해보니까 서두에 번역된 언어 로케일을 적고 나서, 그 뒤에 메시지를 적는 것 같았다.
또한 한국어로 작성된 패치 파일도 확인하였다. 커밋 메시지 중에 번역팀 정보가 있어 만약 번역을 한다면 이 팀에게 연락을 해보는 것도 좋을 것 같다.
번역 진행 사항은 메일링 리스트로 관리되어지고 있다. 따라서, 번역을 진행하기 전에 진행하고 싶다는 의사를 pgsql - translators 로 보내보는 것도 좋을 것 같다.
번역을 진행하는 법
https://wiki.postgresql.org/wiki/NLS 에서 번역을 하는 방법에 대해서 알려주고 있다.
번역은 GNU에서 만든 도구인 GNU Gettext - 메뉴얼 을 사용한다.
번역 프로세스
번역 현황판에 가서, PO 파일을 다운로드 받아라 그리고 나서, 그 파일에다가 번역을 하면 된다.
새로운 번역을 시작하려면 표 맨 왼쪽에 있는 모듈 (카탈로그) 이름 중에 번역하고 싶은 것을 클릭하여서 .POT 파일을 다운로드 한다. 헤더 부분의 모든 필드를 채우고 나면, 퍼지 플래그를 지워준다.
VIM 플러그인에서 오류나는 부분을 자동으로 알려준다. 따라서 이러한 부분을 모두 채우면 다음과 같고, 아까 검증하는 명령어를 터미널에 입력하면 아래와 같이 번역된 숫자와 번역되지 않은 숫자를 알려준다.
편집을 마치고 나서 파일에 오류가 있는지를 확인한다. 오류를 확인하는 방법은 다음과 같다. 터미널에 msgfmt -o /dev/null -v -c yourfile.po 명령어를 실행한다. 또는 PostgresSQL 소스코드에 파일을 복사한 후에, gmake maintainer-check-po 명령어를 입력한다. 만약 이러한 확인 작업을 하지 않으면 사용자가 프로그램을 사용하는 도중에 버그가 발생할 수 있으므로 꼭 확인을 해야한다.
확인까지 문제 없이 모두 마쳤다면, 결과물을 패치 - 트래커에 첨부하여 작업을 했다는 것을 알린다. 파일을 첨부할 때 패치파일을 보내는 것이 아니라, 그냥 번역한 파일 그대로 보내면 된다. 오히려 간편하다.
파일은 이름을 변경하지 말고, 다운로드 받은 당시의 파일 이름 그대로 사용하면 된다.
마지막으로 메인테이너가 소스코드에 병합 시켜주면, 번역한 파일이 반영된다.
유용한 도구
텍스트 편집기를 사용해도 되지만, 전용 편집기를 사용하면 더욱 편리하게 작성할 수 있다.
poedit 이라고 하는 편집기다.
이전에 기여한 사람에게 연락하기
해당 파일을 작업하기 전에 파일에 나와있는 마지막으로 수정한 팀이나 번역가에게 연락을 해야한다. 왜냐하면 중복해서 작업을 하는 불상사를 피하기 위해서이다.
참고 문헌
postgres - babel
pgtranslation - gitlog
postgres - Wiki (NLS)

PostgresSQL 번역으로 기여하는 방법

댓글