Àđđ ļàñĝüàĝéš

Ĝöîñĝ ḿüļţîļîñĝüàļ îš öñé ļööþ: đéçļàŕé ţĥé ţàŕĝéţ ļöçàļéš, ļéţ kapi up çàţçĥ éṽéŕý ļàñĝüàĝé üþ ţö îţš šĥîþ ĝàţé, ŕéṽîéŵ ŵĥàţ ñééđš à þéŕšöñ, àñđ ĝàţé ţĥé ŕéļéàšé öñ kapi check --ship. Ţŕàñšļàţîöñ đŕîƒţ ñéṽéŕ ƃŕéàķš à ƃüîļđ; à ļàñĝüàĝé ţĥàţ îš ƃéĥîñđ îš þéñđîñĝ ŵöŕķ.

Đéšķţöþ

1. Àđđ ţĥé ļöçàļéš. Îñ Þŕöĵéçţ Šéţţîñĝš, àđđ ţĥé ţàŕĝéţ ļàñĝüàĝéš ýöü ţŕàñšļàţé îñţö (ƒöŕ éẋàḿþļé fr, de).
2. Ƃŕîñĝ üþ ţö đàţé. Ƃàçķ öñ ţĥé þŕöĵéçţ ṽîéŵ, ţĥé çöṽéŕàĝé þàñéļ ñöŵ šĥöŵš öñé ŕöŵ þéŕ ļöçàļé àĝàîñšţ ţĥé šĥîþ ĝàţé. Þļàñ… þŕéṽîéŵš ţĥé þéñđîñĝ ŵöŕķ ƒîŕšţ: çöñţéñţ-ḿéḿöŕý ļéṽéŕàĝé, ŕéḿàîñîñĝ ÀÎ ŵöŕķ, à ţöķéñ éšţîḿàţé, ñöţĥîñĝ ŵŕîţţéñ. Ţĥéñ çļîçķ Ƃŕîñĝ üþ ţö đàţé; kapi ŕüñš ţĥé đéƒàüļţ ƒļöŵ öṽéŕ éṽéŕý ļöçàļé ţĥàţ îš šĥöŕţ öƒ îţš ĝàţé, ļööþîñĝ üñţîļ éàçĥ šçöþé šĥîþš öŕ þàŕķš.
3. Ŕéṽîéŵ. Çļîçķ à šĥîþ-ĝàţé çéļļ ţö öþéñ ţĥé Ŕéṽîéŵ ǫüéüé ƒöŕ ţĥàţ ļöçàļé: îñšþéçţ éàçĥ ţŕàñšļàţîöñ, éđîţ îƒ ñééđéđ, àþþŕöṽé öŕ ŕéĵéçţ. Àþþŕöṽàļš ŕàîšé ţĥé reviewed çöṽéŕàĝé ţĥàţ à { reviewed: … } ĝàţé ḿéàšüŕéš.

▶

Walkthrough videoPending recording

Àđđîñĝ ţŵö ţàŕĝéţ ļöçàļéš îñ Þŕöĵéçţ Šéţţîñĝš, þŕéššîñĝ Ƃŕîñĝ üþ ţö đàţé, ŵàţçĥîñĝ çöṽéŕàĝé çļîḿƃ, àñđ öþéñîñĝ ţĥé Ŕéṽîéŵ ǫüéüé ƒŕöḿ à ĝàţé çéļļ.

View scene script ↗

Àĝéñţ (Çļàüđé)

Àšķ ƒöŕ ţĥé öüţçöḿé:

Àđđ Ƒŕéñçĥ àñđ Ĝéŕḿàñ ţö ţĥîš þŕöĵéçţ àñđ ƃŕîñĝ ƃöţĥ üþ ţö đàţé.

Çļàüđé àđđš target_languages ţö ţĥé ŕéçîþé, ŕüñš kapi up, ŕéàđš kapi status ƒöŕ ŵĥàţ þàŕķéđ, àñđ ŵàļķš ýöü ţĥŕöüĝĥ ţĥé ŕéṽîéŵ ŵöŕķļîšţ çöñṽéŕšàţîöñàļļý; ýöü àþþŕöṽé, îţ ŕéçöŕđš ţĥé đéçîšîöñš ŵîţĥ kapi apply. Šéé Üšé ŵîţĥ Çļàüđé.

ÇĻÎ

Đéçļàŕé ţĥé ļöçàļéš îñ ţĥé ŕéçîþé (öŕ þàšš --target-locale àţ kapi init ţîḿé):

kapi.yaml

defaults:
  source_language: en
  target_languages: [fr, de]
collections:
  - path: "src/locales/en/*.json"
    target: "src/locales/{lang}"

Ţĥé target: šàýš ŵĥéŕé à ţŕàñšļàţéđ ƒîļé ĝöéš. kapi add ŵŕîţéš îţ ƒöŕ ýöü (kapi add "src/locales/en/*.json" --target "src/locales/{lang}"), àñđ ŕéƒüšéš à ţàŕĝéţ ţĥàţ ļàñđš ƃàçķ îñšîđé ţĥé þàţţéŕñ îţ çöḿéš ƒŕöḿ, ŵĥîçĥ ŵöüļđ ḿàķé ţĥé çöļļéçţîöñ ŕé-ţŕàçķ îţš öŵñ öüţþüţ àš šöüŕçé.

Ţĥéñ çàţçĥ üþ, îñšþéçţ, àñđ ĝàţé:

kapi up                  # run the default flow until every gated scope ships or parks
kapi status              # per-locale coverage and ship-gate standing (never fails)
kapi status --review     # the worklist: translated units awaiting a person
kapi check --ship        # enforce the gates: the pre-release bar, exit 3 when unmet

kapi up ñééđš à ţŕàñšļàţîöñ þŕöṽîđéŕ ƒöŕ ĻĻḾ ţŕàñšļàţîöñ; šéé Çĥööšé à ţŕàñšļàţîöñ ḿöđéļ. Àþþŕöṽé ŕéṽîéŵéđ üñîţš ŵîţĥ kapi apply (kind:"review"); šéé Ŕéṽîéŵ & àþþŕöṽé.

Ĥöŵ ţĥé ĝàţé ţĥîñķš

Éàçĥ ţŕàñšļàţîöñ çļîḿƃš à ļàđđéŕ (đŕàƒţ, ţŕàñšļàţéđ, ŕéṽîéŵéđ, šîĝñéđ-öƒƒ) àñđ à šĥîþ ĝàţé îš çöṽéŕàĝé ţĥŕéšĥöļđš öṽéŕ ţĥàţ ļàđđéŕ ({ translated: 100, reviewed: 80 }). kapi up þŕöđüçéš, ŕéṽîéŵ þŕöḿöţéš, kapi check --ship ŕéļéàšéš. Ţĥé kapi ļööþ éẋþļàîñš ţĥé ḿöđéļ.

Ñéẋţ

• Ţŕàñšļàţé ŵîţĥ ýöüŕ ÀÎ: ţĥé ţŕàñšļàţîöñ ļööþ îñ đéþţĥ.
• Šĥîþ ĝàţéš & ÇÎ: ŕüñ kapi check --ship öñ éṽéŕý ÞŔ.
• Ŕéṽîéŵ & àþþŕöṽé: ţĥé ĥüḿàñ ĥàļƒ öƒ ţĥé ļööþ.