CLI i skanowanie kodu: automatyczne wykrywanie wszystkich nieprzetłumaczonych ciągów
Koniec z ręcznym przeszukiwaniem plików źródłowych w poszukiwaniu zakodowanych na stałe ciągów. CLI Better i18n wykorzystuje analizę opartą na AST do skanowania całego kodu źródłowego, wykrywania nieprzetłumaczonych tekstów w komponentach JSX i atrybutach, raportowania brakujących i nieużywanych kluczy oraz bezproblemowej integracji z pipeline CI.
Skanowanie kodu oparte na AST
W odróżnieniu od skanerów opartych na wyrażeniach regularnych, które generują fałszywe alarmy, Better i18n analizuje kod do postaci Abstract Syntax Tree, zapewniając precyzyjne i kontekstowe wykrywanie ciągów.
Wykrywanie sztywno zakodowanych ciągów znaków
Automatycznie wyszukaj wszystkie ciągi tekstowe widoczne dla użytkownika, które nie są zawarte w funkcji tłumaczenia, w tym ciągi tekstowe w elementach potomnych JSX oraz w właściwościach komponentów.
Analiza składniowa oparta na AST
Przetwarza kod źródłowy na abstrakcyjne drzewo składniowe, umożliwiając precyzyjne wykrywanie z uwzględnieniem kontekstu, co pozwala wyeliminować fałszywe alarmy generowane przez skanery oparte na wyrażeniach regularnych.
Przeglądanie węzłów tekstowych JSX
Wykrywa nieprzetłumaczone fragmenty tekstu wewnątrz elementów JSX, w tym wyrażenia i literały szablonowe renderowane bezpośrednio w komponentach.
Skanowanie atrybutów JSX
Wykrywa sztywno zakodowane ciągi znaków w atrybutach JSX, takich jak placeholder, aria-label i title, które często są pomijane podczas ręcznych audytów międzynarodowych.
Inteligentne filtrowanie
Pomija wartości, których nie da się przetłumaczyć, takie jak nazwy klas CSS, ścieżki importu i literały liczbowe, dzięki czemu widoczne są wyłącznie wyniki, na podstawie których można podjąć działania.
Polecenia CLI do audytu tłumaczeń
Polecenie check zapewnia interaktywne, przyjazne dla deweloperów doświadczenie audytu. Porównuje klucze tłumaczeń używane w kodzie źródłowym z kluczami przechowywanymi zdalnie w Better i18n, wskazując zarówno brakujące klucze wymagające tłumaczenia, jak i nieużywane klucze, które można usunąć.
Dynamiczne wzorce kluczy, takie jak literały szablonowe, są wykrywane automatycznie. Gdy kod używa t(`key.${variable}`), CLI rozpoznaje dynamiczny segment i uwzględnia go w raportach dopasowania wzorców, dzięki czemu nic nie umknie uwadze.
- Przeprowadź pełny audyt tłumaczenia za pomocą jednego polecenia sprawdzającego
- W systemie Surface brakuje kluczy tłumaczeniowych, które istnieją w kodzie, ale nie ma ich w Państwa zdalnym magazynie
- Zidentyfikuj nieużywane klucze w swoim zdalnym magazynie, do których nie ma już odniesień w kodzie
- Wykrywaj dynamiczne wzorce kluczy, takie jak literały szablonowe, i oznaczaj je do weryfikacji
- Generuj raporty porównawcze między lokalnym użyciem a zdalnym stanem tłumaczeń
Elastyczne formaty wyników
Wyniki skanowania są dostępne w wielu formatach, dostosowanych do Państwa procesu pracy. Wyniki w formacie ESLint zapewniają czytelne dla użytkownika raporty zawierające odniesienia do plików, wierszy i kolumn. Wyniki w formacie JSON dostarczają dane w formacie maszynowym, przeznaczone do automatyzacji procesów CI/CD oraz niestandardowych narzędzi.
Tryb verbose zapewnia pełną przejrzystość dzięki szczegółowym logom audytu, podsumowaniom zakresu i informacjom o czasie wykonania. Statystyki skanowania pokazują liczby plików, metryki wykrycia oraz dane wydajnościowe, dzięki czemu zawsze wiesz, jaki jest stan pokrycia tłumaczeń.
Wyniki w stylu ESLint
Raporty czytelne dla człowieka zawierające ścieżkę pliku, numer wiersza i kolumny, umożliwiające szybką nawigację w dowolnym edytorze.
Wyniki w formacie JSON
Strukturalne dane odczytywalne maszynowo, idealne do automatyzacji CI/CD, niestandardowych dashboardów i integracji z innymi narzędziami.
Tryb verbose
Szczegółowe logi audytu zawierające podsumowania zakresu, informacje o czasie wykonania i ślady rozwiązywania przestrzeni nazw — przydatne podczas debugowania.
Statystyki skanowania
Liczby plików, metryki wykrywania kluczy i dane wydajnościowe, dzięki czemu zawsze wiesz, jaki jest stan pokrycia tłumaczeń.
DevOps i integracja CI/CD
Wbuduj weryfikację tłumaczeń w istniejący pipeline programistyczny, aby wykrywać brakujące ciągi zanim trafią na środowisko produkcyjne.
Integracja z potokiem CI
Dodaj krok skanowania do przepływu pracy CI, który blokuje build w przypadku wykrycia nieprzetłumaczonych ciągów lub brakujących kluczy.
Hooki pre-commit
Uruchamiaj skanowania na plikach umieszczonych w staging przed każdym commitem, aby wykrywać nieprzetłumaczone ciągi jak najwcześniej w procesie wytwarzania oprogramowania.
Skanowanie w zakresie katalogu
Wskazuj konkretne katalogi lub wzorce plików, aby skanować tylko te części kodu źródłowego, które zawierają treści widoczne dla użytkownika.
Analiza z uwzględnieniem zakresu
Automatycznie rozwiązuj przestrzenie nazw tłumaczeń poprzez śledzenie zakresu leksykalnego, tak aby każde wywołanie t() było mapowane do właściwego zestawu kluczy.
Better i18n CLI: skanowanie kodu stworzone z myślą o lokalizacji
CLI Better i18n łączy skanowanie kodu oparte na AST z zarządzaniem kluczami zdalnie — w jednym narzędziu. Skanuj kod źródłowy pod kątem zakodowanych na stałe ciągów, porównuj lokalne użycie z zdalnym magazynem tłumaczeń, wykrywaj nieużywane klucze zwiększające rozmiar bundle i generuj raporty dla pipeline CI — wszystko bez opuszczania terminala.
Skanowanie z uwzględnieniem zakresu
śledzi wywołania useTranslations i getTranslations przez zakresy leksykalne, automatycznie przypisując każde wywołanie t() do właściwej przestrzeni nazw.
Obsługa komponentów serwerowych
Pełna obsługa asynchronicznych komponentów serwerowych Next.js App Router, dzięki czemu wywołania getTranslations w kodzie po stronie serwera są wykrywane i audytowane razem z użyciem po stronie klienta.
Hooki pre-commit
Aby przeprowadzać skanowanie wyłącznie plików przygotowanych do publikacji, należy użyć opcji --staged, co pozwoli wykryć nieprzetłumaczone ciągi znaków przed ich zatwierdzeniem, nie spowalniając przy tym pracy.
Powiązane tematy
For Developers
Narzędzia i18n dla deweloperów z type-safe SDK i przepływami pracy opartymi na Git
Localization Software
Narzędzia TMS i CAT do zarządzania tłumaczeniami na dużą skalę
Localization Software
Narzędzia TMS i CAT do zarządzania tłumaczeniami na dużą skalę
Translation Management System
Centralize your localization workflow with a TMS
Wydawaj tłumaczenia bez pominięcia ani jednego ciągu
CLI Better i18n skanuje kod, wykrywa każdy nieprzetłumaczony ciąg i integruje się z potokiem CI, dzięki czemu nic nie trafia na produkcję bez tłumaczenia.