Help:Extension:Translate/ko



The Translate extension enhances MediaWiki with essential features needed to do translation work. It can be used to translate the content pages, the interface of the wiki and even other software products, as it is used at translatewiki.net. The Translate extension comes with an easy to use translation interface and allows to separate the content structure from the content language to be translated, showing only the translatable text to translators by splitting the content into manageable units. Each unit is automatically tracked for changes, and translators immediately see what needs updating on a specific page or throughout the wiki.

번역 확장기능은 translatewiki.net 에서 매달 수백명의 번역자가 미디어위키의 사용자 인터페이스나 다른 오픈소스 소프트웨어를 번역할때 쓰였고, userbase.kde.org 에서도 거의 천개에 달하는 사용자 문서들을 번역하는데 쓰였습니다. 번역 확장기능으로 번역을 매우 쉽게 시작할수 있으며, 교정을 위한 고급 보고기능과 작업흐름 관련 기능을 제공하기 때문에 대규모의 번역작업에서도 편리합니다.

기능


인터페이스: 번역 확장기능의 특징은 간단하면서도 기능적인 인터페이스 입니다. 다른언어로 번역된 메세지의 정의나 문서와 같은 필수적인 정보를 함께 볼수 있으며, 만약 정의가 수정되었다면 수정된 내역을 바로 확인할 수도 있고, 확장기능에 포함되어 있는 확인기능을 통해, 괄호의 짝 확인이나 사용되지 않은 변수와 같은 실수를 확인할 수도 있습니다. 설정에 따라 이전 번역 내역을 참고하거나, 구글 번역, 마이크로소프트 Bing 번역, Apertium 과 같은 자동번역 서비스의 번역 제안을 받을 수도 있습니다.

The usability of the translation interface is enhanced with JavaScript and AJAX. The backend provides WebAPIs than can be used in mobile interfaces or interfaces tailored to specific kind of content. It is also possible to export messages for translation in other off-line and on-line tools that accept the Gettext po file format.

메세지 그룹과 작업들(tasks): 많은 기능들이 '메세지 그룹'과 'task'라는 기본적인 개념에 포함됩니다

'메세지 그룹'은 메세지들의 집합을 나타냅니다. 하나의 문서가 하나의 메세지 그룹이 된다면, 문서의 각 문단이 메세지 그룹에서 하나의 메세지가 되는 것입니다. 메세지들은 translatewiki.net 에서 미디어위키 확장기능들의 메세지 그룹을 구성하는데 사용됩니다. - 규모가 큰 확장기능의 일부는, 다수의 메세지 그룹이 존재하는데, All newletters 나 'All Translate extension messages 같이 그룹내에 그룹을 생성할 수도 있습니다. 보통, 다수의 번역 현황이나 일감들이 메세지 그룹을 기준으로 동작합니다.

task는 메세지 그룹의 메세지를 다른 형태로 나열해놓은 것을 말합니다. 보통 번역가들은 선택된 메세지 그룹 내에서 아직 번역되지 않은 전체 메세지의 목록을 받지만, 단순히 메세지를 검토하거나, 전체 메세지의 목록을 조회할 수도 있습니다.



보고와 통계: 번역 확장기능에는 언어별 번역 통계부터 언어별 번역가들의 활동 상태에 이르기까지 광범위한 보고 기능들 이 있습니다.

내용 번역: 만약 미디어위키를 아무런 도구의 도움없이 번역해본적이 있다면, 확장하기 어렵다는것을 아실겁니다. 번역된 문서는 원문 문서가 갱신되더라도 변경사항을 알 수 없기때문에 금방 구식이 되버립니다. 때문에 수많은 문서들이 전체 상태의 명확한 개요 없이 절반만 번역되거나, 이미 구식이 되버린 문서들도 있습니다. 사용자는 오래된 정보로 인해 혼란스러워질 수 있으며, 번역가도 갱신해야할 문서들을 찾지 못해 번역 의지가 꺾이곤 합니다

번역할 문서가 번역 확장기능을 지원한다면, 이 문제를 해결할 수 있습니다. 번역에 필요한 부가적인 정보가 문서에 추가되는 부담이 있지만, 훨씬 이익입니다. 기본적으로는, 번역이 필요한 문서의 각 부분을 표시해주면 되는데, 번역 확장기능이 표시한 부분을 문단 크기로 분리해내고, 분리된 부분을 담을 메세지 그룹을 생성해냅니다. 이후에 번역자는 상기에 언급된 기능들을 활용할 수 있습니다. 또한, 태그를 붙여 언어 막대를 간단히 추가하거나 Special:MyLanguage/Pagename 과 같은 형태의 링크를 걸어주는 것으로, 사용자가 선호하는 언어의 문서가 존재할때만 자동으로 연결하도록 할 수 있습니다.

더 자세한 정보나 예제를 보려면 문서번역을 위헌 설정 예제 를 참고하거나 문서 번역기능 심층설명서를 참고하세요.

개발자들: 번역 확장기능은 '자바 속성파일이나 Gettext po 서식같은 내장된 다양한 번역 파일형식이 존재하며, 위키내에서나 명령줄에서 번역물의 효율적인 추출을 위해 다양한 도구들이 있습니다.

Use cases
You can translate almost anything with the Translate extension. Naturally there are specialized tools for translation of certain kind of content like video subtitles, that are better done with those tools, but in general Translate performs very well with any kind of text that can be split into messages with length ranging from one word up to one large paragraph. Longer messages become unwieldy to translate and are just harder to work with.

번역 확장기능을 활용한 예로 내용번역, 인터페이스 번역, 소프트웨어 번역 이 있습니다. 다음 설명에서 참고 자료와 따라하기 예시를 통해 설명하도록 하겠습니다.

내용 번역


대부분의 위키는 다양한 언어로 작성된 글을 가지려고 합니다. 몇페이지가 되는지는 그렇게 중요하지 않습니다. 번역가의 시간을 절약하기 위해서 문서가 완전히 번역된 경우에 한해 표시되어야 합니다. 각각의 변화는 추후 수십, 수백개의 다른 번역에도 영향을 줄 수 있고, 아귀에 맞게 갱신하기위해선 시간이 필요하게 됩니다. 특히, 자원봉사로 임하는 번역가들의 번역과 갱신에 걸리는 시간을 존중하고, 불필요한 작업을 행하지 않도록 이점을 주의해야 합니다. 만약 당신이 문서를 번역하기 위해 번역 확장기능을 사용하고 있다면, 번역가의 시간을 절약하기 위한 가장 효과적인 방법을 찾았다고 할 수 있습니다.

The way the Translate extension splits up a page into paragraph sized units does not leave too much freedom for translators to change the content. This is usually a good thing and is ideal where continuity and consistency of content across languages is desired. It can be worked around, but in principle this way of doing translations is not generally suitable, for example, for Wikipedia articles, which usually are totally independent of each other. Even if they originally start as a translation from a different language, they usually begin living their own independent life from the original version. With Translate, the original page is always the main version, and new content cannot be developed in translated versions.

With these limitations in mind there are still plenty of cases where this feature is a perfect match. Most, if not all, user documentation falls into this category as well as news-like content that does not change once written. If you have the Translate extension already installed and access rights configured, try creating a page and wrapping the whole text inside  and follow the links, or follow the tutorial How to prepare a page for translation.

Local interface translation in multilingual wikis
One thing almost every wiki has customized is the sidebar. It is possible to create a message group for the custom sidebar messages and also for other local interface customisations.

One interesting expansion is the multilingual pages or templates built with the magic word. The translatewiki.net main page and some Wikimedia Commons templates are good examples of this. The magic word is an alternative to the content translation feature and it is more suitable to mark-up heavy pages just like the translatewiki.net main page. Another nice feature is that the language of the page automatically follows the user interface language, so there is no need for a language bar, although you might want to have an interface language selector instead.

Setting this up is currently a bit more complicated than content translation and needs software configuration, but it is all covered in the tutorial How to make an interface message group.

Software translation
The Translate extension is a good fit for translating software interface messages. At translatewiki.net, it is used to translate tens of software products from games to web applications. The Translate extension supports reading and updating translations from and to common formats used in web development including Java properties, Gettext and Yaml files.

Change tracking is also available for externally tracked files, because internally the extension uses a cached derivative version of the localisation files where the source text and its translations are stored, instead of using them directly in their original format. Translation administrators can either use the web interface or a command line interface to check new message definitions and "fuzzy" (request update of) translations when they need updating. This works regardless of the underlying file format or version control system (if any).

With simple command line tools, translation administrators can easily import even a large set of existing translations and with just one command they can export all translations in the correct format and in the correct directory structure. You can export directly to your VCS repository checkout, where you can easily commit changes and new files.

For translators and translation administrators

 * How to translate [Tutorial]
 * Translation best practices
 * Statistics and reporting
 * Quality assurance
 * Message group states
 * Off-line translation
 * [In progress] Glossary

For translation administrators

 * How to prepare a page for translation [Tutorial]
 * Page translation administration
 * Interface message groups (localised sidebar, main page and templates) [Tutorial]
 * [In progress] Message group management
 * YAML configuration format
 * How to write YAML configuration for file based message groups [Tutorial]

Reference documents for developers

 * Installation
 * Configuration
 * [In progress] Translate explained for developers
 * Hooks
 * [In progress] Message groups
 * [In progress] File format support
 * Translation aids
 * [Unwritten] Web API
 * Translation memories

Related

 * Translation notifications
 * Localisation/Tutorial: General localisation tutorial for developers, for use at hackathons & trainings
 * Extension:TranslateSvg: Adds support for translating SVG files
 * Universal Language Selector: Provides webfonts and input methods

Todo

 * Implementation on Meta: m:Meta:Translate extension.
 * See translate-doc for specific tasks.