Szövegkörnyezeti beállítás

Áttekintés

Crowdin In-Context works with the help of a one-line Javascript snippet and pseudo-language package. It creates a pseudo-language package based on the localization files uploaded to your project, which later will be integrated into your application as an extra localization language.

Az integrált látszat-nyelv néhány speciális azonosítót tartalmaz az eredeti szövegek helyett, így amikor az alkalmazást erre a nyelvre váltja, az összes címke a speciális azonosítókká konvertálódik. Javascript searches for those identifiers and replaces them with editable labels. So, the In-context page of your web app will look the same as your application, with the only difference that translatable strings will be editable.

In-Context View

Translations are made directly in the app, with no need to open the Editor. As a simplified version of Crowdin Editor will be displayed, with all the functionality (TM, machine translation, approve/vote option, comments, terms) provided. Thus, it’s easier to make and review translations, as that can be previewed in a real context.

In-Context Editor

Integráció

Kétféle megközelítés van, hogy alkalmazása a Crowdin Szövegkörnyezeti honosítással integrált legyen:

  • Átmeneti vagy fordítási környezet. If you are not planning to invite your end-users to help with translations or not considering to use a “translation mode” in your production application, integrating Crowdin In-Context to your staging or dedicated translation app environment would be a good solution.
  • Termelési környezet. A Crowdin szövegkörnyezeti honosítás nem igényli az alkalmazásában lévő kód módosítását, így még a kiadás során is használható. You decide how to turn it on and which segment of users will use it. The most common use cases are the following:
    • you can create a mirror website, that is a complete copy of your application, but under a different URL (for example, instead of crowdin.com it can be translate.crowdin.com), where translators will make translations like if it was your real application.
    • you can also add In-context as an extra language. So, when translators open your application they will be able to choose one extra language from the list, which will open In-context for them.

Follow the integration setup guide in your Crowdin project to set up In-context. The guide can be found in the left-hand panel in your project, under Resources > Integrations & API.

In-Context Tab

After the integration is successfully set up and you refreshed your application, you should be able to see the invitation dialog and Crowdin login box.

Login Window

Opcionális paraméterek

Ezeket a paramétereket hozzáadhatja a _jipt tömbhöz a konfigurációs részletben.

Szövegek előre betöltése

_jipt.push(['preload_texts', true]);

Az összes forrásszöveg előre betöltésével gyorsítja a dinamikus tartalom megjelenítését a Szövegkörnyezeti eszközön belül. Automatikusan le van tiltva a nagy projekteknél (5000+ sor). Az elfogadható értékek: true, false.

Fordítás gomb mindig látható

_jipt.push(['touch_optimized', true]);

Ez az opció az érintőképernyőkön alapértelmezés szerint engedélyezve van, és az egyes lefordítható karakterláncok melletti fordítógombot állandóan láthatóvá teszi, ellentétben a lebegőpontos megjelenítéssel. Az elfogadható értékek: true, false.

Véglegesítés előtt visszahívás

_jipt.push(['before_commit', function(source, translation, context, language_code) { return status_obj; }]);

Függvény a javaslat jóváhagyására a véglegesítés előtt.

Paraméterek
sourceForrásszöveg
translationFordítási szöveg
contextForrás-karakterlánc szövegösszefüggés
language_codeCélnyelv kódja (nyelvkódok)
Visszatérési értékek
status_obj Objektum. A status_obj.status "ok", "error" vagy "corrected" lehet. Hiba esetén a status_obj.message tartalmazza a hiba leírását. Ha az állapot "corrected", a status_obj.correction tartalmazza a korrigált fordítást

Mielőtt DOM-ba illeszti visszahívás

_jipt.push(['before_dom_insert', function(text, node, attribute) { return 'text'; }]);

Függvény a karakterlánc átalakításához, mielőtt az a DOM-ba beillesztésre kerülne.

Paraméterek
textBeillesztendő szöveg
node
opcionális
DOM elem, amelybe a szöveget be kell illeszteni. May be omitted if the text does not have a target element (text inside the browser's pop-ups)
attribute
opcionális
The attribute of DOM element, if the text is part of an attribute
Visszatérési értékek
textBeillesztendő szöveg
falseHa a függvény false értéket ad vissza, a DOM nem lesz frissítve

Szövegkörnyezeti fedvény bezárása visszahívás

_jipt.push(['escape', function() { window.location.href = "http://app_domain.com"; }]);

Ha definiálva van, a felhasználók bezárhatják a szövegkörnyezeti fedvényt, ha nem akarnak fordítani. A saját oldalán vegye fel ezt a funkciót. It must change the app’s language or redirect from translation environment to the production app, depending on the In-Context integration approach.

Close Login Window

Hasznos volt ez a cikk?