Помогите перевести Diátaxis¶
Если вы хотите помочь перевести Diátaxis на свой язык, я буду очень рад.
Сейчас из других языков доступен только польский.
Идёт работа над переводами на другие языки, в том числе французский, итальянский, бразильский португальский, упрощённый китайский, корейский и японский. По запросу можно добавить и другие языки; готовые переводы тоже будут опубликованы здесь.
Как только перевод будет готов, я опубликую его на https://diataxis.fr.
Как переводить Diátaxis¶
Удобнее всего участвовать в переводе через Transifex; для этого потребуется учётная запись.
Как вступить в языковую команду¶
Откройте страницу Diátaxis в Transifex и выберите Join this project (Присоединиться к проекту).
Там можно подать заявку в команду переводчиков нужного языка. Я получу уведомление о заявке и добавлю вас в команду. До этого ваша панель Transifex будет оставаться пустой.
Обязательно напишите мне по электронной почте: уведомления Transifex приходят не сразу.
Перевод¶
После добавления в команду вы увидите список доступных языков. Просматривать можно все, но переводить — только на тот язык, в команду которого вы вступили.
Перевод выполняется страница за страницей, а внутри страницы — строка за строкой, небольшими фрагментами общего текста. Сохранённая строка помечается как переведённая. Я получаю уведомления об изменениях, периодически загружаю их в репозиторий и публикую новую версию сайта.
Ссылки и имена файлов¶
Не переводите имена файлов и идентификаторы ссылок Sphinx. Например, в строке :doc:`tutorials` - learning-oriented experiences слово tutorials нужно оставить без изменений.
Сейчас адреса страниц не переводятся, поэтому французская страница Tutoriels будет находиться по адресу https://diataxis-translated.readthedocs.io/fr/tutorials/.
Это не слишком изящное решение, но пока я не знаю альтернативы.
Подстановочные маркеры¶
В Transifex вам иногда будут встречаться пронумерованные подстановочные маркеры вместо служебных ссылок Sphinx. Эти маркеры необходимо сохранять в переводе.
Практика перевода¶
С чего начать¶
Первой страницей для перевода на новый язык должна быть страница Начните здесь (в Transifex страницы называются ресурсами). С неё же стоит начинать работу, если вы присоединились к уже существующему переводу.
Эта страница целиком описывает Diátaxis и объединяет почти все специальные термины и словоформы, которые встретятся в других разделах. Она служит хорошим ориентиром для общих переводческих решений.
К чему стремиться¶
Я хочу, чтобы для ключевых терминов находились удачные соответствия средствами самого языка. Даже если в вашем языке принято заимствовать английское how-to, в переводе Diátaxis следует подобрать собственный термин и использовать его последовательно.
Для меня смысл и убедительность идей Diátaxis гораздо важнее, чем сохранение их английской формулировки. Я вовсе не жду и не хочу буквального перевода. Текст должен быть естественным и непринуждённым: используйте естественные для вашего языка конструкции, а если в нём есть более удачные метафоры или обороты — выбирайте их. Я буду рад обсудить такие вопросы.
Учитывайте контекст¶
Не теряйте из виду общую картину. При переводе строка за строкой легко сосредоточиться на отдельных фрагментах и упустить контекст.
Исправление и обновление переводов других¶
Я рассчитываю, что над переводом будут совместно работать несколько людей, и их мнения о переводе отдельных строк могут различаться.
Если вы видите явную ошибку — в орфографии, грамматике или пунктуации, потерю смысла либо неестественную формулировку, — исправьте её.
Если вопрос сложнее и касается стиля или требует субъективного решения, сначала лучше его обсудить. Для этого есть форум проекта в Transifex, или можно обратиться ко мне.
Материалы перевода принимаются на условиях международной публичной лицензии Creative Commons Attribution-ShareAlike 4.0.