Přejít na obsah
Rozhraní CLI a analýza kódu

Prohlížení CLI a kódu: Automatické vyhledání všech nepřeložených řetězců

Přestaňte prohledávat zdrojové soubory kvůli pevně zakódovaným řetězcům. Nástroj Better I18N CLI využívá analýzu založenou na AST k prohledání celé vaší kódové základny, detekci nepřeloženého textu v komponentách a atributech JSX, hlášení chybějících a nepoužívaných klíčů a hladké integraci do vašeho CI pipeline.

Skenování kódu pomocí technologie AST

Na rozdíl od skenerů využívajících regulární výrazy, které generují falešné poplachy, nástroj Better I18N rozloží váš kód do abstraktního syntaktického stromu, což umožňuje přesnou detekci řetězců s ohledem na kontext.

Detekce napevno zakódovaných řetězců

Automaticky najděte každý řetězec viditelný pro uživatele, který není obalen překladovou funkcí, včetně řetězců v potomcích JSX a atributech komponent.

Analýza založená na AST

Analyzuje váš zdrojový kód a vytváří abstraktní syntaktický strom, což umožňuje přesnou detekci s ohledem na kontext a eliminuje falešné poplachy, ke kterým dochází u skenerů využívajících regulární výrazy.

Skenování textových uzlů JSX

Zjistí nepřeložený textový obsah uvnitř prvků JSX, včetně výrazů a šablonových literálů vykreslených přímo ve vašich komponentách.

Skenování atributů JSX

Vyhledává pevně zadané řetězce v atributech JSX, jako jsou placeholder, aria-label a title, které při ručních kontrolách internacionalizace často uniknou.

Inteligentní filtrování

Ignoruje hodnoty, které nelze přeložit, jako jsou názvy tříd CSS, cesty k importům a číselné konstanty, takže se zobrazují pouze výsledky, se kterými lze dále pracovat.

Příkazy CLI pro audit překladů

Příkaz check nabízí interaktivní auditní prostředí přívětivé pro vývojáře. Porovnává překladové klíče použité ve zdrojovém kódu s klíči uloženými vzdáleně v Better I18N a zobrazuje jak chybějící klíče vyžadující překlad, tak nepoužívané klíče, které lze vyčistit.

Dynamické vzory klíčů, jako jsou šablonové literály, jsou detekovány automaticky. Když váš kód používá t(`key.${variable}`), CLI rozpozná dynamický segment a zahrne jej do zpráv s porovnáváním vzorů, takže vám nic neunikne.

  • Proveďte kompletní kontrolu překladu jediným příkazem
  • Odhalte chybějící překladové klíče, které existují v kódu, ale nikoli ve vzdáleném úložišti
  • Identifikujte nepoužívané klíče ve vzdáleném úložišti, na které se kód již neodkazuje
  • Detekujte dynamické vzory klíčů, jako jsou šablonové literály, a označte je ke kontrole
  • Generujte srovnávací zprávy mezi lokálním využitím a vzdáleným stavem překladů

Flexibilní výstupní formáty

Výsledky analýzy jsou k dispozici v několika formátech, aby vyhovovaly vašemu pracovnímu postupu. Výstup ve stylu ESLint poskytuje přehledné zprávy s odkazy na soubory, řádky a sloupce. Výstup ve formátu JSON nabízí strojově čitelná data pro automatizaci CI/CD a vlastní nástroje.

Režim podrobného výstupu zajišťuje vysokou transparentnost díky podrobným auditním protokolům, souhrnům rozsahu a informacím o čase. Statistiky skenování zobrazují počet souborů, metriky detekce a údaje o výkonu, takže máte vždy přehled o stavu pokrytí překladu.

Výstup ve stylu ESLint

Přehledné zprávy obsahující cestu k souboru, číslo řádku a odkazy na sloupce pro rychlou orientaci v jakémkoli editoru.

Výstup JSON

Strojově čitelná strukturovaná data, která se ideálně hodí pro automatizaci CI/CD, vlastní řídicí panely a integraci s dalšími nástroji.

Podrobný režim

Podrobné auditní protokoly obsahující souhrny rozsahu, informace o čase a trasování řešení jmenných prostorů pro účely ladění.

Statistiky skenování

Počet souborů, klíčové ukazatele pro vyhledávání a údaje o výkonu, abyste měli vždy přehled o stavu svého překladového pokrytí.

DevOps a integrace CI/CD

Začleňte kontrolu překladů do stávajícího vývojového procesu, abyste odhalili chybějící řetězce ještě předtím, než se dostanou do produkčního prostředí.

1

Integrace CI pipeline

Přidejte krok skenování do svého CI postupu, který selže při sestavení, pokud jsou detekovány nepřeložené řetězce nebo chybějící klíče.

2

Hooky před potvrzením

Před každým odevzdáním proveďte kontrolu souborů v přípravné fázi, abyste odhalili nepřeložené řetězce v co nejranější fázi vývoje.

3

Skenování vymezené adresářem

Zaměřte se na konkrétní adresáře nebo vzory souborů a skenujte pouze části kódové základny obsahující obsah viditelný pro uživatele.

4

Analýza s ohledem na rozsah

Automaticky vyřešit překladové jmenné prostory pomocí sledování lexikálního rozsahu, aby se každé volání funkce `t()` přiřadilo ke správné sadě klíčů.

Vylepšené příkazové rozhraní i18n: Prohledávání kódu určené pro lokalizaci

CLI nástroje Better I18N kombinuje skenování kódu založené na AST se vzdálenou správou klíčů v jediném nástroji. Prohledávejte svůj kódový základ a hledejte pevně zadané řetězce, porovnávejte lokální použití s vaším vzdáleným úložištěm překladů, odhalujte nepoužívané klíče, které zbytečně zvětšují velikost balíčku, a generujte zprávy pro váš CI pipeline – to vše bez nutnosti opustit terminál.

Skenování s ohledem na rozsah

Tracks využívá volání useTranslations a getTranslations v rámci lexikálních oborů a každé volání t() automaticky přiřazuje ke správnému jmennému prostoru.

Podpora serverových komponent

Plná podpora asynchronních serverových komponent Next.js App Router, takže volání getTranslations v kódu na straně serveru jsou detekována a kontrolována stejně jako jejich použití na straně klienta.

Hooky před potvrzením

Pomocí příznaku --staged spouštějte kontroly pouze u souborů ve fázi přípravy, abyste odhalili nepřeložené řetězce ještě před jejich uložením, aniž by to zpomalilo váš pracovní postup.

Odesílejte překlady bez jediného chybějícího řetězce

Nástroj Better I18N s příkazovým řádkem prohledá váš kód, odhalí všechny nepřeložené řetězce a zapadne do vašeho CI procesu, takže se do produkčního prostředí nedostane nic bez překladu.