lokalise-core-workflow-a

Skill do automatyzacji głównego przepływu pracy w Lokalise: wgrywania plików źródłowych i zarządzania kluczami tłumaczeń. Użyj go, gdy chcesz przesłać pliki tłumaczeń, tworzyć lub aktualizować klucze, albo organizować łańcuchy źródłowe w projektach Lokalise. Obsługuje formaty JSON, XLIFF, PO, YAML i inne. Skill udostępnia zarówno podejście SDK (Node.js) jak i CLI, umożliwiając operacje zbiorowe i tagowanie kluczy.

1. Upewnij się, że masz zainstalowane wymagane narzędzia: Node.js SDK Lokalise (@lokalise/node-api) lub CLI (lokalise2). Eksportuj zmienne środowiskowe: LOKALISE_API_TOKEN (Twój token API) i LOKALISE_PROJECT_ID (ID projektu).

2. Przygotuj plik źródłowy z tłumaczeniami w obsługiwanym formacie (JSON, XLIFF, PO, YAML). Plik powinien zawierać klucze i wartości dla języka źródłowego (np. angielskiego).

3. Wyzwól skill frazami takimi jak "lokalise upload", "lokalise push keys", "lokalise source strings" lub "add translations to lokalise". Podaj ścieżkę do pliku i kod języka (np. "en" dla angielskiego).

4. Skill zakoduje plik w Base64 i wyśle go do API Lokalise. Proces wgrywania jest asynchroniczny — skill będzie monitorować postęp aż do zakończenia.

5. Po wgraniu możesz tagować klucze do organizacji lub wykonywać operacje zbiorowe na kluczach za pomocą SDK lub CLI, w zależności od wybranego podejścia.

6. Skill obsługuje opcje takie jak zastępowanie zmodyfikowanych tłumaczeń (replace_modified) i rozróżnianie kluczy po pliku (distinguish_by_file) — dostosuj je do potrzeb Twojego projektu.