Ķééþ ţéŕḿš çöñšîšţéñţ

Ĝöàļ: đéçîđé öñçé ŵĥîçĥ ŵöŕđš ýöüŕ þŕöĵéçţ üšéš ƒöŕ îţš ķéý ţéŕḿš (þŕöđüçţ ñàḿéš, ÜÎ àçţîöñš, ţĥé ŵöŕđš ýöüŕ đöḿàîñ đéþéñđš öñ) àñđ ĥàṽé ķàþî ƒļàĝ àñýţĥîñĝ ţĥàţ đŕîƒţš. Îñ à þŕöĵéçţ ŵîţĥ öñé ļàñĝüàĝé, ţĥé ţéŕḿš šţöŕé ĥöļđš ţĥé ŵöŕđ ţö üšé àñđ ţĥé ŵöŕđš ţö àṽöîđ, àñđ kapi check ƒàîļš à šöüŕçé ƒîļé ţĥàţ üšéš à ƒöŕƃîđđéñ ţéŕḿ, üñđéŕ ţĥé ŕüļé terms.vocabulary; à ţéŕḿ ḿàŕķéđ àđṽîšöŕý ŕéþöŕţš ţĥé üšé ŵîţĥöüţ ƒàîļîñĝ. Ŵĥéñ ţĥé ŕéçîþé đéçļàŕéš à ţàŕĝéţ ļàñĝüàĝé, ţĥé šàḿé ţéŕḿš šţöŕé àļšö šàýš ĥöŵ éàçĥ ţéŕḿ çàŕŕîéš îñţö ţĥàţ ļàñĝüàĝé: îţ ĝüîđéš ţŕàñšļàţîöñ ƃéƒöŕé àñđ çĥéçķš îţ àƒţéŕ. Ţĥé ŕéšţ öƒ ţĥé þàĝé îš àƃöüţ ţĥàţ çàšé. Çöñçéþţš: Ţéŕḿîñöļöĝý; šţöŕàĝé ḿöđéļš: Ḿéḿöŕý & ţéŕḿš šţöŕàĝé.

ķàþî ķééþš ţéŕḿš îñ à ţéŕḿš ƃüñđļé (terms.json). Ţö ƃŕîñĝ îñ à ļîšţ ýöüŕ ţéàḿ àļŕéàđý ķééþš éļšéŵĥéŕé, šüçĥ àš à šþŕéàđšĥééţ éẋþöŕţéđ ţö ÇŠṼ, îḿþöŕţ îţ:

ţéŕḿš.çšṽ

source	target	domain
password	mot de passe	security
log in	se connecter	ui
dashboard	tableau de bord	ui
settings	paramètres	ui

Đéšķţöþ

Çöñţéẋţ → Ţéŕḿš îš ŵĥéŕé ţĥàţ ļîšţ ļîṽéš:

1. Ƃŕîñĝ îñ ţĥé ļîšţ. Îḿþöŕţ ţĥé ÇŠṼ ƒŕöḿ ţĥé ÇĻÎ (kapi terms import, ƃéļöŵ) öŕ ļàñđ term öþéŕàţîöñš ţĥŕöüĝĥ kapi apply; ƃöţĥ ŵŕîţé ţĥé þŕöĵéçţ'š ţéŕḿš šţöŕé. Ţĥé ṽîéŵ ļîšţš ţéŕḿš ƃý ļàñĝüàĝé þàîŕ àñđ đöḿàîñ, ŕéàđý ţö ƃŕöŵšé àñđ šéàŕçĥ.
2. Šþöţ-çĥéçķ à ţéŕḿ. Ļööķ üþ àñ éñţŕý ţö çöñƒîŕḿ ţĥé àþþŕöṽéđ ţàŕĝéţ ƃéƒöŕé à ƒüļļ þàšš, àñđ öþéñ îţš öççüŕŕéñçéš ţö šéé ŵĥéŕé ţĥé þŕöĵéçţ üšéš îţ.
3. Éñƒöŕçé îţ. Ŵîţĥ ţĥé ţéŕḿš šţöŕé îñ ţĥé þŕöĵéçţ, ţéŕḿ ƒîñđîñĝš šüŕƒàçé îñ ţĥé ƒîñđîñĝš çöüñţ öñ ţĥé þŕöĵéçţ'š Ḿàþ, îñ ţĥé ţéŕḿîñöļöĝý ĝàţé öƒ check --ship, àñđ àĝàîñšţ éàçĥ ƃļöçķ îñ ţĥé Ŕéṽîéŵ ǫüéüé.

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

Àšķ ƒöŕ éñƒöŕçéḿéñţ, öŕ ƒöŕ çüŕàţîöñ:

Çĥéçķ ţĥé Ƒŕéñçĥ ƒîļéš àĝàîñšţ öüŕ àþþŕöṽéđ ţéŕḿš àñđ ƒîẋ ŵĥàţ đŕîƒţš.

Ţĥé àššîšţàñţ ļööķš üþ àþþŕöṽéđ ţéŕḿš ƃéƒöŕé ŵŕîţîñĝ (kapi terms lookup), ŕüñš term-check àƒţéŕŵàŕđš àñđ çöŕŕéçţš ƒļàĝĝéđ ţàŕĝéţš ţĥŕöüĝĥ ţĥé ƒöŕḿàţ-àŵàŕé ŵŕîţéŕ. Îţ çàñ ñöţé ţĥé ţéŕḿš ţĥé ƒîļéš üšé ŵîţĥ context_note, ŵîţĥ ţĥé šéñţéñçé éàçĥ ŵàš šééñ îñ. Éàçĥ ñöţé àŕŕîṽéš àš à šüĝĝéšţîöñ; ķééþ ţĥé öñéš ýöü ŵàñţ éñƒöŕçéđ ŵîţĥ kapi context review.

ÇĻÎ

Îḿþöŕţ öñçé îñţö à ñàḿéđ ţéŕḿš šţöŕé, ṽéŕîƒý, ţĥéñ çĥéçķ đéļîṽéŕîéš:

kapi terms import terms.csv --name product-terms \
  --format csv --header -s en -t fr                 # once; persists across sessions
kapi terms lookup "log in" --name product-terms -s en -t fr
kapi exec term-check messages.json --target messages_fr.json \
  --source-lang en --target-lang fr --termstore product-terms

Ţĥé term-check ţööļ ƒļàĝš ţàŕĝéţš ţĥàţ đöñ'ţ üšé ţĥé àþþŕöṽéđ éǫüîṽàļéñţ ƒöŕ à šöüŕçé ţéŕḿ ("çöđé šéçŕéţ" ŵĥéŕé ţĥé ţéŕḿš šţöŕé šàýš "ḿöţ đé þàššé"). Îţ çöḿþàŕéš éàçĥ šöüŕçé šţŕîñĝ ŵîţĥ îţš ţŕàñšļàţîöñ, šö ñàḿé ţĥé šöüŕçé ƒîļé àñđ þàšš ţĥé ţŕàñšļàţîöñ ŵîţĥ --target; à ƒîļé ţĥàţ ĥöļđš ƃöţĥ ļàñĝüàĝéš, šüçĥ àš ẊĻÎƑƑ, ñééđš ñö --target, àñđ öṽéŕ šüçĥ ƒîļéš kapi exec ţàķéš ĝļöƃš àñđ -j 4. kapi exec ŕéþöŕţš ţĥé ƒîñđîñĝš àñđ éẋîţš 0 ŵĥàţéṽéŕ îţ ƒîñđš. Ţö ƒàîļ à ÇÎ ĵöƃ öñ ţĥéḿ, çĥéçķ ţĥé šàḿé þàîŕ ŵîţĥ kapi check, ŵĥîçĥ éẋîţš 3 ŵĥîļé à ƒîñđîñĝ ƒàîļš (šéé Šĥîþ ĝàţéš àñđ ÇÎ):

kapi check messages.json --target messages_fr.json \
  --target-lang fr --termstore product-terms

Ķééþ ţĥé ţéŕḿš šţöŕé çüŕŕéñţ ŵîţĥ ŕé-îḿþöŕţš (çöñçéþţš ḿéŕĝé) àñđ kapi terms export ƒöŕ ṽéñđöŕ ķîţš. Ƒļàĝš: kapi terms, kapi exec term-check, kapi check.

À šöüŕçé ţéŕḿ çöüñţš îñ îţš þļüŕàļ àñđ öţĥéŕ ŕéĝüļàŕ ƒöŕḿš, šö "Àļéŕţš" üšéš ţĥé ţéŕḿ "àļéŕţ", ŵĥîļé à ļöñĝéŕ ŵöŕđ ƃüîļţ öñ îţ, šüçĥ àš "ŵöŕķƒļöŵ" ƒöŕ "ƒļöŵ", đöéš ñöţ. À ţŕàñšļàţîöñ þàššéš ŵĥéñ îţ çöñţàîñš ţĥé àþþŕöṽéđ ţéŕḿ, àñý àđḿîţţéđ ţéŕḿ ƒöŕ ţĥé çöñçéþţ, öŕ à ŵöŕđ ƃüîļţ àŕöüñđ öñé öƒ ţĥéḿ ("ķàîþļàššéñé" çöñţàîñš "ķàîþļàšš"). À ƒöŕḿ ţĥàţ çĥàñĝéš ţĥé ŵöŕđ, šüçĥ àš ţĥé Ñöŕŵéĝîàñ þļüŕàļ "ṽàŕšļéŕ" ƒöŕ "ṽàŕšéļ", þàššéš öñçé ţĥé ţéŕḿ ļîšţš îţ àš à ƒöŕḿ. kapi terms validate ļîšţš ţĥé ţŕàñšļàţéđ ţéŕḿš ţĥàţ ĥàṽé ñö ƒöŕḿš ýéţ, àñđ kapi terms expand þŕöþöšéš ţĥéḿ ƒöŕ ýöü ţö ŕéṽîéŵ ƃéƒöŕé çöḿḿîţţîñĝ.

Ţŵö ñéîĝĥƃöüŕš öƒ term-check çöṽéŕ ŵĥàţ à šţöŕé àļöñé çàññöţ šàý:

• Ŕüļéš ŵîţĥöüţ à šţöŕé. term_rules: îš ţĥé šàḿé šĥàþé àš éṽéŕý ŵöŕđ ŕüļé, îñçļüđîñĝ ţĥé terms: à ṽöîçé ƒîļé çàŕŕîéš (öñé ţéŕḿ, ŵĥàţ ţö üšé îñšţéàđ, àñđ advisory: true ƒöŕ à ŕüļé ţĥàţ ŕéþöŕţš ŵîţĥöüţ ƒàîļîñĝ), àñđ term-check, translate, recycle àñđ pseudo-translate àļļ ţàķé îţ îñ à ƒļöŵ šţéþ'š config: öŕ üñđéŕ defaults.tools. À ŕüļé çàñ çàŕŕý à concept_id ţĥàţ ţîéš îţ ţö ţĥé çöñçéþţ îñ ţĥé šţöŕé; à ŕéþļàçéḿéñţ ŕüļé ŕéǫüîŕéš à ñöñ-éḿþţý replacement. Ţĥé ƒîéļđš àŕé îñ ţĥé ṽöîçé þŕöƒîļé ŕéƒéŕéñçé.
• Ţéŕḿš ţĥàţ ḿüšţ šüŕṽîṽé ṽéŕƃàţîḿ. kapi exec dnt-check (đö-ñöţ-ţŕàñšļàţé) ƒàîļš à ţàŕĝéţ ŵĥéŕé à þŕöđüçţ ñàḿé, ţŕàđéḿàŕķ öŕ çöđé îđéñţîƒîéŕ ļîšţéđ üñđéŕ --terms ŵàš ţŕàñšļàţéđ, ţŕàñšļîţéŕàţéđ öŕ đŕöþþéđ; ţĥé ţŕàñšļàţé šţéþ ḿàšķš ţĥöšé šþàñš, šö ţĥé ḿöđéļ ñéṽéŕ šééš ţĥéḿ. Ţĥé ţŵö ŕöüţéš đéŕ îñ šţŕéñĝţĥ: à --terms šţŕîñĝ îš ḿàšķéđ àñđ çàññöţ ƃé ţŕàñšļàţéđ, ŵĥîļé à çöñçéþţ ţĥé ţéŕḿš šţöŕé ḿàŕķš đö-ñöţ-ţŕàñšļàţé îš àšķéđ ƒöŕ îñ ţĥé þŕöḿþţ àñđ ţĥéñ éñƒöŕçéđ, ŵîţĥ term-check ƒàîļîñĝ à ţàŕĝéţ ţĥàţ đöéš ñöţ ķééþ îţ.

Îñ à þŕöĵéçţ, ţĥé çĥéçķ ŕéšöļṽéš ţĥé ţéŕḿš ƃöüñđ ŵĥéŕé éàçĥ ƒîļé šîţš àñđ ţĥé ŕéçîþé'š ļàñĝüàĝéš àüţöḿàţîçàļļý, ŵîţĥ ñö ƒļàĝš, àñđ ţĥé ţéŕḿîñöļöĝý ĝàţé ƒöļđš îñţö kapi check --ship. Ţéŕḿš ƃöüñđ öñ à þŕöƒîļé ŵîţĥ profiles.<name>.termstore ĥöļđ ţĥé çöñţéñţ àţ ţĥàţ þŕöƒîļé'š çĥàññéļš, àñđ ţĥé þŕöĵéçţ'š öŵñ ţéŕḿš ĥöļđ ţĥé ŕéšţ. Ţĥé term_rules: ţĥé ŕéçîþé đéçļàŕéš ĥöļđ éṽéŕý ƒîļé àš ŵéļļ: à ŕüļé öñ à ƒļöŵ šţéþ öŕ üñđéŕ defaults.tools ĥöļđš éṽéŕý ţàŕĝéţ ļàñĝüàĝé, àñđ öñé üñđéŕ defaults.locales.<lang>.tools ĥöļđš ţĥàţ ļàñĝüàĝé. Šö ţĥé ŕüļéš ţĥé ţŕàñšļàţé šţéþ îš ĝîṽéñ àŕé ţĥé ŕüļéš ţĥé ĝàţé, kapi status àñđ kapi up ĥöļđ îţš öüţþüţ ţö, àñđ ŵĥéŕé à ŕéçîþé ŕüļé àñđ à šţöŕéđ ţéŕḿ ñàḿé ţĥé šàḿé ţéŕḿ, ţĥé ŕéçîþé'š ŕüļé àþþļîéš. Ţĥé ĝàţé çöüñţš çöñţéñţ ŵĥöšé ļàñĝüàĝé ñéîţĥéŕ šöüŕçé àñšŵéŕš ƒöŕ àš not_governed àñđ ĥöļđš îţ ţö ñöţĥîñĝ. À ĝöṽéŕñéđ ţàŕĝéţ ķàþî çàññöţ ŕéàđ ƃàçķ çöüñţš àš not_checked, àñđ ţĥé ĝàţé đöéš ñöţ þàšš ŵĥîļé öñé ŕéḿàîñš. kapi terms occurrences "log in" (à ţéŕḿ àš ŵŕîţţéñ, öŕ à çöñçéþţ îđ, ŵîţĥ --locale àñđ --collection ţö ñàŕŕöŵ) šĥöŵš ŵĥéŕé ţĥé þŕöĵéçţ'š éẋţŕàçţéđ çöñţéñţ üšéš îţ, šö ýöü çàñ šéé ĥöŵ ḿüçĥ à ŕéţîŕéḿéñţ ţöüçĥéš ƃéƒöŕé ýöü đéçîđé îţ.

Ţŕý îţ

Ţĥé ŕàîļ îḿþöŕţš ţĥé ļîšţ àƃöṽé îñţö à ţéŕḿš šţöŕé, îñšþéçţš îţ àñđ ļööķš üþ ţéŕḿš, ţĥéñ þšéüđö-ţŕàñšļàţéš àñđ ŕüñš term-check àĝàîñšţ ţĥé šţöŕé:

Ļöàđîñĝ ţĥé ŵàļķţĥŕöüĝĥ…

Ñéẋţ

• Ŕéüšé ŵĥàţ ýöü'ṽé ţŕàñšļàţéđ: ţĥé ţéŕḿš šţöŕé ĝüîđîñĝ ţŕàñšļàţîöñ àš ŵéļļ àš çĥéçķîñĝ îţ.
• Ḿéḿöŕý & ţéŕḿš šţöŕàĝé: ţĥé ţĥŕéé þļàçéš à ţéŕḿš šţöŕé çàñ ļîṽé.
• Ţéŕḿîñöļöĝý: ĥöŵ đîšçöṽéŕý àñđ éñƒöŕçéḿéñţ ŵöŕķ.