Korzystanie z API Locize w Emailify

Jeśli korzystasz z Locize, Emailify może przesłać źródłowe teksty z projektów e-maili do przestrzeni nazw (namespace) Locize i zaimportować przetłumaczone wersje z powrotem do Figmy.

Zanim zaczniesz

Potrzebujesz:

• projektu Locize z językiem referencyjnym i co najmniej jednym językiem docelowym;
• istniejącej wersji i przestrzeni nazw na tłumaczenia e-maili;
• klucza API Locize ograniczonego do projektu.

1. krok: połącz projekt Locize

1. Kliknij przycisk Localize w Emailify.
2. Wybierz Locize API z opcji lokalizacji.
3. Wpisz Project ID i API Key.
4. Wpisz Version Locize, której chcesz używać, na przykład latest lub production.
5. Wpisz Namespace, w której są tłumaczenia e-maili, na przykład emails.
6. Wybierz opcję Standard CDN lub Pro CDN zgodną z Twoim projektem Locize.
7. W sekcji String Key Source wybierz, jak Emailify ma tworzyć klucze tekstów w Locize.

Po połączeniu Emailify wyświetli język referencyjny i języki docelowe skonfigurowane w Twoim projekcie Locize.

Upewnij się, że typ CDN odpowiada Twojemu projektowi Locize. Standard CDN jest publiczny i ma stały, godzinny czas cache, a Pro CDN obsługuje prywatne publikowanie i konfigurowalny cache. Szczegóły znajdziesz w porównaniu CDN w dokumentacji Locize.

Wybór sposobu tworzenia kluczy tekstów w Locize

Figma Node ID (Default) zachowuje dotychczasowe działanie Emailify i używa wygenerowanych identyfikatorów węzłów Figmy jako kluczy w Locize. Istniejące przepływy pracy z Locize korzystają z tej opcji, dopóki jej nie zmienisz.

Wybierz Figma Text Layer Name, gdy nazwy warstw tekstowych w Figmie odpowiadają już kluczom tekstów w Twojej przestrzeni nazw Locize. Emailify zachowuje pełną nazwę warstwy, łącznie z kropkami, więc warstwa o nazwie templates.assistant_invited.h01 użyje dokładnie tego klucza w Locize.

Każda uwzględniona warstwa tekstowa musi mieć nazwę, a nazwy muszą być unikalne we wszystkich zaznaczonych e-mailach. Emailify zatrzymuje przesyłanie lub import i wskazuje zduplikowane klucze, zanim jakiekolwiek teksty źródłowe trafią do Locize. Klucze linków i tekstów alternatywnych obrazów tworzone są z nazwy warstwy tekstowej lub obrazu z przyrostkiem Emailify _LINK lub _ALT_TEXT. Wiersze tematu i preheadera nadal używają kluczy generowanych przez Emailify, ponieważ są to metadane e-maila, a nie warstwy tekstowe Figmy.

2. krok: wybierz e-maile i docelowe wersje językowe

Wybierz ramki Emailify, które chcesz zlokalizować, a następnie języki docelowe Locize, które zamierzasz później zaimportować.

Pozostaw włączoną opcję Import Markdown Formatting, jeśli tekst e-maili zawiera pogrubienia, kursywę, linki lub podziały wierszy, które chcesz zachować w całym procesie tłumaczenia.

3. krok: prześlij tekst referencyjny do Locize

Kliknij Upload, aby wysłać zaznaczony tekst z Emailify do przestrzeni nazw w języku referencyjnym skonfigurowanym w Locize. Jeśli później zmienisz tekst źródłowy w Figmie, prześlij go ponownie, aby zaktualizować odpowiednie klucze w Locize.

4. krok: przetłumacz w Locize

Otwórz projekt Locize i przetłumacz lub sprawdź przesłane klucze dla każdego języka docelowego.

5. krok: zaimportuj przetłumaczone e-maile do Figmy

Wróć do Emailify, wybierz potrzebne wersje językowe i kliknij Import Translations. Emailify dopasuje przetłumaczone klucze Locize do zaznaczonych e-maili źródłowych i utworzy sklonowane ramki e-maili dla każdej zaimportowanej wersji językowej.

Emailify przechowuje Twój klucz API Locize w lokalnej pamięci klienta Figmy dla bieżącego użytkownika, a nie we współdzielonym pliku Figmy. Używaj klucza API ograniczonego do projektu, a nie szerszego osobistego tokena dostępu.