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

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

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

Ţĥé ţŕàñšļàţîöñš kapi ŕéüšéš àñđ ţĥé ţéŕḿš îţ ķééþš çöñšîšţéñţ àŕé ķéþţ îñ à šḿàļļ đàţàƃàšé öñ đîšķ. Ţĥàţ đàţàƃàšé çàñ ļîṽé îñ öñé öƒ ţĥŕéé þļàçéš, àñđ ŵĥîçĥ öñé à çöḿḿàñđ üšéš îš đéçîđéđ ƃý à ƒļàĝ öŕ, ŵîţĥ ñö ƒļàĝ, ƃý ŵĥéţĥéŕ à kapi þŕöĵéçţ îš îñ šçöþé. Ţĥé šàḿé ţĥŕéé ḿöđéļš àþþļý ţö ƃöţĥ šţöŕéš; öüţšîđé à þŕöĵéçţ öñļý ţĥé đéƒàüļţ ƒîļéñàḿé đéŕš (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. À þŕöĵéçţ'š àüţĥöŕîţàţîṽé šţöŕé​

Ŵĥéñ à çöḿḿàñđ ŕüñš îñšîđé à kapi þŕöĵéçţ, àñđ ñö --name, --local, öŕ --file ƒļàĝ îš ĝîṽéñ, kapi memory àñđ kapi terms ŕéšöļṽé ţĥé þŕöĵéçţ'š àüţĥöŕîţàţîṽé šţöŕéš, ƃöţĥ öƒ ŵĥîçĥ ļîṽé àš ţàƃļéš îñšîđé ţĥé þŕöĵéçţ'š šîñĝļé đàţàƃàšé àţ <project-root>/.kapi/work/store.db. Ţĥé þŕöĵéçţ îš ƒöüñđ ƃý ŵàļķîñĝ üþ ţĥé đîŕéçţöŕý ţŕéé ƒŕöḿ ţĥé çüŕŕéñţ đîŕéçţöŕý, ĝîţ-šţýļé.

Ţĥöšé ţàƃļéš àŕé à þŕöĵéçţîöñ öƒ ŵĥàţ ţĥé þŕöĵéçţ çöḿḿîţš: ţĥé ţéŕḿš ƃüñđļé ţĥé ŕéçîþé ƃîñđš ŵîţĥ defaults.terms_source àñđ ţĥé çöñţéñţ-ḿéḿöŕý ƃüñđļé îţ ƃîñđš ŵîţĥ defaults.memory_source. Éđîţ ţĥé ƃüñđļé, àñđ ţĥé šţöŕé ƒöļļöŵš; đéļéţé ţĥé šţöŕé, àñđ îţ îš ŕéƃüîļţ. Šéé ţĥé þŕöĵéçţ šţöŕé.

Ţĥé šţöŕé îš ŵĥàţ 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/work/store.db.
kapi exec recycle messages.json --target-lang fr --memory corporate-en-fr
kapi exec term-check 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 þŕöĵéçţţàƃļéš îñ <root>/.kapi/work/store.dbà ŕéþöšîţöŕý ýöü ţŕàñšļàţé ŕéþéàţéđļý

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

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

Ţĥé þŕöĵéçţ çöñţéñţ ḿéḿöŕý îš à ŕéçýçļé çöŕþüš: šöüŕçé→ţàŕĝéţ þàîŕš ŕéüšéđ ţö þŕé-ƒîļļ àñđ ļéṽéŕàĝé ƒüţüŕé ţŕàñšļàţîöñ. Îţ îš ñöţ ŵĥéŕé à ŕéṽîéŵ đéçîšîöñ ļàñđš. Ŵĥéţĥéŕ à þéŕšöñ ĥàš àþþŕöṽéđ öŕ šîĝñéđ öƒƒ à þàŕţîçüļàŕ ţàŕĝéţ îš à ŵöŕķƒļöŵ đéçîšîöñ, ĥéļđ îñ ţĥé þŕöĵéçţ šţöŕé'š ŵöŕķîñĝ šéţ àñđ çöḿḿîţţéđ ţö .kapi/state/*.jsonl ƃý kapi commit. Àþþŕöṽîñĝ à üñîţ (kapi apply ŵîţĥ kind:"review") ŵŕîţéš ţĥàţ ŕéçöŕđ; àđđîñĝ à ḿéḿöŕý þàîŕ (kapi apply ŵîţĥ kind:"memory") îš ŕéçýçļé ļéṽéŕàĝé àñđ đöéš ñöţ þŕöḿöţé à üñîţ ţö ŕéṽîéŵéđ.

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

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

Ñéẋţ​