Šķîþ ţö ḿàîñ çöñţéñţ

Ŵĥéŕé ţŕàñšļàţîöñš & ţéŕḿš ļîṽé

:::ñöţé Ƃéţţéŕ îñ à þŕöĵéçţ kapi memory àñđ kapi terms ŕüñ àđ-ĥöç àĝàîñšţ à ļööšé öŕ ñàḿéđ šţöŕé, ƃüţ à ķàþî þŕöĵéçţ ĝîṽéš ţĥéḿ àñ àüţĥöŕîţàţîṽé çöñţéñţ ḿéḿöŕý àñđ ţéŕḿš šţöŕé, ƃöţĥ îñšîđé ţĥé þŕöĵéçţ'š öŵñ šţöŕé, ţĥàţ ţĥé éẋţŕàçţ/ḿéŕĝé ŕöüñđ-ţŕîþ àñđ ţéŕḿ-çĥéçķ àļŕéàđý šĥàŕé. :::

Ţĥé ţŕàñšļàţîöñš ķàþî ŕéüšéš àñđ ţĥé ţéŕḿš îţ ķééþš çöñšîšţéñţ àŕé ķéþţ îñ à šḿàļļ đàţàƃàšé öñ đîšķ. Ţĥàţ đàţàƃàšé çàñ ļîṽé îñ öñé öƒ ţĥŕéé þļàçéš. À ƒļàĝ þîçķš ţĥé þļàçé; ŵîţĥ ñö ƒļàĝ, à çöḿḿàñđ îñšîđé à ķàþî þŕöĵéçţ üšéš ţĥé þŕöĵéçţ'š šţöŕé, àñđ öñé öüţšîđé à þŕöĵéçţ üšéš à ļööšé ƒîļé. Ţĥé šàḿé ţĥŕéé ḿöđéļš àþþļý ţö ƃöţĥ šţöŕéš; öüţšîđé à þŕöĵéçţ öñļý ţĥé đéƒàüļţ ƒîļéñàḿé đéŕš (memory.db ṽš terms.db) àñđ ţĥé ñàḿéđ-šţöŕé šüƃđîŕéçţöŕý (memory/ ṽš terms/).

Ƒöŕ ţĥé šţöŕéš ţĥéḿšéļṽéš (ḿàţçĥîñĝ, ļéṽéŕàĝé, àñđ ţĥé çöñçéþţ ḿöđéļ) šéé Çöñţéñţ ḿéḿöŕý àñđ Ţéŕḿîñöļöĝý.

Ţĥé ţĥŕéé šţöŕàĝé ḿöđéļš​

1. À ļööšé ƒîļé îñ ţĥé çüŕŕéñţ đîŕéçţöŕý​

Ţĥé đéƒàüļţ ŵîţĥ ñö ƒļàĝ àñđ ñö þŕöĵéçţ. À kapi memory çöḿḿàñđ ŕéàđš àñđ ŵŕîţéš ./memory.db; à kapi terms çöḿḿàñđ ŕéàđš àñđ ŵŕîţéš ./terms.db. Ţĥîš îš ţĥé àđ-ĥöç ḿöđéļ, üšéƒüļ ƒöŕ à ǫüîçķ, ţĥŕöŵàŵàý šţöŕé ýöü đöñ'ţ îñţéñđ ţö ŕéüšé.

kapi memory import corpus.memory.json    # → ./memory.db
kapi terms import terms.json             # → ./terms.db

Þöîñţ àţ àñ éẋþļîçîţ þàţĥ ŵîţĥ --file, öŕ ŵŕîţé --local ţö ƃé éẋþļîçîţ àƃöüţ ţĥé çüŕŕéñţ-đîŕéçţöŕý đéƒàüļţ:

kapi memory stats --file ./build/scratch-memory.db
kapi terms stats --local

2. À ñàḿéđ šţöŕé üñđéŕ ýöüŕ çöñƒîĝ ĥöḿé​

Þàšš --name <n> ţö üšé à đàţàƃàšé üñđéŕ ýöüŕ çöñƒîĝ ĥöḿé ţĥàţ þéŕšîšţš ƃéţŵééñ šéššîöñš àñđ îš ŕéüšàƃļé àçŕöšš đîŕéçţöŕîéš, à çöñţéñţ ḿéḿöŕý àţ ~/.config/kapi/memory/<n>.db àñđ à ţéŕḿš šţöŕé àţ ~/.config/kapi/terms/<n>.db. Ţĥîš îš ţĥé ḿöđéļ ţö ŕéàçĥ ƒöŕ ŵĥéñ à šéţ öƒ ţéŕḿš öŕ à ḿéḿöŕý öüţļîṽéš àñý šîñĝļé ŵöŕķîñĝ đîŕéçţöŕý.

kapi terms import terms.json --name product-terms
kapi terms stats --name product-terms
kapi memory import corpus.memory.json --name corporate-en-fr

Ļîšţ ŵĥàţ ýöü ĥàṽé:

kapi memory list
kapi terms list

Ţĥé çöñƒîĝ ĥöḿé ƒöļļöŵš KAPI_CONFIG_DIR ŵĥéñ šéţ, öţĥéŕŵîšé ţĥé ÖŠ üšéŕ çöñƒîĝ đîŕéçţöŕý, ~/.config/kapi öñ Ļîñüẋ, ~/Library/Application Support/kapi öñ ḿàçÖŠ. À ñàḿéđ šţöŕé îš ŕéšöļṽéđ öñļý üñđéŕ ţĥàţ çöñƒîĝ ĥöḿé, šö öñ ḿàçÖŠ ţĥéŕé îš ñöţĥîñĝ üñđéŕ ~/.config/kapi. kapi memory list àñđ kapi terms list þŕîñţ ţĥé àƃšöļüţé þàţĥ öƒ éṽéŕý šţöŕé ţĥéý ƒîñđ. À ñàḿé ḿàý ñöţ çöñţàîñ à þàţĥ šéþàŕàţöŕ.

3. À þŕöĵéçţ'š àüţĥöŕîţàţîṽé šţöŕé​

Ŵĥéñ à çöḿḿàñđ ŕüñš îñšîđé à ķàþî þŕöĵéçţ, àñđ ñö --name, --local, öŕ --file ƒļàĝ îš ĝîṽéñ, kapi memory àñđ kapi terms üšé ţĥé þŕöĵéçţ'š àüţĥöŕîţàţîṽé šţöŕéš. Ƃöţĥ àŕé ţàƃļéš îñ ţĥé þŕöĵéçţ'š çöñţéẋţ šţöŕé, ŵĥîçĥ šîţš îñ à ŵöŕķšþàçé üñđéŕ ýöüŕ đàţà đîŕéçţöŕý, öüţšîđé ţĥé çĥéçķöüţ, šö éṽéŕý çļöñé öƒ ţĥé þŕöĵéçţ ŕéàđš ţĥé šàḿé öñé. ķàþî ƒîñđš ţĥé þŕöĵéçţ ƃý ŵàļķîñĝ üþ ţĥé đîŕéçţöŕý ţŕéé ƒŕöḿ ţĥé çüŕŕéñţ đîŕéçţöŕý, àš ĝîţ đöéš.

Ţĥöšé ţàƃļéš àŕé ţĥé þŕöĵéçţ'š öŵñ ŕéçöŕđ, àñđ ĝîţ ĥöļđš ñö çöþý öƒ ţĥéḿ. Ƒöüŕ ṽéŕƃš çàŕŕý ţĥéḿ îñ àñđ öüţ (Šĥàŕîñĝ çöñţéẋţ): kapi store import ŕéàđš à çĥéçķöüţ'š çöñţéẋţ ƒîļéš îñţö ţĥé šţöŕé, kapi context sync šĥàŕéš îţ ţĥŕöüĝĥ ţĥé þŕöĵéçţ'š çöñţéẋţ ƃàçķéñđ, àñđ kapi store export çàŕŕîéš ţĥé ŵĥöļé öƒ îţ àš öñé ƒîļé, ŵĥîçĥ îš ţĥé ƃàçķüþ ţĥîš šţöŕé ñééđš. Šéé ţĥé þŕöĵéçţ šţöŕé.

ķàþî ñééđš ñö šñàþšĥöţ öƒ ţĥé šţöŕé îñ ĝîţ. Ķééþîñĝ öñé îš à ţéàḿ'š çĥöîçé àƃöüţ ŵĥàţ à þüļļ ŕéǫüéšţ šĥöüļđ šĥöŵ. À ţéàḿ ţĥàţ ḿàķéš îţ ķééþš ţĥé šñàþšĥöţ çüŕŕéñţ àñđ ŕüñš kapi store import öñ à ƒŕéšĥ çļöñé àñđ öñ à ŕüññéŕ; à ţéàḿ ţĥàţ đöéš ñöţ ƃàçķš ţĥé šţöŕé üþ ŵîţĥ kapi store export îñšţéàđ.

Ţĥé šţöŕé îš ŵĥàţ kapi extract þŕé-ƒîļļš ƒŕöḿ, ŵĥàţ kapi merge ŵŕîţéš ƃàçķ ţö, àñđ ŵĥàţ kapi exec term-check éñƒöŕçéš, šö à þŕöĵéçţ-ḿöđé kapi memory lookup öŕ kapi terms lookup šééš éẋàçţļý ţĥé šţöŕé ţĥé ŕöüñđ-ţŕîþ üšéš, ŵîţĥ ñö ƒļàĝ ñééđéđ. Šéé Çŕéàţé ýöüŕ ƒîŕšţ þŕöĵéçţ.

# Inside a project directory:
kapi memory import ./corporate-en-fr.memory.json  # → the project store
kapi memory stats                            # reads the project content memory
kapi terms lookup "dashboard" -s en -t fr    # reads the project terms store

Àñ éẋþļîçîţ --name, --local, öŕ --file àļŵàýš ŵîñš, šö ýöü çàñ ţàŕĝéţ à đéŕéñţ šţöŕé éṽéñ ƒŕöḿ îñšîđé à þŕöĵéçţ.

Ĥöŵ ţööļš šéļéçţ à šţöŕé​

Ţĥé ţööļ çöḿḿàñđš ţĥàţ çöñšüḿé à šţöŕé, kapi exec recycle àñđ kapi exec term-check, ƒöļļöŵ ţĥé šàḿé þŕéçéđéñçé ţĥŕöüĝĥ ţĥéîŕ öŵñ --memory àñđ --termstore ƒļàĝš:

  • --memory <name|path> / --termstore <name|path>: à ƃàŕé ñàḿé (ñö šéþàŕàţöŕš) ŕéšöļṽéš üñđéŕ ţĥé çöñƒîĝ ĥöḿé; à ṽàļüé ŵîţĥ à þàţĥ šéþàŕàţöŕ îš ŕéàđ àš à ƒîļé þàţĥ.
  • ñö ƒļàĝ, îñšîđé à þŕöĵéçţ: ţĥé þŕöĵéçţ'š öŵñ çöñţéñţ ḿéḿöŕý / ţéŕḿš šţöŕé.
kapi exec recycle messages.json --target-lang fr --memory corporate-en-fr
kapi exec term-check messages.json --target messages_fr.json \
  --source-lang en --target-lang fr --termstore product-terms

--terms îš à đéŕéñţ ƒļàĝ öñ à đéŕéñţ ţööļ: ţĥé ƃööļéàñ ĝàţé öñ kapi exec dnt-check ţĥàţ ţüŕñš ţéŕḿ-đéŕîṽéđ đö-ñöţ-ţŕàñšļàţé đéţéçţîöñ öñ. Îţ ñéṽéŕ ñàḿéš à šţöŕé.

Çĥööšîñĝ à ḿöđéļ​

ḾöđéļŠéļéçţéđ ƃýĻîṽéš àţÜšé ŵĥéñ
Ļööšé ƒîļéđéƒàüļţ, --local, --file <path>./memory.db / ./terms.db, öŕ ţĥé þàţĥ ýöü ĝîṽéà öñé-öƒƒ öŕ ţĥŕöŵàŵàý šţöŕé
Ñàḿéđ šţöŕé--name <n>~/.config/kapi/memory/<n>.db / ~/.config/kapi/terms/<n>.dbà šéţ öƒ ţéŕḿš öŕ à ḿéḿöŕý ŕéüšéđ àçŕöšš đîŕéçţöŕîéš
Þŕöĵéçţ šţöŕéñö ƒļàĝ, îñšîđé à ķàþî þŕöĵéçţţàƃļéš îñ ţĥé þŕöĵéçţ'š çöñţéẋţ šţöŕé, šĥàŕéđ ƃý éṽéŕý çĥéçķöüţà ŕéþöšîţöŕý ýöü ţŕàñšļàţé ŕéþéàţéđļý

:::ñöţé[Ŵöŕķš ŵîţĥ Ƃöŵŕàîñ] Àļļ ţĥŕéé ḿöđéļš àŕé ļöçàļ ţö à ḿàçĥîñé öŕ à ŕéþöšîţöŕý. À ƒöüŕţĥ àŕŕàñĝéḿéñţ îš ĥöšţéđ: à Ƃöŵŕàîñ šéŕṽéŕ ĥöļđš öñé ŵöŕķšþàçé-ļéṽéļ çöñţéñţ ḿéḿöŕý àñđ ţéŕḿš šţöŕé šĥàŕéđ àçŕöšš þŕöĵéçţš, þéöþļé, àñđ àĝéñţš, àñđ kapi push / kapi pull çöññéçţ à ķàþî þŕöĵéçţ ţö îţ. Šéé ţĥé Ƃöŵŕàîñ đöçüḿéñţàţîöñ. :::

Çöñţéñţ ḿéḿöŕý àñđ ŕéṽîéŵ đéçîšîöñš​

Ţĥé þŕöĵéçţ çöñţéñţ ḿéḿöŕý îš à ŕéçýçļé çöŕþüš: šöüŕçé→ţàŕĝéţ þàîŕš ŕéüšéđ ţö þŕé-ƒîļļ àñđ ļéṽéŕàĝé ƒüţüŕé ţŕàñšļàţîöñ. Ŕéṽîéŵ đéçîšîöñš àŕé ķéþţ éļšéŵĥéŕé. Ŵĥéţĥéŕ à þéŕšöñ ĥàš àþþŕöṽéđ à þàŕţîçüļàŕ ţàŕĝéţ îš ŕéçöŕđéđ îñ ţĥé þŕöĵéçţ šţöŕé'š đéçîšîöñ ŕéçöŕđ. Àþþŕöṽîñĝ à ƃļöçķ (à decide öþéŕàţîöñ ţĥŕöüĝĥ kapi apply) ŵŕîţéš ţĥàţ ŕéçöŕđ; àđđîñĝ à ḿéḿöŕý þàîŕ (à memory öþéŕàţîöñ ţĥŕöüĝĥ kapi apply) îš ŕéçýçļé ļéṽéŕàĝé àñđ đöéš ñöţ þŕöḿöţé à ƃļöçķ ţö ŕéṽîéŵéđ.

Ñöţé öñ ļöçàļé ƒļàĝš​

kapi memory àñđ kapi terms ţàķé ţĥé ļöçàļé ŵîţĥ -s/--source-locale àñđ -t/--target-locale. Ţĥé ţööļ çöḿḿàñđš ţĥàţ ŕéàđ ţĥéšé šţöŕéš (kapi exec recycle, kapi exec term-check) îñšţéàđ üšé ţĥé þŕöçéššîñĝ ƒļàĝš --source-lang àñđ --target-lang, çöñšîšţéñţ ŵîţĥ ţĥé öţĥéŕ ţööļš.

Ñéẋţ​