Перевод документации Docusaurus на другой язык без изменений в MDX и коде
Упакуйте папку docs в ZIP, загрузите её и скачайте переведённые файлы, готовые для вставки в i18n/<locale>/docusaurus-plugin-content-docs/current. Строки импорта, Tabs и другие компоненты, разметка admonition, блоки кода и ссылки остаются нетронутыми; заголовки, sidebar_label, описания и основной текст переводятся. Первая часть бесплатно без регистрации; до 1,000,000 символов текста — $5 (разовый платёж).
- Строки import, export и JSX-компоненты переносятся в исходном виде
- Метки admonition (:::note, :::tip) сохраняются, текст внутри переводится
- Front matter: title, description и sidebar_label переводятся; id, slug и sidebar_position сохраняются
- Якоря заголовков вроде {#install} сохраняются, чтобы ссылки продолжали работать
- Та же структура папок в ZIP-архиве; изображения копируются без изменений
i18n в Docusaurus без копипаста
Docusaurus ожидает копию каждого документа в папке локали — переведённую и с теми же именами файлов. Делать это вручную или скармливать чат-боту файл за файлом слишком долго, а из-за разметки MDX любая ошибка обходится дорого: случайно переведённое имя импорта или изменённый проп ломают сборку. Этот инструмент переводит только то, что видят читатели, копируя всё остальное напрямую из ваших файлов.
Инлайн-код, адреса ссылок, пути к изображениям и MDX-выражения {expressions} перед отправкой на перевод заменяются специальными маркерами и возвращаются на место после, поэтому нейросеть их даже не видит. Чистые строки с JSX вроде <Tabs> или <TabItem value="mac"> пропускаются. Блоки кода пропускаются целиком вместе с комментариями.
Что делать после скачивания
- Распакуйте архив и скопируйте содержимое папки docs-<locale> в i18n/<locale>/docusaurus-plugin-content-docs/current
- Запустите команду docusaurus write-translations для меток темы и названий категорий бокового меню (они хранятся в JSON)
- Запустите сайт с флагом --locale <locale> и проверьте страницы
- Исправьте абзацы, указанные в файле предупреждений (warnings), если он появился
Что не входит в перевод
Названия категорий в боковом меню, текст в навигационной панели и подвале хранятся в JSON-файлах, которые создаются командой write-translations; их можно перевести через наш инструмент для файлов локализации. Посты блога переводятся так же, как и docs: упакуйте папку blog в ZIP и загрузите отдельной задачей либо вместе с docs в одном ZIP-архиве.
Как работает инструмент, сколько он стоит и как обрабатываются ваши файлы — на странице Перевод документации Markdown; цены на все инструменты — на странице цены.
Обновлено
Вопросы и ответы
Соберётся ли проект без ошибок?
Импорты, компоненты, пропсы, код и ссылки копируются напрямую из ваших файлов — а ведь именно на них обычно ломается сборка MDX. После копирования запустите сборку один раз и загляните в файл предупреждений, если он есть.
Переводятся ли блоки admonition?
Строки :::note и ::: сохраняются в исходном виде, а текст между ними переводится.
Какой объём помещается в одну задачу?
До 1,000,000 символов текста (примерно 300 страниц) за $5. Код и ключи front matter не учитываются.
Можно ли сначала проверить работу на нескольких файлах?
Да. Первая часть переводится бесплатно и отображается на экране, а задача объёмом до 40 абзацев полностью бесплатна.