Справка:Расширение:Перевод/Пример страницы для перевода
Документация для Расширение:Translate
Переводчикам (главная страница справки)
- Как переводить
- Практические советы
- Статистика и отчёты
- Качество переводов
- Состояния группы сообщений
- Перевод в оффлайне
- Словарь терминов
Администраторам перевода
- Как подготовить страницу к переводу
- Управление переводом страницы
- Перевод неструктурированных элементов
- Управление группами сообщенй
- Move translatable page
Сисадминам и разработчикам
Добро пожаловать! После прохождения этого обучающего курса вы узнаете, как создавать и управлять переводимыми страницами, используя расширение перевода. Мы постарались сделать этот обучающий курс как можно более коротким, показав при этом все основные концепции и шаги. После обучения вы сможете воспользоваться более подробной документацией о возможностях перевода страниц.
Шаг 1: Перед началом
В рамках этого курса предполагается, что расширение перевода уже установлено и настроено. Возможно, у вас уже есть на примете статья, которую неплохо было бы перевести на другие языки, или вы можете использовать представленную ниже тренировочную страницу для отработки шагов в своей собственной вики.
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.
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. Перейдите на страницу [[Fréttinga]] в своей вики нажмите кнопку создания страницы.
- 2. Поместите в поле редактирования вышележащий текст и сохраните страницу.
Шаг 2: Подготовка
Теперь у нас есть страница с каким-то текстом.
Если страница всё ещё часто подвергается изменениям, стоит дождаться, когда изменения замедлятся до нормального уровня и только тогда добавить её в систему переводов. Это следует иметь в виду для того чтобы снизить нагрузку на переводчиков, поскольку им придётся переводить все изменения.
The page is ready for translation ? So let's see how to request translation :
- 3. Отредактируйте [[Fréttinga]]
- 4. Разметьте всё содержимое тегами
<translate>...</translate>, как показано ниже - 5. Сохраните страницу
<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-->, расширение сделает это за вас.
Шаг 3: Включение переводов
После сохранения страницы, вы увидите вверху страницы ссылку, гласящую «Отметить эту страницу для перевода» — или «Эта страница содержит изменения, которые не были отмечены для перевода.», если вы не входите в группу администраторов перевода. Если вы администратор перевода, кликните по ссылке «Отметить эту страницу для перевода». Страница автоматически разобьётся на 4 блока перевода. Первый — заголовок страницы, второй — это первый абзац, третий — это заголовок второго абзаца, и четвёртый — это текст второго абзаца. Это базовые правила переводимых статей: каждый блок независим; он должен переводиться целиком; изменения на странице требуют обновления всего блока. Блоки можно изменять и удалять.
Также существует просмотр шаблона страницы; об этом будет рассказано в следующих шагах. Вы можете давать названия блокам перевода, но в этом примере мы решили оставить установки по умолчанию.
- 6. Нажмите ссылку «Отметить страницу для перевода»
- 7. Удостоверьтесь, что страница разбита на три блока правильно
- 8. Нажмите кнопку «Отметить эту версию для перевода»
- 9. Вернитесь на страницу
(reminder: you have to be a Translation administrator for this)
- 9. Return to the page
Теперь вы увидите вверху страницы новую ссылку — «Переведите эту страницу», — которая и позволяет переводчикам работать над переводом этой страницы. Вам стоит взглянуть на руководство по переводу, где эта страница используется в качестве примера, и попробовать создать несколько переводов. Затем вернитесь сюда для изучения последующих шагов.
Шаг 4: Внесение изменений
Understanding how changes are impacting translations and translations units
Отслеживание изменений на странице — очень важная задача, так что давайте внесём некоторые изменения и посмотрим, как это работает. Когда вы открываете страницу для редактирования, вы видите, что в ней появились маркеры <!--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.
Когда вы удаляете блок, удалите также маркер. Когда добавляете новые параграфы, новые маркеры будут добавлены программно. Не пытайтесь делать это вручную, это может привести к сбою. Маркеры, которые вы удалили, в других существующих переводах будут также автоматически удалены ботом.
Если вы сделали небольшие изменения в существующем переводе блока (добавили несколько слов или ссылку на параграф), сохраните маркер. Если вы изменили целый параграф (удалили или переработали его), удалите маркер. Таким образом, переводчики будут знать, требуется ли проверить устаревший перевод или выполнить новый.
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. Сделайте несколько дополнений, как показано выше
- 11. Нажмите на ссылку «отметки о переводе» вверху
- 12. Посмотрите на изменения
- 13. Нажмите на кнопку «Отметить эту версию для перевода»
- 14. Вернитесь на исходную страницу
(reminder: you have to be a Translation administrator for this)
- 14. Return to the original page
Если вы создали переводы на предыдущих шагах, то ссылки на них вы можете увидеть вверху страницы. Вы также можете заметить, что перевод актуален не на 100%. Если вы перейдёте в режим перевода, вы увидите, что этот элемент помечен как требующий обновления.
Устаревшие переводы подсвечиваются розовым фоном; пользователю сообщается, что перевод неполон
Режим просмотра шаблона переводимой страницы поможет вам увидеть, какие части страницы постоянны во всех языковых версиях (под «шаблоном переводимой страницы» понимаются её части, лежащие вне меток перевода), а также покажет вам, были ли какие-либо элементы перемещены или удалены.
Обновление переведённой страницы может происходить с небольшой задержкой, поскольку существует целая очередь страниц, требующих обновления.
Теперь вы знаете основные моменты, но этот курс содержит ещё некоторые детали, которые вы можете использовать в работе.
Шаг 5: Добавление других вики-элементов
Adding an image, a category and a list with translation markers
Сейчас у вас есть статья для перевода, но она довольно уныла. Давайте добавим изображения и некоторые другие элементы, чтобы она больше походила нв вики-страницу, а также посмотрим, как эти элементы взаимодействуют с сервисом перевода.
Мы также удалили абзац, включая его маркер блока, и заменили его списком, чтобы вы могли посмотреть, что из этого выйдет.
- 15. Добавьте изображение, категории и списки на страницу, как показано ниже
- 16. Сохраните страницу
- 17. Перейдите по ссылке «отметки о переводе» вверху страницы
- 18. Убедитесь, что изменения выглядят так, как вы предполагали
- 19. Нажмите на кнопку «Отметить эту версию для перевода»
- 20. Вернитесь на исходную страницу
<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 exemple) 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. Перейдите по ссылке «Перевести эту страницу» вверху страницы
- 22. Выберете язык «qqq - Page documentation»
- 23. Нажмите на имя сообщения, содержащее текст «Типичный вид Fréttinga»
- 24. Напишите «Описание изображения» и нажмите «Сохранить»
Now, the documentation "Description of an image" is shown next to the to-be-translated-title of the image.
О ссылках
[[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
Переводимые страницы (включая все их переводы) также можно переименовать. Данная операция может охватывать большое количество страниц, поэтому она занимает определённое время. Можно удалить страницу целиком, включая все переводы, или только одну из её переводных версий. Эти функции доступны в том же разделе, что и в случае остальных страниц.
Managing all wiki's pages translations with Special pages
Special:PageTranslation выдает список всех переводимых страниц в системе. Также возможно дестимулировать перевод страниц. Это предотвратит их отображение в большинстве списков, но не воспрепятствует переводу.
-
Служебная страница со списком страниц, доступных для перевода
-
Переименование страницы
-
Удаление страницы
Now, you know !
Итак, вы создали переводимую страницу и применили к ней все распространенные действия, которые возможны в случае переводимых страниц.
Going deeper ?
Для получения дополнительной информации, или при желании более глубокого понимания данного механизма, приглашаем познакомиться с детальной документацией по механизму перевода страниц. В ней также обсудаются различные способы работы со ссылками, категориями и шаблонами, плюсы и минусы сегментирования текста на крупные и малые переводимые блоки.