Jak Gutenberg obsługuje tłumaczenia w React?

11

Przeglądałem kod źródłowy Gutenberga, na przykład dla tego i nie rozumiem, jak radzą sobie z tłumaczeniami ...

Importują to, import { __ } from '@wordpress/i18n'a następnie wykorzystują to w kodzie źródłowym speak( __( 'Block settings closed' ) );.

Czy ktoś może mi powiedzieć, w jaki sposób zarządza tłumaczeniami w ReactJS, które mają być gromadzone w normalnym pliku .po?

Podejrzewam, że mają jakiś proces kompilacji, który przechodzi przez wszystkie pliki, w tym JS i zbiera je, ale nie jestem pewien.

block-editor Bologer
źródło

Odpowiedzi:

6

W repozytorium GitHub Gutenberga można zobaczyć źródło używanego pakietu i18n. W tym źródle zobaczysz Jeda importowanego (wiersz 4 gutenberg / packages / i18n / src / index.js), a następnie wykorzystywanego do większości zadań tłumaczeniowych pod maską.

Jed wprowadza „Gettext Style i18n dla nowoczesnych aplikacji JavaScript” (a przynajmniej tak napisano na ich stronie).

Twoje pytanie dotyczy plików .po. Jed wyjaśnia na swojej stronie:

Istnieje wiele dostępnych konwerterów .po na .json. Pliki .po Gettext są standardowym wyjściem większości porządnych firm tłumaczeniowych, ponieważ są starym standardem.

Obecnie używam: po2json

Chciałbym jednak dodać tę funkcję do osobnego modułu Jed w przyszłej wersji.

Nie wydaje się to jednak mieć tutaj zastosowania.

Okazuje się, że dalsze kopanie setLocaleData( data: Object, domain: string )służy do przekazywania tłumaczeń w następujący sposób :

$locale_data = gutenberg_get_jed_locale_data( 'gutenberg' );
wp_add_inline_script(
    'wp-i18n',
    'wp.i18n.setLocaleData( ' . json_encode( $locale_data ) . ' );'
);

( gutenberg_get_jed_locale_data( $domain )mniej więcej opakowanie get_translations_for_domain( $domain ))

Wygląda więc na to, że WordPress pobiera dane tłumaczenia przez PHP, a następnie przekazuje je Jed. Sam Jed wydaje się nie ładować żadnych plików tłumaczeń.

Plik Readme pakietu wyjaśnia również, jak prawidłowo wygenerować plik .pot zawierający zlokalizowane ciągi.

Pakiet zawiera również pot-to-phpskrypt używany do generowania plików php zawierających komunikaty wymienione w pliku .pot. Jest to przydatne, aby oszukać wykrywanie ciągów tłumaczeń WordPress.org, ponieważ w tej chwili WordPress.org nie jest w stanie analizować ciągów bezpośrednio z plików JavaScript.

npx pot-to-php languages/myplugin.pot languages/myplugin-translations.php text-domain
kero
źródło
Czy to oznacza, że ​​Gutenberg przechowuje tłumaczenia w niektórych windowwłaściwościach, gdy JSON jest ładowany wp_add_inline_scriptprzez PHP, a następnie pobiera je po stronie React i przekazuje je Jed? ... a Jed ma magię?
Bologer
@Bologer Niekoniecznie windowwłaściwość, ale tak. PHP pobiera wartości i przekazuje je do JS przezwp_add_inline_script
kero
2
powinieneś rozwinąć swoją odpowiedź o informacje dodane w komentarzu do mojego. Ten komentarz wydaje się w rzeczywistości bardziej zgodny z tym, czego szuka OP
Mark Kaplun,
2

Przynajmniej na razie, dopóki nie ma lepszego zautomatyzowanego procesu, sugerowałbym, aby w ogóle nie generować plików .pot z JS.

Jak wyjaśnia @kero w swojej odpowiedzi, tłumaczenia GB są przekazywane jako rodzaj tablicy obiektów blob z pliku .mo do JS. Ten przepływ pracy spowoduje uszkodzenie wszystkich wtyczek naruszających lokalizację, które polegają na filtrowaniu wyników __i powiązań. Lepszym przepływem pracy będzie jawne generowanie tablicy obiektów blob z ciągów tłumaczonych za pomocą __wywołań, podobnie jak w przypadku tłumaczenia JS w kontekście innym niż GB. To rozwiąże również problem generowania plików .pot.

Brakuje tutaj zautomatyzowanego procesu, który będzie działał na plikach JS i generował odpowiedni kod PHP, który z kolei może być analizowany za pomocą narzędzi takich jak poedit.

Mark Kaplun
źródło
O ostatnim akapicie: „ zawiera pot-to-phpskrypt używany do generowania plików php zawierających wiadomości wymienione w pliku .pot. Jest to przydatne, aby oszukać wykrywanie ciągów tłumaczeń WordPress.org ”
kero
1
ładny punkt wyjścia, tylko lewa część jest do automatycznego generowania wywołanie wp_add_inline_script, jak teraz to chyba tylko generować php tylko z korzyścią dla pokolenia pot, ale w rzeczywistości nie używać go (zgaduję)
Mark Kaplun