도움말:확장기능:번역/문서 번역 예시

This page is a translated version of the page Help:Extension:Translate/Page translation example and the translation is 39% complete.
Outdated translations are marked like this.
확장기능:번역 의 사용법의 해설 영상.

어서오세요! 이 튜토리얼을 끝내고 나면 번역 확장기능 을 이용하여 어떻게 번역하는지 알게 될 것입니다. 가장 기본적인 개념과 작업을 설명할 수 있을정도로 이 튜토리얼을 최대한 짧게 작성하였습니다. 이 튜토리얼을 마친다면 페이지 번역 기능을 사용할 수 있습니다.

There is also a set of video tutorials that parallel part of this tutorial that you can use to help learn how to use the Translate extension:

Please note:
  • Consequently, we will consider that you are a Translation administrator on your wiki (...if you can, you should declare yourself now !), otherwise you may not access to some of the links/pages described here.
  • Remember also, that this is only a simple tutorial. Example of marked code prepared by best practices you can see here
Let's go!

첫 번째, 시작하기 전에

 
첫 문서

이 튜토리얼에서는 번역 확장기능이 이미 설치 및 설정되어 있는 것을 상정하고 있습니다. 번역이 필요한 문서가 이미 머릿속에 있는지는 모르겠지만 아래의 예시 문서를 사용할 수도 있습니다. 아래의 예시에서는 이 튜토리얼의 순서를 자신의 위키에서 시험할 수 있습니다. 번역이 필요한 문서를 이미 떠올릴 수도 있고 아래의 예시의 문서로 연습할 수도 있습니다. 아래의 예시에서는 이 튜토리얼의 순서를 자신의 위키에서 시험할 수가 있습니다.

이 문서에서는 가공의 자치체 Fréttinga 에 대해서 설명하고 있습니다.

Here is the wikicode associated to it :

Fréttinga is a small municipality in MungoLand, located on the BaMungo island.
It hosts a population of about 400 people. It has some agriculture and fishing.
Tourists like to visit it in the summertime.

== Services ==

It doesn't have many services. There is a shop, and a car ferry visits the island
from the mainland once a day.
  • 1. Go to the page [[Fréttinga]] in your wiki (or a draft page) and click create.
  • 2. Paste the above content and save it.

두 번째, 준비

 
이 준비가 완료되면 ‘이 문서를 번역 대상으로 지정’ 혹은 ‘이 문서에는 번역 대상으로 지정되어 있지 않습니다’라는 링크가 나타납니다.

이제 문장이 있는 문서가 생성되었습니다. 변경 사항이 많았거나 대담하게 변경될 가능성이 있는 경우, 번역 시스템을 추가하기 전에 편집 상황이 보통 정도에 도달할 때까지 기다리는 쪽이 좋을지도 모릅니다. 이건 모든 변경 내용에 따르는 힘든 작업을 번역자에게 넘겨주는 것을 피하기 위해서입니다.

번역 내용이 많거나 대담하게 편집될 가능성이 있을 경우에 번역 시스템을 추가하기 전에 편집 상황이 보통 정도로 자리잡을 때까지 기다리는 쪽이 좋을지도 모릅니다. 이것은 모든 변경 내용에 따라가는 매우 대단한 작업을 번역자에게 시키는 것을 피하기 위해서입니다.

The page is ready for translation ? So let's see how to request translation :

  • 3. Edit [[Fréttinga]]
  • 4. Wrap the whole content inside ‎<translate>...‎</translate> tags as shown below
  • 5. Save the page
<translate>
Fréttinga is a small municipality in MungoLand, located on the BaMungo island.
It hosts a population of about 400 people. It has some agriculture and fishing.
Tourists like to visit it in the summertime.

== Services ==

It doesn't have many services. There is a shop, and a car ferry visits the island
from the mainland once a day.
</translate>

당신은 모든 부분에 <translate> 태그, 또는 <!--T:1-->와 같은 마커를 추가할 필요가 없습니다.

You should never add markers like <!--T:1--> yourself; the extension does it for you in the next step.

세 번째, 번역을 유효화

문서를 저장하면 당신이 변역 관리자일 경우에는 문서 위에 ‘이 문서를 번역 대상으로 지정’이라는 링크가 표시됩니다. 그렇지 않은 경우에는 ‘이 문서에는 번역 대상이 없습니다.’라는 링크가 표시됩니다. 당신이 번역 관리자라면 ‘이 문서를 번역 대상으로 지정’이라는 링크를 클릭해주세요. 문서는 자동적으로 네 개의 번역 단위로 분할됩니다. 첫 번째 번역 단위는 문서 이름, 두 번째는 첫 단락, 세 번째는 두 번째 단락의 표제어, 네 번째는 두 번째 단락의 본문입니다. 이것들은 번역 대상 문서의 기초적인 항목이며, ‘각 번역 단위는 독립하고 있다’ · ‘정리해서 번역할 수 있다’ · ‘문서 본문의 변경은 번역 단위마다 추적된다’라는 세 개의 특징이 있습니다. 번역 단위는 재배치하거나 삭제할 수도 있습니다. If you are a translation administrator, then click on the "Mark this page for translation" link. The page has been automatically split into four translation units. The first unit is the title of the page, the second is the first paragraph, the third is the header of the second paragraph, and the fourth is the text of the second paragraph. These are the basics items of translatable pages: each unit is independent; it can and must be translated as a whole; changes to the page content are tracked into the unit level. Units can be rearranged or deleted.

There is also a view of the page translation page template; this will be covered in later steps. You can give names to the translation units, but in this example, we choose to stick with the defaults.

  • 6. Click the "Mark this page for translation" link
  • 7. Ensure that the page body is split into three units correctly
  • 8. Click the "Mark this version for translation" button (reminder: you have to be a Translation administrator for this)
  • 9. Return to the page

Now you will see a new link at the top, "Translate this page", that lets translators translate the page. You might have a look at the translation tutorial which uses this page as an example and try out few translations now. Then return here for the next step.

네 번째, 변경하기

Understanding how changes are impacting translations and translations units

 
변경 내용을 처리하는 화면

Tracking changes is a very important feature, so let's make some changes and see how it works. When you open the page for editing you will see that it has been modified with markers like <!--T:1-->. These are added by the extension and help it identify which unit is which. This allows you to rearrange and edit those units. When editing the page, the markers should be left alone and their position in relation to the unit they belong to should not be changed. When moving a unit, move the unit marker, too.

When deleting a unit, delete the marker too. When adding new paragraphs, new markers will be added by the software. Do not try to do this manually, it may confuse the software. Markers you have deleted will also be automatically deleted by the bot in the existing translations.

If you do minor changes to an existing translation unit (adding a few words or a link to a paragraph), keep the marker. If you change a whole paragraph (delete and rebuilt it), delete the marker. This way, translators will have different tasks, between reviewing a fuzzy translation or create a new translation.

let's modify something !

Here is what you will do :

<languages /> <translate> <!--T:1--> Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. It has marvelous beaches with a lot of seagulls. == Services == <!--T:2--> <!--T:3--> It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. In 2009 January the roof of the church in the island fell down. It was rebuilt collaboratively the following summer. </translate>

  • 10. Make some additions as highlighted above
  • 11. Click the "marked for translation" link at the top
  • 12. Observe the changes
  • 13. Click the "Mark for translation" button (reminder: you have to be a Translation administrator for this)
  • 14. Return to the original page

If you made translations as suggested in the previous step, you can now see those translations linked at the top of the page. You will also see that the translation is not 100 % up to date. If you go to the translation view, you see that the unit is marked as in need of updating.

오래된 번역은 분홍 배경으로 강조 표리됩니다. 번역이 불완전한지를 사용자가 알기 쉽습니다.

번역 서식 표시에서는 문서의 어느 부분이 전체 언어판에서 공통되는 정수인지를 이해하는 것을 지원합니다 (‘translation page template’는 번역 태그 외측의 부분의 것). 그리고, 번역 단위가 이동 및 제거된 경우도 알려줍니다.

다수의 문서를 번경할 가능성이 있기 때문에 번역 포함판을 모두 갱신하는 것에 조금 시간이 걸립니다.

위가 기초 지식이지만 이 튜토리얼에서는 자주 직면하는 사항에 대해서 한층 더 설명합니다.

다섯 번째, 다른 위키 요소를 추가

 
최종 결과

Adding an image, a category and a list with translation markers

You have a basic translatable page now, but it is very dull. Let's add an image and some other stuff to make it look more like a normal wiki page and see how those elements interact with translation.

그리고, 단위 마커를 포함하는 단락을 제거해서 목록에 대체되면 어떨지를 보세요.

  • 15. Add an image, a category and a list to the page as shown below
  • 16. Save the page
  • 17. Click the link "marked for translation" at the top of the page
  • 18. Verify that the changes look as intended
  • 19. Click the "Mark this version for translation" button
  • 20. Return to the translatable page

<languages /> [[File:Torsö.jpg|thumb|<translate>A typical view of Fréttinga</translate>]] <translate> <!--T:1--> Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing and tourists like to visit it in the summertime. It has marvelous beaches with a lot of [[Special:MyLanguage/Seagull|seagulls]]. == Services == <!--T:2--> <!--T:3--> It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. Main events: * The roof of the church fell down in 2009 * New church was built in 1877 [[Category:Municipalities]] </translate>

문서의 번역

Allowing to translate only the picture title:

[[File:Torsö.jpg|thumb|<translate>A typical view of Fréttinga</translate>]]

Or allowing to change the image file in the translated page (for localized version for example) and the title:

<translate>[[File:Torsö.jpg|thumb|A typical view of Fréttinga]]</translate>

이미지 마크업의 대부분을 번역 단위의 밖에 한 것으로 그 부분이 번역 문서의 서식에 들어가는 것을 알것 입니다. (reminder: the translation page template doesn't change between the different translated pages) 보통은 여기에 문제가 없지만 번역자가 이미지를 번경하고 싶을 경우에 특히 이미지가 문자 정보(문자열)을 포함하고 있는 경우가 있습니다. 그 경우에는 번역 단위에 마크업 전체를 포함하는 것이 가랑 간단한 해결 방법입니다(위의 분류 내용과 마찬가지).

번역 단위의 번역이 마크업과 관계가 있을 경우에는 그것에 대해서 번역자용으로 조금 서술하는 것을 권합니다. 이것은 아래의 순서로 진행할 수 있습니다.

 
추가된 설명문은 이렇게 번역자에게 표시됩니다
  • 21. Click "Translate this page" link at the top
  • 22. Select "qqq - Page documentation" language
  • 23. Click the message name which contains the message "A typical view of Fréttinga"
  • 24. Write "Description of an image" and click "Save"

Now, the documentation "Description of an image" is shown next to the to-be-translated-title of the image.

Content of the message not translate. Use only generally understanding language (english).

링크에 대해서

[[Special:MyLanguage/Seagull]]

마찬가지로 링크에 대해서도 여러 방법이 있습니다. 사용자 인터페이스 언어에 대해서 번역판으로 자동적으로 넘겨주기(번역이 존재할 경우)되는 "[[Special:MyLanguage/Seagull]]"를 사용해왔습니다. 현재 보고 있는 문서의 언어가 아니라 사용하고 있는 인터페이스의 언어 문서로 항상 넘겨주기를 하기 위해서 이것은 궁극적인 해결책은 아닙니다. 그리고, Special:Mylanguage는 Special:WhatLinksHere (여기를 가리키는 문서)와 간섭되어 여기를 가리키는 문서가 올바르게 표시되지 않게 됩니다. Special:MyLanguage의 이점은 표시하려고 한 번역 문서가 존재하지 않을 경우에도 몇몇의 언어 문서가 항상 표시되는 점입니다.

분류에 대해서

이 예시에서는 분류 지정 전체가 번역 단위가 되고 있습니다. 이에 따라서 번역자가 [[Category:Municipalities/de]]처럼, 또는 분류에 사용하고 싶은 명명 규약에 따라서 자유롭게 변경할 수 있게 됩니다. 분류 지점이 외측에 있을 경우에는 Foo, Foo/de, Foo/ru, Foo/ta 등의 문서 모두가 같은 분류에 들어갑니다. 여기서 문제 없는 경우도 있지만 여기서 보통 사용자가 혼란스러워 합니다. 로컬에서의 명명 규칙에 대해서 번역자에게 알려주세요.

제목에 대해서

제목을 본문을 다른 요소로 취급하려면 제목과 그 후에 이어지는 단락과의 사이에 (빈 행이 없는 경우에만) 빈 행을 한 행 추가해주세요.

아래의 예시로 하나의 번역 단위밖에 못 만듭니다.

== Services ==
It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

다음 예시에서는 두 개의 번역 단위가 작성되며 그 한 쪽이 제목이 됩니다.

== Services ==

It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

공백 행을 추가하는 것으로 번역자는 언제 휴식할 수 있을지 알게 됩니다. 추가적으로 위키문법 문제를 방지합니다.

마지막으로

Operating on the whole page and its translations

It is also possible to move translatable pages including all their translations to a new name. Because many pages may need to be moved, this operation is not instant. You can delete either the whole page including all translations, or just one translated version of a page. You can access these functions from the same place they are on all other pages.

Managing all wiki's pages translations with Special pages

Special:PageTranslation lists all the pages in the system. Besides giving you an overview of all translatable pages, it is also possible to discourage pages from translation. This hides the page from most lists. It does not prevent further translations.

Now, you know !

번역 대상 문서를 작성하게 되고 번역 대상 문서로 실행 가늠한 자주 사용되는 조작을 모두 체험했습니다.

Going deeper ?

그 외의 정보를 얻고 싶은 경우나 기능을 더욱 더 깊게 이해하고 싶은 경우는 이어서 문서 번역 기능에 대한 자세한 설명문서를 읽어보세요. 그 문서에서는 링크, 분류, 틀을 취급하는 여러 방법이나 번역 단위의 크기에 대한 찬반 토론과 같은 토론도 기재되어 있습니다.

같이 보기