i18n Doctor: Ontvang een volledig rapport over de kwaliteit van uw vertaling met één enkele opdracht
Voer better-i18n doctor uit om uw volledige codebase te analyseren op vijf dimensies — codekwaliteit, vertaaldekking, nauwkeurigheid van plaatshouders, weeskleuteren en CDN-synchronisatie — en ontvang een enkele gezondheidsscore van 0-100 met bruikbare diagnoses.
Vijf analyselagen in één enkele stap
Doctor voert codescans, dekkingsanalyses, kwaliteitscontroles, prestatieaudits en CDN-synchronisatiecontroles uit — alles tegelijk, met een uniforme score.
Code — Detectie van hardgecodeerde strings
AST-gebaseerd scannen identificeert elke string die zichtbaar is voor de gebruiker en niet is ingepakt in t(). Detecteert JSX-tekst, attributen, ternaire locale-logica, toastberichten en stringvariabelen.
Dekking — Ontbrekende vertalingen
Vergelijkt de sleutels die aanwezig zijn in uw bronlocatie met elke doellocatie. Elke sleutel die ontbreekt in een doellocatie wordt gerapporteerd met de exacte naamruimte en het exacte pad.
Kwaliteit — Plaatshouder niet overeenkomen
Controleert of interpolatieplaatshouders consistent zijn in alle locales. Ondersteunt de formaten named {}, double-brace {{}}, printf-%s, template ${} en positional-{0}.
Prestaties — Detectie van wees-sleutels
Detecteert sleutels die in uw vertaalbestanden voorkomen, maar nooit in de code worden gebruikt. Verweesde sleutels vergroten de payloadgrootte en zorgen voor onderhoudsschulden.
Synchronisatie — CDN-vergelijking
Vergelijkt sleutels die uit uw code zijn gehaald met gepubliceerde sleutels in het CDN. Brengt ontbrekende en ongebruikte sleutels aan het licht voordat deze in productie komen.
Eén score voor de kwaliteit van uw vertaling
De arts berekent een score van 0 tot 100 op basis van de gevonden diagnoses. Fouten worden bestraft met 3,0 punten per stuk, terwijl de waarschuwingsbijdrage van elke regel is beperkt tot 20 punten. Dit voorkomt dat één regel met duizenden waarschuwingen uw volledige score tenietdoet.
De standaarddrempelwaarde is 70 (cijfer B). Gebruik --ci om builds onder deze drempelwaarde af te keuren, of begin met --report om een basisniveau vast te stellen voordat de score wordt afgedwongen.
score = 100 - (errors × 3.0) - Σ min(rule_warnings × 0.15, 20)Cijferdrempels
CI/CD-integratie — Voorkom onjuiste vertalingen voordat deze worden verzonden
Voeg Doctor toe aan uw CI-pijplijn om bij elke push regressies in de vertaling op te sporen. Automatische OIDC-authenticatie in GitHub Actions betekent dat er geen geheimen hoeven te worden beheerd.
GitHub Actions met OIDC
Verifieer automatisch zonder API-sleutels met behulp van GitHub Actions OIDC. Voeg eenvoudig id-token: schrijfrechten toe en voer doctor --ci --report uit.
Drempelwaarde-gating
Stel een drempelwaarde in (standaard: 70) en laat de build mislukken wanneer de score onder deze waarde komt. Begin met volgen met --report en pas vervolgens --ci toe.
Machine-leesbare JSON
Gebruik --format json voor gestructureerde uitvoer die u kunt doorsturen naar jq, aangepaste dashboards of downstream-automatisering in uw implementatiepijplijn.
Dashboardrapportage
Upload resultaten naar het Better i18n-dashboard met --report voor historische tracking, trendanalyse en teambrede zichtbaarheid van de i18n-status.
Wanneer welk commando gebruiken
Doctor is de uitgebreide optie. Gebruik gerichte commando's wanneer u een specifieke controle nodig heeft of snellere feedback wenst in pre-commit hooks.
dokterVolledige gezondheidsscore met vijf analyselagen — de enige betrouwbare bron voor de i18n-status van uw project.
scannenGerichte detectie van hardgecodeerde strings. Ondersteunt --staged voor pre-commit hooks.
controlerenInteractieve checker voor ontbrekende of ongebruikte vertaalsleutels met begeleide prompts.
synchroniserenVolledige vergelijking tussen lokaal en op afstand, waarbij zowel ontbrekende als ongebruikte sleutels tegelijk worden weergegeven.
Ontworpen voor praktische i18n-workflows
Gezondheidsscore 0–100
Enkele score met uitsplitsing per categorie en CI-drempelwaarde voor slagen/zakken. Houd de kwaliteit van uw vertalingen in de loop van de tijd bij.
Lexicale reikwijdte volgen
Slimme detectie van naamruimten voor zowel useTranslations als getTranslations. Elke t()-aanroep wordt toegewezen aan de juiste naamruimte.
Ondersteuning voor servercomponenten
Volledige ondersteuning voor Next.js App Router asynchrone serverfuncties. Server-side getTranslations-aanroepen worden gedetecteerd en gecontroleerd.
Configureerbare regels
Schakel regels uit of verlaag het niveau ervan in i18n.config.ts. Stel regels in op "error", "warning" of "off" om aan de behoeften van uw project te voldoen.
Slim filteren
Negeert automatisch CSS-klassennamen, URL's, importpaden en ontwikkelaarsconstanten. Alleen bruikbare resultaten.
Uitgebreid auditlogboek
Uitgebreide transparantie met --verbose. Overzichten van scopes, timinginformatie en traces van namespace-resolutie voor debugging.
Verwante onderwerpen
CLI & Code Scanning
AST-gebaseerde hardcoded stringdetectie en codescanningtools
For Developers
Ontwikkelaarsgerichte i18n-tools met typeveilige SDK's en Git-first-workflows
Localization Software
Platforms and software for managing localization at scale
Translation Management
Gecentraliseerd platform voor het beheer van vertaalworkflows op grote schaal
Controleer de kwaliteit van uw vertaling voordat u deze verzendt
Voer better-i18n doctor eenmaal uit om uw baseline te verkrijgen. Voeg het toe aan CI om nooit meer ontbrekende vertalingen te verzenden.