Мы рады объявить о работе над поддержкой официальных переводов документации React на другие языки. Благодаря усердным усилиям сообщества React по всему миру, React переводится на более, чем 30 языков! Их можно найти на новой странице — переводы.
\nТакже, переводы для следующих трех языков уже полностью завершены! 🎉
\nОтдельно хотелось бы поздравить Alejandro Ñáñez Ortiz, Rainer Martínez Fraga, David Morales, Miguel Alejandro Bolivar Portilla и всех участвовавших в переводе испанского перевода с тем, что они стали первыми, кто полностью перевёл основные страницы документации!
\nПо React уже проводится множество конференций и митапов по всему миру, но далеко не для всех программистов английский язык является основным. Нам бы очень хотелось поддержать местные сообщества, сделав нашу документацию доступной на наиболее популярных языках.
\nУчастники React-сообщества уже написали неофициальные переводы на китайском, арабском и корейском языках; мы надеемся, что официальный канал этих переводов упростит их поиск, и люди, не говорящие на английском языке, не останутся за бортом.
\nЕсли вам хочется помочь с переводом, посетите страницу переводов и нажмите на ссылку «Contribute» у вашего языка.
\nНе можете найти свой язык? Если хотите поддерживать форк перевода на ваш язык, тогда следуйте инструкциям в репозитории переводов!
\nЗдравствуйте! Я Nat! Я могу быть вам известна как та леди с полиэдрами. Последние несколько недель я помогала команде React координировать процесс переводов. Вот, как я это сделала.
\nПоначалу мы использовали SaaS-платформу для обработки переводов от пользователей. Для этого был даже оформлен пулреквест, и изначально я должна была закончить эту интеграцию. Но мы боялись, что из этого ничего путного не получится, а качество переводов оставит желать лучшего. В первую очередь мы хотели, чтобы переводы не отставали от основного репозитория и не оказывались на «свалке».
\nДэн смотивировал меня найти альтернативное решение, и мы натолкнулись на подход Vue к поддержке своих переводов — при помощи множества форков основного репозитория на Github. В частности, японский перевод использовал бота для проверки изменений в английском репозитории и создавал пулреквесты, когда изменения появлялись.
\nНам понравился такой подход по нескольким причинам:
\nМы начали с пробного периода для трех языков: испанского, японского и с упрощенного китайского. Таким образом мы выработали методику и приняли меры, чтобы с будущими переводами не возникало проблем. Я хотела, чтобы команды по переводам имели свободу выбора удобных им инструментов. Единственным требованием был чек-лист, описывающий порядок перевода страниц.
\nПосле пробного периода мы были готовы принимать другие переводы. Я создала скрипт, чтобы автоматизировать создание репозиториев для новых языков, а также сайт Is React Translated Yet? (А React уже переведён?), чтобы отслеживать прогресс тех или иных переводов. Уже в первый день мы начали целых 10 переводов!
\nБлагодаря этой автоматизации, последующая поддержка проекта по большей части шла гладко. Позже мы создали Slack-канал, чтобы переводчики могли удобно общаться между собой; также я выпустила руководство, которое закрепило обязанности мейнтейнеров сообщества. Платформа для общения между переводчиками себя показала отлично — к примеру, переводчики арабского, персидского и иврита смогли вместе добиться отображения текста справа налево!
\nСложнее всего было синхронизировать изменения с английской версией сайта. Сперва мы использовали бота che-tsumi, которого разработала команда японского перевода Vue, но позже решили разработать собственного бота, который бы работал бы так, как удобно нам. Если быть точной, то нас не устраивали связанные между собой ишью, которые создавались после выборочного применения новых коммитов ботом che-tsumi. А после релиза хуков так и вовсе начался полный бардак.
\nВ итоге мы решили, что вместо выборочного применения каждого коммита целесообразнее будет сливать все новые коммиты в один пулреквест где-то по разу в день. Конфликты сливаются как есть и перечисляются в пулреквесте в виде чек-листа.
\nСоздать скрипт синхронизации было довольно просто: скачать переведённый репозиторий, добавить в его удалённые репозитории оригинальный, стянуть его изменения и создать пулреквест.
\nПроблемой стал поиск места для запуска бота. Я фронтенд-разработчица и, возможно, поэтому такие сервисы как Heroku мне чужды. К слову, ещё до прошлого вторника я запускала скрипт на своём ПК вручную!
\nСамая большая загвоздка заключалась в дисковом пространстве. Каждый форк репозитория занимает около 100MB и моему компьютеру нужно несколько минут для скачивания. Форков у нас 32, а бесплатные планы большинства платформ для развёртывания, которые я рассматривала, предоставляли лишь 512MB пространства.
\nМножество раз пересчитав всё в блокноте, я пришла к решению: удалять каждый репозиторий после выполнения скрипта и ограничивать количество одновременно запущенных скриптов до того, которое могло поддержать хранилище. К счастью, dynos от Heroku имеют интернет-соединение получше моего, и они быстро скачивают даже репозиторий React.
\nБыли и другие мелкие проблемы. Я попробовала аддон Heroku Scheduler, благодаря которому мне не пришлось писать watch-код, однако он работал нестабильно. Меня охватил экзистенциальный кризис в твиттере, когда я не смогла разобраться, как отправлять коммиты из Heroku dyno. Но, в конце концов, моя внутренняя фронтенд-разработчица смогла заставить бот работать!
Само собой, боту есть куда улучшаться. В данный момент он не проверяет, есть ли открытые пулреквесты перед тем, как отправить очередной. Также ему всё ещё трудно определить точные изменения оригинала, и есть шанс пропустить места, нуждающиеся в переводе. Однако я доверяю мейнтейнерам, которых мы выбрали для решения этих проблем, да и код бота находится в открытом доступе, если кто-то вдруг решится помочь мне с данными улучшениями!
\nНаконец, мне хотелось бы выразить свою признательность следующим людям и командам:
\nИ напоследок, огромное спасибо Дэну Абрамову за то, что дал мне эту возможность, и, конечно же, за его замечательные наставления.
","excerpt":"Мы рады объявить о работе над поддержкой официальных переводов документации React на другие языки. Благодаря усердным усилиям сообщества React по всему миру, React переводится на более, чем 30 языков! Их можно найти на новой странице — переводы. Также, переводы для следующих трех языков уже полностью завершены! 🎉 Испанский: es.reactjs.org Японский: ja.reactjs.org Бразильский вариант португальского языка: pt-br.reactjs.org Отдельно хотелось бы поздравить Alejandro Ñáñez Ortiz, Rainer Martínez…","frontmatter":{"title":"А React уже переведён? ¡Sí! Sim! はい！","next":null,"prev":null,"author":[{"frontmatter":{"name":"Nat Alison","url":"https://twitter.com/tesseralis"}}]},"fields":{"date":"23 февраля, 2019","path":"content/blog/2019-02-23-is-react-translated-yet.md","slug":"/blog/2019/02/23/is-react-translated-yet.html"}},"allMarkdownRemark":{"edges":[{"node":{"frontmatter":{"title":"Introducing the New JSX Transform"},"fields":{"slug":"/blog/2020/09/22/introducing-the-new-jsx-transform.html"}}},{"node":{"frontmatter":{"title":"React v17.0 Release Candidate: No New Features"},"fields":{"slug":"/blog/2020/08/10/react-v17-rc.html"}}},{"node":{"frontmatter":{"title":"React v16.13.0"},"fields":{"slug":"/blog/2020/02/26/react-v16.13.0.html"}}},{"node":{"frontmatter":{"title":"Building Great User Experiences with Concurrent Mode and Suspense"},"fields":{"slug":"/blog/2019/11/06/building-great-user-experiences-with-concurrent-mode-and-suspense.html"}}},{"node":{"frontmatter":{"title":"Preparing for the Future with React Prereleases"},"fields":{"slug":"/blog/2019/10/22/react-release-channels.html"}}},{"node":{"frontmatter":{"title":"Introducing the New React DevTools"},"fields":{"slug":"/blog/2019/08/15/new-react-devtools.html"}}},{"node":{"frontmatter":{"title":"React v16.9.0 and the Roadmap Update"},"fields":{"slug":"/blog/2019/08/08/react-v16.9.0.html"}}},{"node":{"frontmatter":{"title":"А React уже переведён? ¡Sí! Sim! はい！"},"fields":{"slug":"/blog/2019/02/23/is-react-translated-yet.html"}}},{"node":{"frontmatter":{"title":"React v16.8: The One With Hooks"},"fields":{"slug":"/blog/2019/02/06/react-v16.8.0.html"}}},{"node":{"frontmatter":{"title":"React v16.7: No, This Is Not the One With Hooks"},"fields":{"slug":"/blog/2018/12/19/react-v-16-7.html"}}}]}},"pageContext":{"slug":"/blog/2019/02/23/is-react-translated-yet.html"}},"staticQueryHashes":[]}