Помогите перевести Diátaxis¶
Если вы хотите помочь перевести Diátaxis на ваш язык, это будет очень кстати.
В настоящее время единственным доступным языком является польский.
Выполняется перевод на другие языки, включая французский, итальянский, португальский (Бразилия), китайский (упрощенный), корейский и японский. Другие могут быть добавлены по запросу и будут опубликованы там, когда будут добавлены новые переводы.
Как только перевод будет завершен, я опубликую его на https://diataxis.fr..
Руководство по переводу¶
Лучший способ внести свой вклад в перевод — через Трансифекс, где вам понадобится учетная запись.
Присоединение к языковой команде¶
Перейдите в Страница Диатаксиса на Transifex и выберите Присоединяйтесь к этому проекту.
Там вы найдете возможность присоединиться к команде переводчиков на интересующий вас язык. После этого я получу уведомление о вашем запросе на вступление и добавлю вас в команду. Ваш собственный Панель управления Трансифекс останется пустым, пока я это не сделаю.
Обязательно напишите мне, чтобы сообщить, потому что уведомления Transifex приходят не сразу.
Перевод¶
Как только вас добавят в команду, вы увидите обзор доступных языков. Вы можете видеть их все, но перевести можете только того, в чьей команде вы состоите.
Перевод происходит постранично, а затем построчно – небольшими фрагментами общего текста. Когда вы сохраняете строку перевода, она помечается как переведенная. Я получаю уведомления об этом и периодически помещаю их в репозиторий и публикую новую версию сайта, содержащую их.
Ссылки и имена файлов¶
Не переводите имена файлов или ссылки на Sphinx. Например, если вы видите строку :doc:`tutorials` - ориентированный на обучение опыт you need to leave tutorials как она есть.
Прямо сейчас URL-адреса страниц переводятся на не, поэтому французская страница для воспитатели будет на https://diataxis-translated.readthedocs.io/fr/tutorials/..
Это не очень элегантно, но на данном этапе я не знаю, есть ли альтернатива.
Заполнители¶
В Transifex вы иногда увидите пронумерованные символы для функциональных ссылок на Сфинкса. Ваш перевод также должен включать в себя заполнители.
Практика перевода¶
С чего начать¶
Первая страница для перевода (Transifex называет страницы «ресурсами») для нового языка должен быть Начните здесь. Он также должен быть первым, на который следует ссылаться, если вы вносите свой вклад в существующий язык.
Причина этого заключается в том, что он охватывает весь Диатаксис на одной странице и собирает вместе почти все специальные термины и формы слов, с которыми вы столкнетесь в другом месте. Это должно быть хорошее руководство по переводу решений в целом.
К чему стремиться¶
Я предпочитаю, чтобы переводы содержали хорошие переводы для ключевых терминов на собственном языке. Даже если в вашем языке принято использовать английский термин «how-to», я не хочу, чтобы переводы делали это. Они должны найти альтернативу и использовать ее последовательно.
Я гораздо больше забочусь о Значение и сила идей в Диатаксисе, чем о сохранении того, как я выразил их на английском языке. Я, конечно, не хочу и не жду буквального перевода. Переводы должны быть идиоматическими и звучать непринужденно. Используйте нативные структуры предложений и конструкции. Если в вашем языке существуют лучшие метафоры или обороты фраз, используйте их. Я буду рад обсудить эти вопросы.
Будьте в курсе контекста¶
T Обратите внимание на общую картину. Когда вы смотрите на струнные переводы, легко получить туннельное зрение и потерять понимание контекста.
Исправление и обновление переводов других¶
Я ожидаю, что перевод будет совместной работой с участием нескольких переводчиков, не все из которых могут договориться о том, как перевести ту или иную строку.
Если вы видите что-то, что явно неправильно (пеллинг, грамматика, пунктуация, потеря смысла, неидиоматический рендеринг), исправьте это.
Если это более сложно и кажется стилистическим выбором или вопросом суждения, было бы хорошо сначала обсудить это. Есть Форум Transifex для этого проекта, или вы можете задать вопрос со мной.
Переводческие взносы принимаются в рамках Creative Commons Attribution-ShareAlike 4.0 Международная общественная лицензия.