CoroidDin AI-plattform för mjukvaruutveckling
Dokumentation

Gör ett projekt flerspråkigt

Kör internationaliseringsguiden för att göra ett projekt flerspråkigt. Coroid läser repot, föreslår språk och inställningar och förbereder en pull request.

Internationaliseringsguiden gör ett projekt flerspråkigt. Den läser ditt repo, utgår från det den hittar i varje steg och avslutar med en uppgift som öppnar en pull request. Du behöver aldrig ange en språkkod eller redigera JSON; ändra bara det du vill, så ändras inget i ditt repo förrän du mergar.

Ägare och administratörer kör guiden. Starta den från Globalisering → Internationalisering: välj Gör ett projekt flerspråkigt, eller Starta guiden på en projektrad. För ett projekt som redan är flerspråkigt Inställningar → Ändra språk i dess arbetsyta öppnar samma guide så att du kan föreslå ändringar.

Stegen

1. Skanna

Coroid läser standardgrenen utan att köra någon av dess kod. Den söker efter kataloger och deras språk, ramverken som används och text som fortfarande står direkt i koden, räknat per fil.

  • Kataloger hittades. Guiden behåller dem: Coroid lägger till sina kontroller och översätter det som saknas. Det kallas att införa stöd.
  • Inga kataloger ännu. Coroid flyttar texten i koden till kataloger och ersätter den med uppslagningar. Det kallas att införa internationalisering.
  • Redan konfigurerat. Projektet har redan en Coroid-konfiguration, och guiden föreslår ändringar i den.

2. Källspråk

Språket produkten är skriven på; alla andra språk översätts från det. Guiden identifierar det utifrån dina kataloger eller gissar det utifrån texten i koden. Vilket språk som helst kan vara källspråk: en svensk produkt som översätts till engelska och tyska fungerar på samma sätt.

3. Språk

Välj språk ett i taget eller lägg till en hel marknad på en gång: Mest talade, Europa, Norden, Östasien, Amerika eller Höger till vänster. För varje språk visas dess eget namn, om det skrivs från höger till vänster och hur många pluralformer det behöver.

Regionala varianter kan skapas i stället för att översättas. Brittisk engelska utgår från amerikansk engelska med brittisk stavning, och schweizertyska från tyska med schweizisk stavning. Därför kostar de inget och hålls i takt med sitt ursprungsspråk.

Internationalisering
Guide för internationalisering

Varje steg utgår från det som redan finns i repot. Ändra bara det du vill; inget ändras förrän pull request har mergats.

Steg 3 av 8
Språk att lägga till

Välj språk ett i taget eller lägg till en hel marknad. Regionala varianter, som brittisk engelska, kan skapas med hjälp av regler i stället för att översättas.

5 språk
  • Deutschtyska · de · 2 pluralformer
  • Françaisfranska · fr · 3 pluralformer
  • 日本語japanska · ja · 1 pluralform
  • العربيةarabiska · ar · höger till vänster · 6 pluralformer
  • British Englishbrittisk engelska · en-GB · 2 pluralformerHärledd med brittisk stavning
Lägg till en marknad
Mest taladeEuropaNordenÖstasienAmerikaHöger till vänster
TillbakaFortsätt

Guiden för internationalisering, på steget Språk: varje språk visas med sin skrivriktning och sina pluralformer, brittisk engelska som härleds enligt regler och marknader som kan läggas till på en gång. Exempeldata.

4. Strängar

När du tar över befintliga kataloger väljer du vilka kataloger Coroid fortsätter att översätta; deras nycklar och struktur förblir oförändrade. När du introducerar internationalisering väljer du vilka filer med text som Coroid flyttar till kataloger; filer du inte väljer förblir oförändrade.

5. Stil och termer

Allt är valfritt och gäller för alla språk:

  • Formellt eller informellt. För språk där man tilltalar läsaren formellt eller informellt, som tyskans Sie och du. Som standard följer varje språk tonen i källtexten.
  • Termer som behålls som de är. Produkt-, varumärkes- och funktionsnamn som är desamma på alla språk.
  • Om produkten. Några meningar om produkten och dess läsare, som hjälper varje översättning att välja rätt ord.

6. Kultur

Varje marknad skriver datum, tal och priser på sitt eget sätt. Välj hur koden formaterar dem för läsaren: guiden föreslår formateraren för ramverket den hittade, till exempel next-intl eller react-intl, eller så kan du beskriva en egen. Välj sedan valutan som används för betalningar på varje marknad; varje marknad börjar med sin egen regionala valuta. Varje marknad visar ett exempeldatum och -tal, vilken veckodag veckan börjar på och pappersformatet. Coroids agenter följer båda valen; se Kultur.

7. Kvalitet och automatisering

På som standard, men varje inställning kan ändras senare:

  • Kontrollera översättningar vid varje ändring. Den Kontroll av globalisering skickar tillbaka en ändring om den lämnar strängar saknade eller trasiga, eller lägger till text i koden i stället för i katalogen.
  • Översätt strängar som har mergats utanför Coroid. När någon mergar ny text utan Coroid skapar en uppgift en översättning.
  • Tillämpa korrigeringar varje natt. Godkända förslag från bidragsgivare kommer in som en pull request varje natt.
  • Låt inbjudna föreslå formuleringar. Modersmålstalare som du bjuder in kan korrigera översättningar på din webbplats. Se Hantera översättningar med förslag.

Konfigurationsfilen styr det sista alternativet. Coroid aktiverar de andra nästa gång en ägare eller administratör öppnar Globalisering efter att pull request har mergats, och bara en gång: om du senare stänger av ett alternativ förblir det avstängt.

8. Granskning

En sammanfattning av projektet, vad uppgiften ska göra, källspråket, språken och vilka av dem som är härledda, översättningsvolymen, termerna som behålls som de är, formateraren och valutorna samt vad som aktiveras efter mergningen. Översättning debiteras som modellanvändning, liksom annat agentarbete, och har en gräns per uppgift.

Välj Internationalisera. Coroid skapar en uppgift med en specifikation och acceptanskriterier och startar den direkt.

Vad uppgiften gör

  • Införande skriver konfigurationsfilen precis som guiden har satt ihop den, och översätter sedan alla saknade strängar.
  • Introduktion kopplar in ditt ramverk, flyttar texten från de valda filerna till kataloger, lägger till språkbaserad routning, reservlösningar och stöd för höger-till-vänster-text och översätter sedan.
  • Ändring skriver den nya konfigurationen och reparerar de översättningar som påverkas av ändringen.

Uppgiften avslutas med en pull request. När den har mergats till standardgrenen visas alla språk i Lokalisering, och World readiness läser koden för att hitta sådant som fortfarande förutsätter ett enda språk.

Format

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 valda fält i frontmatter; kod och markup lämnas som de är
AnpassatAlla andra format via ett enkelt adapterkommando i ditt repository

Konfigurationsfilen

Guiden skriver .coroid/i18n.json. Den beskriver ditt repository, så den finns i ditt repository och ändras via pull requests:

{
  "version": 1,
  "cli": { "version": "1.16.0", "sha256": "…" },
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "ja", "ar"],
  "derivedLocales": [
    { "locale": "en-GB", "from": "en", "rules": "en-gb-spelling" }
  ],
  "catalogs": [
    {
      "id": "ui",
      "format": "i18next-json",
      "source": "messages/{locale}.json"
    }
  ],
  "protectedTerms": ["Storefront"],
  "localeInstructions": {
    "de": "Address the reader informally (du)."
  },
  "world": {
    "formatter": "useFormatter from next-intl",
    "currencies": { "de": "EUR", "fr": "EUR", "ja": "JPY", "ar": "SAR" }
  }
}
  • cli låser den exakta motorversionen och dess kontrollsumma. Coroid hämtar och verifierar den versionen före varje körning, så en uppdatering aldrig ändrar resultatet oväntat.
  • derivedLocales listar de regionala varianter som skapas enligt reglerna.
  • protectedTerms och localeInstructions innehåller det du valde under Stil och terminologi, och world det du valde under Kultur. I Globaliseringstestet listar resten av world.

Filen kan också innehålla en ordlista, produktkontext, översättningsflöden per språk och förslagskopplingen för medarbetare.

Inställningar → Konfigurationsfil i arbetsbänken visar den exakta filen på default-branchen. Om du vill ändra den där redigerar du förslaget och väljer Föreslå ändring: Coroid öppnar en uppgift som tillämpar exakt den filen och reparerar eventuella översättningar som påverkas av ändringen. För språk och stil är guiden enklare att använda.