Pootle 안내서

From The Document Foundation Wiki
Jump to: navigation, search

이 페이지는 Pootle UI와 사용법에 대한 설명입니다. 계정 생성과 프로젝트 접근 방법은 Pootle 홈페이지를 참조하세요. Pootle은 온라인 번역 도구로 사용할 수도 있고, Virtaal이나 OmegaT와 같은 오프라인 번역 도구의 번역 저장소로 사용할 수도 있습니다.

사이트에 로그인하고 화면 좌상단의 The Document Foundation - Pootle server를 클릭하면 언어나 프로젝트를 선택할 수 있는 리브레오피스 번역 홈페이지가 나옵니다.


화면 위쪽에 All Languages 또는 All projects 라는 드롭다운 목록이 있습니다.
그 중 All Languages 에서 예를 들어 프랑스어(French)를 선택하면 아래와 같은 화면으로 이동합니다.

Project page of a selected language


화면의 우상단에는 사용자 계정 페이지를 위한 버튼이 있습니다.

내 계정

로그인 아이디나 통계를 클릭하면 공개 프로파일과 설정을 선택할 수 있는 드롭다운 메뉴가 표시됩니다.

  • 공개 프로파일 이름이나 아바타, 소셜 미디어 링크, 간단한 약력 등을 기재할 수 있습니다.
  • 설정 번역 관련 설정을 할 수 있습니다.
    • 비밀번호 초기화(Password) 항목에서는 암호를 변경할 수 있습니다. (Pootle 인터페이스 번역 오류임)
    • 가로 줄(number of lines) 항목은 화면에 표시할 행 수입니다. 기본값은 9 입니다.

인터페이스 언어(Interface Language) 항목에서는 Pootle 인터페이스에 사용할 언어를 선택합니다. 언어를 선택하지 않으면 기본값인 영어로 표시됩니다. 근본 언어 대안(Interface Language) 항목에는 영어와 함께 표시할 언어를 추가할 수 있습니다. 하나 이상의 언어를 선택하려면 Ctrl 키를 누른 채로 언어 목록에서 원하는 언어를 선택합니다. 선택한 언어를 제거하려면 Ctrl 키를 누른 상태에서 해당 언어를 다시 한번 클릭합니다.

Screenshot Display a second source language above the English one
영어 외에 다른 언어 표시
    • 저장 버튼을 눌러 변경 사항을 저장합니다.
  • 통계(Statistics) 항목은 최근 한 달간의 번역 기여도를 표시합니다.

프로젝트

이 페이지에는 Pootle 저장소에 있는 모든 프로젝트가 표시됩니다. 현재 6개의 주 프로젝트가 있습니다.

  • Impress remote (Android)
  • Impress remote (iOS)
  • Localization for the 4.x.x product (UI and Help files)
  • Localization for the 5.x.x product (UI and Help files)
  • Localization from master (UI and Help files). 이 프로젝트는 새로운 워크플로우와 관련있으며, 이 프로젝트의 번역 결과는 리브레오피스 최신 버전에 반영됩니다.
  • LibreOffice OnLine. 리브레오피스 온라인 버전
  • Terminology
  • Website 리브레오피스 웹사이트와 관련된 프로젝트로, 해당 언어로 된 리브레오피스 웹사이트에 반영됩니다.

프로젝트 목록의 열 항목은 다음과 같습니다.
특정 언어에 번역 프로젝트를 추가하려면 Pootle 관리자에게 요청하십시오.

프로젝트 상세

프로젝트 페이지로 이동하면 번역해야할 po 파일들의 목록이 표시됩니다.
각 파일 옆에는 번역 진행 상태에 따라 녹색/연두색/회색으로 표시된 진행 상태바가 표시됩니다. 여기에 마우스 커서를 올려 놓으면 상세 내용이 표시됩니다. 아래는 각 열에 대한 설명입니다.

  • 진행 상태 번역 진행 상태를 표시하는 상태바입니다.
  • 최근 활동 가장 최근에 활동을 한 팀 멤버입니다.
  • 치명적인(Critical) 오류가 있는 문자열의 단어 수입니다.
  • 전체 파일/디렉토리의 총 단어 수입니다.
  • 최근 업데이트 프로젝트가 마지막으로 업데이트된 시각입니다.
  • 완료되지 않은(Need translation) 번역이 필요한 단어 수입니다. 숫자를 클릭하여 해당 단어들을 바로 번역할 수 있습니다.
  • 제안 다른 팀 멤버가 제안한 번역의 단어 수입니다. 권한이 있는 경우 제안 내용을 수락하거나 거부할 수 있습니다.

좌상단의 탐색 버튼을 누르면, 탐색, 번역, 용어 정의, (권한이 있는 경우) 권한 등으로 이동할 수 있는 메뉴가 표시됩니다.


po 파일 다운로드

프로젝트 페이지의 오른쪽에는 사이드바를 위한 작은 표시(<<)가 있습니다. 이 버튼을 누르면 사이드바가 표시됩니다. 여기서 오프라인 번역을 위해 po 파일을 다운로드하거나 업로드할 수 있습니다. 또한 다른 멤버의 이름으로 파일을 업로드할 수도 있습니다.

오프라인 번역을 위한 파일 다운로드/업로드 패널


다음 부분은 굉장히 중요한 부분이므로, 꼭 확인합니다.

검사

검사는 아래에 표시된 것과 같은 오류를 잡아내는 스크립트입니다.

화면 상단의 전체 진행 상태바 아래쪽에 있는 더하기(+) 아이콘을 누르면 검사 페이지가 열립니다. 수정해야 할 심각한 오류의 수는 전체 상태 표시줄이나 각 항목의 오류 열에 빨간색 배경으로 표시됩니다. 이 숫자를 클릭하면 수정할 수 있는 페이지로 이동합니다.

그 외에 다른 검사 항목들도 있습니다.

  • 치명적인(Critical): 반드시 수정해야 하는 오류입니다. 이 오류들이 있으면 리브레오피스 빌드나 사용자 인터페이스에 심각한 문제를 발생시킬 수 있습니다. 단 간혹 언어에 따라 오류가 아닌 것을 오류로 표시할 때도 있습니다. 하지만 그것이 정말 오류는 아닌지 꼭 확인하십시오.
  • 기능동작(Functional): 사용자 경험에 영향을 주므로 정확한 번역이 필요한 중요한 부분입니다.

오류 검사에는 상황에 따라 다양한 오류들이 표시될 수 있습니다. printf()Invalid XML 같은 항목(또는 옆의 숫자)을 클릭하면, 관련 문자열로 바로 이동하여 오류를 수정할 수 있습니다. 오류를 수정하고 화면 아래의 다음 버튼을 더이상 오류가 없을 때까지 반복합니다. 특정 범주의 오류를 모두 수정하면 오류 검사 목록에 해당 범주가 표시되지 않습니다.

오류 검사에서 오류가 아닌 것을 발견한 경우, 번역 편집 화면의 오른쪽에 있는 해당 오류 레이블을 클릭해서 정상 문자열로 표시할 수 있습니다. 하지만 향후 서식 파일이 업데이트되면 해당 문자열은 다시 오류가 있는 것으로 표시될 것입니다. 그때마다 다시 확인하여 새로운 번역이 정말 문제가 없는지 확인하십시오.

찾기

찾기는 현재 디렉토리에서 지정한 문자열을 찾습니다. 찾기 필드를 클릭하면 아래와 같은 하위 메뉴가 표시됩니다.

  • 원본 텍스트: 영어 문자열에서 찾습니다.
  • 타겟 텍스트: 대상 언어 문자열에서 찾습니다.
  • 주석: 주석에서 찾습니다.
  • 위치: 지정한 경로에서 찾습니다.
  • Phrase Match: 지정한 문자열과 정확하게 일치하는 문자열만 찾습니다.
    • Ctrl+⇧ Shift+S : 하위 메뉴에서 찾기 필드로 이동
    • ↵ Enter 또는 돋보기 아이콘 클릭 : 찾기 시작

찾기 기능 사용 팁:

  • 여러 단어를 입력하면 AND 논리 연산자로 연결하여 검색합니다.
  • OR 나 NOT 논리 연산자를 이용한 검색을 할 수 없습니다.
  • 대소문자를 구분하지 않습니다. Options, options, opTions 를 모두 같은 결과로 검색합니다.

Pootle 의 검색 기능은 상당히 제한적입니다. 리눅스를 사용한다면 Grep 명령어를 사용해서 검색할 수도 있습니다. 이에 대한 더 자세한 사항은 이 페이지를 참조하십시오.

참조: 각 문자열은 고유의 KeyID 번호를 갖고 있습니다. 이 KeyID를 이용하여 문자열을 찾을 수 있습니다. KeyID는 Pootle 편집기에서 주석으로 추가되어있으며, 아래 예제 스크린샷에서는 9LgFW 입니다.

Screenshot KeyID in comment
KeyID 가 있는 주석 영역

번역

화면 상단의 번역 계속(Continue Translation) 버튼을 누르면 해당 프로젝트의 미번역 문자열을 모아 보여줍니다. 마찬가지로 프로젝트 목록의 완료되지 않은(Incomplete) 열에 해당 프로젝트의 미번역 문자열의 단어 수가 파란색 배경으로 표시되며, 버튼을 클릭하면 해당 프로젝트의 미번열 문자열을 모아 보여줍니다. 이는 디렉토리/파일 단위로도 동일하게 적용됩니다. 편집 화면에서 번역/리뷰/제안 추가 등을 진행하고 나면 해당 편집자의 이름이 기록됩니다. 오류가 있으면 해당 문자열의 배경색이 옅은 빨간색으로 표시됩니다.

리브레오피스 번역에서 자동 생성된 번역 메모리(LocalTM)의 제안이 있는 경우 편집 영역 하단에 표시됩니다.

편집 영역은 크게 세 부분으로 나뉩니다. 왼쪽에는 파일 경로, 주석, 용어 제안 등의 요소가 표시되고, 가운데는 원본 문자열과 번역 문자열이 표시됩니다. 그리고 오른쪽에는 오류 검사 관련 내용이 표시됩니다.

Screenshot string area in Translate tab
String area on the Translate tab

왼쪽 영역

왼쪽 영역에는 문자열과 파일 위치에 관련된 힌트가 제공됩니다.

  • 화면 위쪽에 파일의 경로가 표시됩니다. 예제(위 스크린샷)에서는 libo_help/swriter.po 입니다. 이는 현재 편집 중인 문자열이 help 디렉토리 안의 swriter.po 파일 안에 있다는 뜻입니다. 그리고 #92548984 는 데이터베이스의 식별 번호입니다.
  • 문맥 부분에는 소스 코드 내에서 문자열의 위치를 표시하고 해당 문자열의 특성을 표시합니다. 이를 이용하여 문자열의 특징을 파악할 수도 있습니다.(예제처럼 main0210.xhp tit help.text 라면 해당 문자열이 도움말 제목일 것이라는 추정이 가능합니다.)
  • 주석 부분에는 KeyID가 표시됩니다. KeyID는 문자열별로 고유합니다.
  • 용어 부분에는 기존 번역을 기반으로 Pootle project에서 생성한 용어집에 있는 단어들과 일치하는 단어들이 표시됩니다. 이 제안 번역어를 클릭하면 편집 화면의 번역 영역에 바로 삽입됩니다.
screenshot left area of editor
Left area of the editor, giving file path and context

가운데 영역

편집 화면의 가운데 영역에는 번역을 입력할 수 있는 부분이 있습니다. 다른 언어를 함께 표시하도록 설정한 경우, 영어 원본 위에 표시됩니다.

  • 원본 문자열에 <bookmark_value> 또는 </bookmark_value> 와 같은 태그가 있는 경우, 해당 태그를 클릭하면 번역문 영역의 커서 위로 복제됩니다.
  • 원문에 문제가 있으면 오른쪽 위에 있는 '이 문자열에 있는 문제 보고하기' 버튼을 클릭하여 보고를 합니다. 또는 문자열이 변수이면서 소스와 다르지 않을 때에도 보고합니다.
  • 편집 영역 바로 아래에는 세 개의 아이콘이 있습니다. 첫번째는 문자열의 변경 내역을 보여주는 타임라인, 두번째는 주석을 추가할 수 있는 주석 넣기입니다. 여기에서 입력한 주석은 다른 프로젝트로 업로드하면 유지되지 않습니다. 주석 입력 후 제출 버튼을 누릅니다. 그리고 세번째 아이콘은 번역한 문자열의 미리보기를 변경하는 작성하나도 않한 뷰(Raw view, Pootle 번역 오류) 입니다.
screenshot editor area
Editor area

오른쪽 영역

오른쪽 영역에는 제출 버튼이 있습니다. 단축키 Ctrl+↵ Enter 키를 눌러 제출과 동시에 다음 문자열로 이동할 수도 있습니다.

  • 제출 버튼 아래에 작은 확인 상자 작업이 필요하다(Needs work) 가 있습니다. 이 확인 상자를 선택하면 해당 문자열이 퍼지(모호한 번역) 상태로 변경됩니다. 이를 책갈피 용도로 사용할 수도 있습니다.
  • 제안 링크를 클릭하면, 편집기가 제안 모드로 바뀌면서 제출 버튼도 제안 버튼으로 바뀝니다. 이 모드에서 입력한 번역은 승인이 필요한 제안으로 등록됩니다. 단축키 Ctrl+⇧ Shift+Space 키를 눌러 모드를 전환할 수 있습니다. 이렇게 제안된 번역은 디렉토리 목록에서 바로 접근할 수 있습니다.
  • 오류가 있으면 제출 버튼 위쪽에 해당 오류들이 표시됩니다.
screenshot of the right area
오류 표시
  • 유닛 번호는 데이터베이스에서의 문자열 식별 번호입니다. 이는 다른 팀 동료와 문자열에 대해 논의할 때 이 번호를 포함한 링크를 이용할 수 있습니다.

상단 표시줄

번역탭 페이지의 상단에는 여러가지 정보가 있는 상단 표시줄이 있습니다.

screenshot of status bar
여러가지 정보와 필터 기능이 있는 상단 표시줄
  • 왼쪽에는 이전에 설명한 찾기 필드가 있습니다.
  • 찾기 필드 오른쪽에는 상태에 따른 필터링을 할 수 있는 드롭다운 목록이 있습니다.(needs work, suggestions, overwritten suggestions, untranslated, etc)
  • 선택한 필터 종류에 따라 다른 드롭다운 목록이 표시될 수도 있습니다. 예를 들어 스크린샷과 같이 '검사' 항목으로 필터링을 하면, 치명적, 함수적, 외형 등과 같은 하위 항목으로 다시 필터링을 할 수 있습니다.
  • 기본 순서 버튼을 누르면 문자열의 표시 순서를 변경할 수 있습니다. 기본값은 최신 문자열부터 보여줍니다.
  • 문자열 번호 항목에는 필터링된 문자열의 수와 현재 문자열 위치가 표시됩니다. 좌우에 있는 위아래 버튼을 클릭하거나 현재 문자열 위치에 번호를 입력하여 다른 문자열로 이동하 수 있습니다. 또는 단축키 Ctrl+Ctrl+ 를 사용할 수도 있습니다.

용어

용어 파일은 .po 파일로 Pootle 에 직접 올려서 관리할 수 있습니다. 이 파일에 있는 용어들은 작업 중인 편집 화면의 번역 영역에 제안어로 표시됩니다. 이 파일은 문서팀이나 번역 안내서, 새 문서 작성 등의 참고자료로 쓸 수도 있습니다.

생성

가장 먼저 Pootle 관리자에게 프로젝트 생성 요청을 해야 합니다. 그런 뒤에 페이지 오른쪽의 Upload 버튼을 클릭하여 .po 파일을 업로드하거나, 용어 탭 페이지를 이용하여 Pootle 내 기존 번역으로부터 새로운 용어 파일을 생성합니다.

파일 생성 관련 힌트

  • 용어(terminology)용어 사전(glossary)는 서로 다릅니다.
  • 항목을 만들때 최대한 단순하게 만듭니다. 예를 들어 an object이 아니라 object로 만듭니다.
  • 항목에 주석을 추가하면 주석이 편집기의 풍선도움말로 표시됩니다.
  • 원본 단어에 부가 정보를 추가할 수 있습니다. 예를 들어 view (verb) 또는 view (noun). 하지만 대상 언어(번역어)에는 추가하지 마십시오. 번역어에 부가 정보를 추가하면, 제안 용어를 클릭시 편집기의 번역 부분에 모두 복제됩니다.
  • 항목은 최대 30 글자를 넘지 않도록 하십시오.
  • 용어 기능이 활성화되어 있으면, 번역시 실시간으로 적용됩니다. 따라서 용어 파일이 너무 크면 성능이 느려질 수 있으므로 용어 파일의 크기에 주의하십시오.

관리

Pootle의 번역 탭 페이지를 통해 직접 관리할 수 있습니다. 프로젝트 링크를 클릭하여 용어 파일과 파일 내 용어를 관리합니다.

용어 탭 페이지에서는 원본 언어의 용어를 관리하거나 주석을 추가할 수 있습니다. 그리고 You can regenerate a glossary from scratch 링크를 클릭하여 새로운 용어 파일을 만들 수도 있습니다. 하지만 이 페이지에서 용어를 번역할 수는 없습니다. 번역은 번역 탭 페이지에서만 가능합니다.

  • 번역어 앞의 작은 i 아이콘은 해당 단어가 포함된 파일의 경로와 빈도 수를 나타냅니다.
  • 원본 필드 오른쪽의 작은 설명 아이콘을 클릭하면 부가 정보를 추가할 수 있는 주석 필드가 표시됩니다. 문자열의 KeyID도 여기에 표시됩니다. 삭제하지 마십시오.
  • 페이지의 맨 오른쪽에 있는 확인 상자를 선택하면 .po 파일에서 해당 용어를 삭제합니다.
  • 페이지 왼쪽 하단의 변경 사항 저장 버튼을 눌러 변경 사항을 저장합니다.
screenshot terminology entry
주석과 정보가 표시된 용어 항목

제안

팀원별 권한에 따라 일부 팀원은 번역을 직접 제출하지 못하고 제안만 할 수 있을 수도 있습니다. 또는 Ctrl+⇧ Shift+Space 키를 이용해 번역 모드에서 제안 모드로 변경하여 작업할 수도 있습니다.

번역어 제안이 제출되면, 번역 진행 상태바에 제안 검수 (xx 남음) 이라고 표시됩니다.(xx는 검수해야 할 제안어의 수입니다) 이는 트리뷰의 제안 칼럼에도 표시됩니다. 제안 수를 표시한 버튼을 클릭하여 제안을 승인하거나 거부할 수 있습니다.

편집기에서 제안 문자열은 주석 필드 아래에 표시되며 원문과 제안문의 차이점이 표시됩니다. 녹색 버튼을 클릭하면 제안이 승인되며 제안문이 원문을 대체합니다. 빨간 버튼을 클릭하면 제안을 거부하며 해당 제안을 삭제합니다.

screenshot managing suggestions
제안 관리

용어 파일에서는 제안 영역 오른쪽의 작은 별을 클릭하여 투표를 할 수 있습니다. 별을 클릭하면 별이 노란색으로 바뀌고 투표 수가 누적됩니다. 투표를 취소하려면 별을 다시 클릭하십시오.

screenshot showing votes on suggestions
제안에 투표하기

새 소식

새 소식 탭에는 팀원이 올린 현재 프로젝트나 디렉토리에 관한 정보가 표시됩니다. 이 정보는 이메일을 통해 등록할 수 있습니다.

프로젝트 내의 일부 동작도 새 소식으로 표시됩니다.

Sat 07 Sep 2013 04:21:19 PM UTC
sophie uploaded a file to LibreOffice 4.1 – UI [French] 
Before upload: 29799 of 29799 strings translated (0 fuzzy). 
After upload: 29799 of 29799 strings translated (0 fuzzy).  

이러한 방법을 통해 서식 업데이트 등의 프로젝트 내의 활동을 모니터링할 수 있습니다.

권한

권한 버튼은 프로젝트 페이지에 번역자 또는 관리자 권한을 가진 회원에게만 표시됩니다. 권한 버튼은 탐색 버튼 아래의 드롭다운 메뉴에 있습니다. 탐색 버튼 옆의 작은 화살표를 누르면 목록이 펼쳐집니다. 드롭다운 목록의 권한 항목

Pootle에는 NobodyDefault 라는 특수 권한이 있습니다. Nobody는 로그인을 하지 않은 사용자를 의미하고, Default는 로그인한 사용자를 의미합니다.

주의: 언어 관리자는 자신의 권한도 삭제할 수 있습니다. 이런 일이 발생했을 경우 Pootle 관리자에게 요청하십시오.

권한 종류는 다음과 같습니다.

  • Can add directory: 프로젝트에 디렉토리 추가 가능
  • Can administrate a translation project: 번역 프로젝트에서 다른 팀원의 권한 관리 가능
  • Can download archives of the translation project: 프로젝트의 .po 파일 다운로드 가능
  • Can change directory: 파일의 디렉토리 변경 가능
  • Can commit to version control: 코드 저장소에 커밋 가능. 리브레오피스 프로젝트에서는 사용하지 않습니다.
  • Can delete directory: 프로젝트의 디렉토리 삭제 가능
  • Can overwrite translations on uploading files: 오프라인 번역 후 업로드한 파일의 내용을 병합하지 않고 덮어쓰기 가능
  • Can review suggestions: 제안을 승인하거나 거부 가능
  • Can make a suggestion for a translation: 문자열에 제안 가능
  • Can submit translation: 다른 팀원의 검수없이 바로 번역을 제출 가능

팀원에게 권한을 부여하려면, 권한 메뉴를 선택하고 Ctrl 키를 누른 상태에서 필요한 권한을 다중 선택합니다. 그리고 변경 사항 저장 버튼을 누릅니다. 오른쪽의 작은 확인 상자를 선택하면 해당 팀원의 권한을 삭제합니다.