Crowdin In-Context tool allows to translate texts directly within the actual web application. In such a way, the best translation quality is maintained.
В контексте локализация связана с фактическим проектом, созданным в Crowdin, где хранятся конвертируемые файлы.
Этот инструмент делает все тексты в веб-приложении такими, которие можно редактировать. И еще процесс перевода можно увидеть в реальном времени. Даже динамическую часть приложения и строчек с заполнителями можно переводить в такой способ.
Technical Overview
Crowdin In-Context works with the help of one line Javascript snippet and the pseudo-language package. It creates the pseudo-language package based on the localization files uploaded to your project, which later will be integrated to your application as an extra-localization language.
Integrated pseudo-language contains some special identifiers instead of the original texts, thus when switching your app to that language, all of the labels are converted to the special identifiers. Javascript searches for those identifiers and replaces them with the editable labels. In such a way, the translator does not see any difference between the live app and the app with the integrated Crowdin In-Context tool. However, the tool defines what part of the app is translatable and provides all means to let the translator localize in context.
The translation is made on the minimized regular Crowdin Editor with all the functionalities (TM, machine translation, approve/vote option, comments, terms) provided. Thus, it is easier to review the translations for the proofreaders and assure the quality.
Интеграция
There are two common approaches to integrate Crowdin In-Context with your application: - Staging or translation environment. Если вы не считаете нужным привлекать конечных пользователей сайта к переводу и не предпочитаете иметь “режим перевода” на продакшне, интеграция Crowdin In-Context в отдельную среду для перевода будет отличным решением. - Production environment. Crowdin In-Context does not require any code changes in your application, so it can be used even on production. You decide how to turn it on and for what segment of users it can be activated. The feature that enables the translation mode can be either hidden, There were cases when the translation mode was enabled as an extra language.
Follow step by step the integration setup, which you can find in the Project Settings, In-Context tab.
After the successful integration and your app refreshment, you should see the invitation dialog and Crowdin login box.
Необязательные Параметры
Вы можете добавить эти параметры в _jipt массив в фрагменте конфигурации.
Предварительная загрузка строк
_jipt.push(['preload_texts', true]);Speeds up dynamic content displaying within the In-Context tool by preloading all source strings. Automatically disabled for the large projects (5000+ strings). Acceptable values: true, false.
Translation Button Always Visible
_jipt.push(['touch_optimized', true]);This option is enabled on touchscreens by default and makes the translation button next to each translatable string permanently visible, as opposed to showing on hover. Acceptable values: true, false.
Before Commit Callback
_jipt.push(['before_commit', function(source, translation, context, language_code) {
return status_obj;
}]);Функция для проверки предложения перед совершением.
| Параметры | |
| источник | Исходный текст |
| перевод | Текст перевода |
| context | Источник строки контекста |
| language_code | Код языка (код языка) |
| Возвращать значения | |
| status_obj | Object. The status_obj.status may be "ok", "error" or "corrected". In case of error, status_obj.message contains error description. When status is "corrected", status_obj.correction contains the corrected translation |
Before DOM Insert Callback
_jipt.push(['before_dom_insert', function(text, node, attribute) {
return 'text';
}]);Функция для преобразования строки перед его подставления в DOM.
| Параметры | |
| текст | Строка для вставки |
| node необязательный | Элемент DOM, в которой должен быть вставлен текст. Может быть опущен, если текст не содержит элемент target (текст внутри браузера всплывающего окна) |
| атрибут необязателен | Атрибут элемента DOM, если текст является частью атрибута |
| Возвращать значения | |
| текст | Строка для вставки |
| false | Если функция возвращает false, то DOM не будет обновляться |
Close the In-Context Overlay Callback
_jipt.push(['escape', function() {
window.location.href = "http://app_domain.com";
}]);If defined, users can close In-Context overlay if they don’t want to translate. Implement this feature on your side. It must change app’s language or redirect from translation environment to the production app, depending on the In-Context integration approach.
