Документация

Редактирование переводов

Magic Translate автоматически переводит ваш текст, но вы можете самостоятельно изменить любой перевод на magictranslate.io. Используйте его, чтобы исправить неправильный перевод, сохранить название продукта или привести его в соответствие с формулировкой вашего бренда.

Редактирование перевода

  1. Откройте переводы. В нем перечислены все тексты, переведенные вашим приложением, по языкам.
  2. Выберите язык, затем нажмите карандаш рядом с переводом, который хотите изменить.
  3. Отредактируйте текст и нажмите «Сохранить изменения».

Отредактированные переводы помечены как Отредактированные вами. С этого момента ваше приложение получает новый текст, и редактирование перевода не засчитывается в ваше использование.

Чтобы вернуться к переводу AI, нажмите кнопку «Сбросить» рядом с отредактированным переводом.

В текстах с переменными (React, Angular, Vue, JavaScript) отображаются заполнители, такие как {0}, в которые ваше приложение вводит значение. Сохраняйте все заполнители в переводе, причем каждый из них так же часто, как и в оригинале. Их можно переместить туда, где они нужны предложению.

Отредактируйте один раз использование текста

Отредактированный перевод применим ко всем местам, где в приложении отображается этот текст. Чтобы перевести один и тот же текст в одном месте по-разному (например, кнопку Сохранить при оформлении заказа), присвойте этому месту id:

// React, React SSR and Vue
<T id="checkout-save">Save</T>;
t('Save', { id: 'checkout-save' });
<!-- Angular -->
<t id="checkout-save">Save</t>
<button [title]="'Save' | t: { id: 'checkout-save' }"></button>
<!-- JavaScript -->
<t data-t-id="checkout-save">Save</t>

Идентификатор получает отдельную строку в Translations, помеченную идентификатором, которую вы редактируете, как и любую другую. Пока вы этого не сделаете, в нем будет отображаться перевод текста, в том числе внесенные вами изменения, если вы его внесли.

Идентификатор означает само по себе, а не текст. Если вы измените текст в коде, в строке отобразится новый текст, а отредактированный перевод сохранится. Места, имеющие общий идентификатор, делятся своим переводом, поэтому присвойте каждому месту, которое вы хотите перевести, свой идентификатор.

Идентификатор принадлежит вашей учетной записи, и вы редактируете его отдельно для каждого языка.

Идентификаторы могут содержать до 128 символов. Пустой или более длинный идентификатор игнорируется: клиент регистрирует ошибку и переводит текст в обычном режиме. Идентификатор не требует дополнительных затрат: его текст переводится и засчитывается для использования только один раз, сколько бы идентификаторов его ни использовало.

Когда ваше приложение показывает изменение

Приложения, которые переводят в браузере, отображают новый текст при следующей загрузке страницы.

Страницы, переведенные на сервере с помощью предварительного рендеринга React SSR, Next.js или Angular, сохраняют старый текст до тех пор, пока он не будет снова отображен. Чтобы снова отобразить их автоматически, добавьте веб-хук.

Вебхуки

Откройте страницу своей учетной записи и добавьте URL-адрес в разделе Webhooks. Каждый раз, когда вы сохраняете или восстанавливаете перевод, Magic Translate отправляет запрос POST на каждый URL-адрес со следующим текстом:

{ "event": "translations.changed" }

Чтобы снова развернуть сайт на Vercel, создайте deploy hook в настройках проекта и добавьте его URL-адрес в качестве веб-хука. Другие хосты, такие как Netlify и Render, предлагают аналогичную сборку hooks.

URL-адреса Webhook должны начинаться с https://. Можно добавить до 10.