Þàüšé & ŕéšüḿé à ƃîĝ ŕüñ

Ĝöàļ: à ƃîĝ ŕüñ ţĥàţ đöéšñ'ţ ĥàṽé ţö ƒîñîšĥ îñ öñé šîţţîñĝ. À .kpz îš à šîñĝļé ƒîļé ĥöļđîñĝ àñ éñţîŕé ŕüñ îñ þŕöĝŕéšš: þüļļ šöüŕçéš îñţö îţ, ŵöŕķ àš ƒàŕ àš ýöü ĝéţ, šéţ îţ đöŵñ, àñđ ŕéšüḿé éẋàçţļý ŵĥéŕé ýöü ļéƒţ öƒƒ, ļàţéŕ öŕ öñ àñöţĥéŕ ḿàçĥîñé. Îţš çöñƒîĝüŕàţîöñ (ļàñĝüàĝéš, öüţþüţ ļàýöüţ) ŕîđéš îñšîđé ţĥé ƒîļé: ñö þŕöĵéçţ, ñö šéŕṽéŕ. Ţĥé þàŕçéļ ḿöđéļ šîţš îñšîđé ţĥé Þŕöĵéçţš çöñçéþţ; ţĥé þàçķàĝé ƒöŕḿàţ îš îñ ţĥé þŕöĵéçţ àŕçĥîṽé ŕéƒéŕéñçé.

Đéšķţöþ

Ýöü ŵöŕķ à .kpz ƒŕöḿ ţĥé çöḿḿàñđ ļîñé öŕ ţĥŕöüĝĥ àñ àššîšţàñţ. Ķàþî Đéšķţöþ öþéñš àñđ þŕéṽîéŵš ţĥé ţŕàñšļàţéđ ƒîļéš à merge ŵŕîţéš, ļîķé àñý öţĥéŕš, àñđ šĥöŵš à þàŕçéļ'š çöñƒļîçţš öñ ţĥé ĥöḿé. Ţö ĝîṽé à çöļļéàĝüé à šñàþšĥöţ öƒ à þŕöĵéçţ ýöü ŵöŕķ öñ îñ ţĥé àþþ, ŕüñ kapi pack. Ţö þàüšé àñđ ŕéšüḿé þŕöĵéçţ ŵöŕķ îñ ţĥé àþþ, çļöšé àñđ ŕéöþéñ ţĥé þŕöĵéçţ; ţĥé þŕöĵéçţ šţöŕé ķééþš îţš šţàţé ƃéţŵééñ šéššîöñš.

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

Ĥàñđ ţĥé þàŕçéļ öṽéŕ ļîķé ýöü ŵöüļđ ţö à þéŕšöñ:

Ĥéŕé'š work.kpz ƒŕöḿ ţĥé ṽéñđöŕ: ƒîñîšĥ ţĥé Ƒŕéñçĥ þàšš, ŕüñ ţĥé çĥéçķš, àñđ ḿéŕĝé ţĥé ƒîļéš öüţ.

Ţĥé àššîšţàñţ îñšþéçţš îţ (kapi info), ŕéšüḿéš ţĥé ŵöŕķ îñ þļàçé, àñđ ḿéŕĝéš ŵĥéñ đöñé. ķàþî ŕéàđš þŕöĝŕéšš ƒŕöḿ ţĥé çöñţéñţ îţšéļƒ (ţĥé öṽéŕļàýš þŕéšéñţ), šö ŕéšüḿîñĝ ñéṽéŕ ţŕàñšļàţéš à ƃļöçķ ţŵîçé.

ÇĻÎ

Ţĥé ļîƒéçýçļé îš ƒöüŕ ṽéŕƃš öṽéŕ öñé ƒîļé:

kapi extract src/**/*.json -o work.kpz \
  --target-lang fr,qps --out 'locales/{lang}/{name}.{ext}' # ingest + record config
kapi translate work.kpz --target-lang fr                  # transform in place
kapi pseudo-translate work.kpz --target-lang qps          # …work accumulates
kapi info work.kpz                                        # documents, locales, dirty?
kapi pack work.kpz                                        # eject the cache → the shareable file
kapi merge work.kpz -o locales/                           # emit the finished files

Ŵĥàţ éàçĥ šţéþ đöéš:

• Éẋţŕàçţ ŕéçöŕđš à šḿàļļ ŕéçîþé (ţàŕĝéţ ļöçàļéš, öüţþüţ ļàýöüţ) šö ļàţéŕ šţéþš ñééđ ñö ƒļàĝš. Ƃý đéƒàüļţ ţĥé .kpz çàŕŕîéš îđéñţîţý + à ŕöüñđ-ţŕîþ šķéļéţöñ, ñöţ ŕàŵ ƃýţéš; --with-source éḿƃéđš ţĥé öŕîĝîñàļš ƒöŕ öƒƒļîñé ŕé-éẋţŕàçţîöñ.
• Ţŕàñšƒöŕḿš ŕüñ àĝàîñšţ à ŵöŕķîñĝ çàçĥé ķéýéđ ţö ţĥé .kpz; ţĥé ƒîļé îţšéļƒ çĥàñĝéš öñļý ŵĥéñ ýöü pack (öŕ þàšš --pack öñ à ţŕàñšƒöŕḿ). info ŕéþöŕţš dirty ŵĥéñ ţĥé çàçĥé ĥöļđš üñþàçķéđ ŵöŕķ. Ŕé-ŕüññîñĝ à ţŕàñšƒöŕḿ ŕéüšéš ŵöŕķ àļŕéàđý đöñé, šö ÀÎ šţéþš ñéṽéŕ ŕüñ ţŵîçé.
• Ḿéŕĝé ŕéþļàýš ţĥé šţöŕéđ ţŕàñšļàţîöñš öñţö ţĥé šöüŕçé àñđ ŵŕîţéš öñé ƒîļé þéŕ šöüŕçé × ļöçàļé; îţ ñéṽéŕ ŕé-ŕüñš à ţööļ öŕ çàļļš à þŕöṽîđéŕ. Ŵîţĥ ñö -o îţ üšéš ţĥé ŕéçîþé'š ļàýöüţ.
• Àñöţĥéŕ ḿàçĥîñé ñééđš öñļý ţĥé þàçķéđ ƒîļé: ţĥé ƒîŕšţ çöḿḿàñđ ŕéƃüîļđš ţĥé çàçĥé ƒŕöḿ ţĥé .kpz àļöñé.
• Éđîţ à šöüŕçé îñ ţĥé þàŕçéļ ţĥé ŵàý ýöü éđîţ à ƒîļé: ñàḿé îţ work.kpz!<name> ţö kapi apply, kapi inspect, öŕ àñ àĝéñţ'š read_blocks àñđ apply_edits. Éàçĥ éđîţ îš çĥéçķéđ àĝàîñšţ ţĥé ŕéṽîšîöñ ýöü ŕéàđ, šö à šţàļé öñé îš ŕéƒüšéđ, àñđ ţĥé ñéẋţ ţŕàñšƒöŕḿ, merge àñđ pack ŕéàđ ţĥé éđîţéđ šöüŕçé. À þàçķéđ þàŕçéļ ţĥéñ çàŕŕîéš ţĥàţ šöüŕçé'š ţéẋţ. À šöüŕçé ţĥé þàŕçéļ ĥöļđš àš à šķéļéţöñ àļöñé ĥàš ñö ţéẋţ ţö éđîţ; éẋţŕàçţ îţ àĝàîñ ŵîţĥ --with-source.
• À þàŕçéļ ŕéþļàçéđ öñ đîšķ ŵĥîļé ýöü ĥöļđ üñþàçķéđ éđîţš ķééþš ýöüŕ éđîţš. Éàçĥ éđîţéđ šöüŕçé ţĥé ñéŵ ƒîļé çàŕŕîéš îñ àñöţĥéŕ ṽéŕšîöñ îš à çöñƒļîçţ: kapi status ļîšţš îţ ŵîţĥ ţĥé çöḿḿàñđ ţĥàţ šéţţļéš îţ, Ķàþî Đéšķţöþ šĥöŵš îţ öñ ţĥé þŕöĵéçţ'š ĥöḿé àñđ, ƒöŕ à þàŕçéļ öüţšîđé éṽéŕý þŕöĵéçţ, öñ ţĥé àþþ'š ĥöḿé, àñđ à ŕéàđ öƒ ţĥé šöüŕçé ŕéþöŕţš îţ üñđéŕ divergent. Ŕéƃàšé îţ (kapi resolve 'work.kpz!<name>' --rebase <write>) ţö çàŕŕý îţš çĥàñĝéš öñţö ýöüŕ éđîţš, ƃļöçķš îţ àđđéđ öŕ ŕéḿöṽéđ îñçļüđéđ, ţĥéñ çĥööšé à ŵöŕđîñĝ ƒöŕ éàçĥ ƃļöçķ ƃöţĥ ṽéŕšîöñš çĥàñĝéđ. Öŕ đîšçàŕđ îţ (--discard <write>) ţö ķééþ ýöüŕ éđîţš àš ţĥéý šţàñđ.

kapi inspect work.kpz!messages.json                       # blocks with their revisions
kapi apply changes.json                                    # ops address work.kpz!messages.json

Öñé ţĥîñĝ ţö àṽöîđ: ŕüññîñĝ à .kpz ŵöŕķšþàçé àñđ à ķàþî þŕöĵéçţ öṽéŕ ţĥé šàḿé çöñţéñţ. Üšé ţĥé þàŕçéļ ŵĥéñ ţĥéŕé îš ñö þŕöĵéçţ.

Ţŕý îţ

Ŵàļķ ţĥé ļîƒéçýçļé àš ñàŕŕàţéđ çöḿḿàñđš, ļîṽé îñ ýöüŕ ƃŕöŵšéŕ:

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

Ţĥéñ đö îţ ýöüŕšéļƒ: ŵöŕķ, þàçķ, ŕéöþéñ öñ à ƒŕéšĥ þàţĥ (à šţàñđ-îñ ƒöŕ àñöţĥéŕ ḿàçĥîñé), àñđ ŵàţçĥ ķàþî ŕéƃüîļđ ţĥé ŵöŕķšþàçé ƒŕöḿ ţĥé ƒîļé àļöñé:

Ļöàđîñĝ ţĥé îñţéŕàçţîṽé .ķþž ŵöŕķšþàçé ļàƃ…

Ñéẋţ

• Ţĥé Ķàþî ƒöŕḿàţ ƒàḿîļý & .kpz þàçķàĝé: ţĥé þàçķàĝé ƒöŕḿàţ àñđ îţš ŵöŕķîñĝ-šţàţé ḿéḿƃéŕš.
• Ĥàñđ öƒƒ ţö ţŕàñšļàţöŕš: ţĥé ƃîļîñĝüàļ îñţéŕçĥàñĝé þŕöƒîļé öƒ ţĥé šàḿé ŕöüñđ-ţŕîþ.