Dokumentation

Översätt ditt projekt

Konfigurera översättningar för ett projekt, håll dem uppdaterade med Kvalitetskontroll och se vad de kostar.

Coroid översätter din produkt med samma motor som används för dess egna 13 språk. Dina kataloger förblir filer i din källkod. Varje ändring av dem kommer in som en vanlig uppgift och pull request, och bara strängar som är nya, ändrade eller trasiga skickas till en modell.

Översättningar finns under Kvalitetskontroll → Översättningar. Listan visar varje projekt, om översättningar har konfigurerats och när den senaste genomsökningen gjordes. Öppna ett projekt för att komma till arbetsytan.

Webbutik
Konfigurerat · källspråk en · 4 målspråk
ÖversiktKom igångKonfigurationBidragsgivareFörslagAutomatiseringar
Senaste kontrollenVisa anmärkningarVisa körning
SpråkvariantSaknasInaktuell
de02
fr140
ja141
ar140
  • ÖversättningarUppgiftskontroll och pull requests · endast ändrade strängarPublicerad
  • ÖversättningsgranskningSchemalagd · för varje katalog och språkvariantssidaUtkast

Kvalitetskontroll → översättningar för ett projekt: den senaste översättningskontrollen för varje språkvariant samt kontrollerna Översättningar och Översättningsgranskning. Illustrativa data.

Det här behöver finnas i din källkod

Coroid läser kataloger i följande format:

FormatAnvänds för
ICU JSONMeddelandefiler med ICU-pluralformer och select-uttryck
i18next JSONi18next- och react-i18next-kataloger, inklusive pluraländelser
Vue i18n JSONvue-i18n-meddelanden, inklusive länkade meddelanden och pluralformer med pipe
Rails YAMLconfig/locales/*.yml, med %{name} interpolering och pluralnycklar
gettext PO.po -filer och en .pot -mall, med Plural-Forms per språk
Markdown och MDXDokumentationssidor i en språkmapp (docs/en/…): text, bildbeskrivningar och utvalda frontmatter-fält; kod och markup lämnas som de är
AnpassatAlla andra format via ett litet adapterkommando i din källkod

Du behöver inte ha översättningar än. Om projektet saknar i18n kan Coroid lägga till det.

Kom igång

Fliken Skapa guidar dig genom tre steg.

  1. Identifiera. Coroid förbereder en identifieringsuppgift. Den kör den låsta översättningsmotorn mot din källkod och dokumenterar teknikstacken, katalogerna, vilket språk som är källspråk och sådant som den är osäker på.
  2. Välj. Välj Behåll befintlig i18n om du vill behålla ditt ramverk och dina kataloger och lägga till Coroids kontroller och delta-motor. Välj Lägg till i18n om du vill att Coroid konfigurerar ditt ramverk, extraherar representativa strängar och lägger till lokaliseringsrouting, reservlösningar och stöd för höger-till-vänster-språk.
  3. Skapa. Coroid skapar konfigurationsuppgiften med en specifikation och acceptanskriterier. Den avslutas med en pull request som du granskar som vilken annan som helst.
Webbutik
Ännu inte konfigurerat · konfigurering pågår
ÖversiktKom igångKonfigurationBidragsgivareFörslagAutomatiseringar
  1. Identifiera
  2. 2Välj
  3. 3Skapa
Identifierat: Next.js med next-intl · 3 JSON-kataloger · källspråk en
Använd befintlig i18n

Behåll ditt nuvarande ramverk och dina kataloger och lägg till Coroid:s översättningskontroller och deltahantering.

Inför i18n

Koppla in ditt ramverk, extrahera representativa strängar och lägg till språkvariantshantering i URL:er, reservlösningar och stöd för RTL.

Källspråk
en
Målspråk
de, fr, ja, ar
Fortsätt

Fliken Konfiguration efter identifieringen: välj om du vill använda befintlig i18n eller införa i18n, och ange källspråk och målspråk. Illustrativa data.

Konfigurationen är klar när den pull request har mergats till standardgrenen och Coroid har synkroniserat den. Fram till dess utgår inget annat i arbetsytan från den.

Konfigurationsfilen i källkoden

Konfigurationen skriver .coroid/i18n.json. Den beskriver din källkod, så den finns i din källkod och ändras via pull requests:

{
  "version": 1,
  "cli": { "version": "1.7.0", "sha256": "…" },
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "ja", "ar"],
  "catalogs": [
    {
      "id": "ui",
      "format": "i18next-json",
      "source": "messages/{locale}.json"
    }
  ],
  "localeTier": { "ja": "escalation" }
}
  • cli anger den exakta motorversionen och dess kontrollsumma. Coroid hämtar och verifierar den versionen före varje körning, så en uppdatering ändrar aldrig resultatet utan förvarning.
  • sourceLocale kan vara vilket språk som helst. En svensk källtext som översätts till engelska och tyska fungerar på samma sätt.
  • localeTier begär den mer avancerade översättningsvägen för ett språk. Du väljer en nivå, aldrig en modell.

Filen kan också innehålla en ordlista, skyddade termer, produktkontext och instruktioner per språk.

Om du vill ändra den redigerar du förslaget på fliken Konfiguration och väljer Föreslå ändring. Coroid öppnar en uppgift som tillämpar exakt den filen och reparerar alla översättningar som ändringen påverkar.

Samma flik innehåller inställningar som hör till Coroid snarare än din källkod: vilka webbplatser som får öppna förslagsväljaren, om förslag granskas som standard och projektets utgiftsgräns för översättningar.

Kontrollera varje ändring

Översättningar blir en del av verifieringen genom två kvalitetskontroller. Lägg till dem från fliken Översikt .

  • Översättningar körs vid uppgifts-QA och för pull requests. Den kontrollerar bara strängarna som en ändring berör.
  • Översättningsgranskning körs enligt ett schema. Den kontrollerar alla kataloger och språk och kan inkludera ett webbläsartest av dina lokaliserade sidor, för att kontrollera höger-till-vänster-layout, text som får plats dåligt och text på sidan som inte har översatts.

När du lägger till en kontroll skapas ett utkast till policy. Granska och publicera det under Kvalitetspolicyer för att aktivera den.

Varje problem blir ett fynd med en felkod:

KodBetydelseBlockerar som standard
missingSträngen saknar översättningJa
invalid_syntaxÖversättningen går inte att tolka, till exempel på grund av felaktig ICU-syntaxJa
placeholder_mismatchPlatshållarna skiljer sig från källtextenJa
plural_categoriesEn pluralform som språket kräver saknasJa
staleKälltexten ändrades efter att strängen översattesNej

Du väljer vilka felkoder som blockerar i kontrollens inställningar. Regler för ordlista, längd och förbjudna termer rapporterar egna felkoder när de har konfigurerats i filen.

Kvalitetskontroll
Resultat från de senaste körningarna, filtrerade på kontrollen Translations.
PolicyerAnmärkningar4Körningar
  • missingui · checkout.total · frInte översatt
  • staleui · nav.deals · deKälltexten har ändrats sedan översättningen gjordes
  • placeholder_mismatchui · cart.items · jaPlatshållarna skiljer sig från källtexten
  • plural_categoriesui · cart.count · arPluralformer saknas för det här språket

Kvalitetsanmärkningar från översättningskontrollen, med en problemkod per anmärkning. Illustrativa data.

När ett översättningsfynd blockerar en uppgift åtgärdar utvecklaragenten det på samma sätt varje gång: den öppnar en översättningssession för uppgiften och kör motorn på de ändrade strängarna. Den redigerar aldrig målkatalogerna för hand.

Översättningsmodellen

Översättning har en egen roll i AI-profiler, Översättare, vid sidan av Arkitekt, Utvecklare, QA och Granskare. Som standard används Hy-MT2, en översättningsmodell, med GPT-6 Luna som reserv, om organisationens policy tillåter det. Ändra kopplingen i en profil för AI precis som för andra roller.

Motorn grupperar också strängar efter storlek, validerar varje svar mot dina platshållare och pluralregler samt försöker igen eller eskalerar en sträng som inte klarar valideringen.

Kostnader

Översättningar ingår i alla abonnemang. Översättningsanrop går via Coroids översättningsgateway och debiteras organisationen som modellförbrukning, på samma sätt som agentkörningar. Konfigurationsuppgifter räknas in i planens agenttimmar, precis som andra uppgifter.

Med standardvägen för Översättare kostar det ungefär två cent att översätta 1 000 strängar till ett språk. När vi mätte kostade det cirka 0,33 dollar att översätta en katalog med 2 000 strängar till tio språk.

  • Du betalar bara för ändringar. Motorn har en cache som använder källtexten som nyckel, så oförändrade strängar skickas aldrig igen.
  • Varje uppgift har en översättningsgräns. En session stoppas när uppgiftens utgiftsgräns nås, 1 dollar som standard. Ett projekt kan ha en lägre gräns under Konfiguration → Åtkomst och utgifter.
  • Kontrollerna gör inga modellanrop. Kontrollen Översättningar och granskningen läser dina kataloger; de översätter inte.

Översättning utanför Coroid

Motorn är ett kommandoradsverktyg, coroid-i18n. Din egen CI kan köra samma låsta version med sin egen OpenRouter-nyckel. Inuti Coroid använder uppgifter alltid översättningsgatewayen, så kostnader och gränser hanteras på ett ställe.