ķàþî þüļļ

Ƃŕîñĝ ţĥé ţéàḿ'š ŵöŕķ îñţö ýöüŕ çĥéçķöüţ: ţĥé ŕéšüļţš öƒ šéŕṽéŕ ŕüñš àñđ ŕéṽîéŵ, ţĥé ŵöŕķšþàçé'š ĝöṽéŕñéđ ţéŕḿš, àñđ ţĥé ŕéçîþé çĥàñĝéš à þéŕšöñ àþþŕöṽéđ. kapi pull öñļý ḿöṽéš çöñţéñţ àñđ đŕàƒţš ñöţĥîñĝ. À ţéàḿḿàţé îñ ţĥé ƃŕöŵšéŕ öŕ îñ Ķàþî Đéšķţöþ šééš ţĥé šàḿé ŕéšüļţš öñ ţĥé šéŕṽéŕ.

Üšàĝé

kapi pull [flags]

Éẋàḿþļéš

# Pull everything that changed on the server
kapi pull

# Pull only French results
kapi pull --locale fr

# Pull several locales
kapi pull --locale fr --locale de

# Show what would be pulled without changing files
kapi pull --dry-run

# Re-download everything, unchanged blocks included
kapi pull --force

# Refresh only the workspace's governed terms into the local terms store
kapi pull --concepts

# Example output:
# Pulled 12 blocks for 2 locales
# Updated 4 file(s)

Öþţîöñš

Ƒļàĝ	Đéšçŕîþţîöñ	Đéƒàüļţ
--locale	Ţàŕĝéţ ļöçàļéš ţö þüļļ (ŕéþéàţàƃļé)	àļļ
--force	Ŕé-đöŵñļöàđ éṽéŕýţĥîñĝ, îĝñöŕîñĝ ŵĥàţ ţĥé ţŕéé àļŕéàđý ĥöļđš	false
--dry-run	Šĥöŵ ŵĥàţ ŵöüļđ ƃé þüļļéđ ŵîţĥöüţ çĥàñĝîñĝ ƒîļéš	false
--concepts	Šýñç öñļý ţĥé ŵöŕķšþàçé ţéŕḿš (çöñçéþţš + ŕéļàţîöñš) îñţö ţĥé ļöçàļ ţéŕḿš šţöŕé; ñö çöñţéñţ ţŕàñšþöŕţ, ñö àüţöḿàţîöñš	false

Ŵĥàţ þüļļ ŵŕîţéš

À þüļļ ŕéàđš ţĥé šéŕṽéŕ'š ţŕéé àñđ ţĥé çĥàñĝéš šîñçé ţĥé ŕéƒ ţĥé çļîéñţ ļàšţ çöḿḿîţţéđ öŕ þüļļéđ (ţĥé þŕöţöçöļ îš đéšçŕîƃéđ öñçé, öñ kapi push), àñđ ŵŕîţéš šéṽéŕàļ ţĥîñĝš îñţö ţĥé ţŕéé:

• Ŕéçîþé çĥàñĝéš, ƒîŕšţ. Ŵĥéñ à þéŕšöñ àþþŕöṽéđ àñ àẋîš à çöñţéẋţ šçàñ þŕöþöšéđ, ţĥé àþþŕöṽàļ îš ŵàîţîñĝ àš à þéñđîñĝ ŕéçîþé çĥàñĝé. Þüļļ ŵŕîţéš îţ îñţö kapi.yaml àš defaults.coordinates.<axis> àñđ ḿàŕķš îţ šéţţļéđ öñ ţĥé šéŕṽéŕ. À ṽàļüé ţĥé ŕéçîþé àļŕéàđý ĥöļđš çöüñţš àš àþþļîéđ. À ṽàļüé ţĥàţ đîšàĝŕééš ŵîţĥ ţĥé ŕéçîþé îš ŕéþöŕţéđ àš à çöñƒļîçţ ƒöŕ ýöü ţö ŕéšöļṽé. Ýöü ŕéṽîéŵ ŕéçîþé çĥàñĝéš îñ ĝîţ, šö à ƒàîļüŕé ĥéŕé ñéṽéŕ ƒàîļš ţĥé þüļļ.
• Çöñţéñţ. Ţàŕĝéţš þŕöđüçéđ ƃý ŕüñš àñđ þŕöḿöţéđ ƃý ŕéṽîéŵ ļàñđ îñ ţĥé ţàŕĝéţ ƒîļéš ţĥé ŕéçîþé'š collections: ñàḿé, ŵîţĥ ţĥé ƒöŕḿàţ'š öŵñ ŵŕîţéŕ. À ƒîļé ŵĥöšé ţàŕĝéţš đîđ ñöţ çĥàñĝé îš ļéƒţ üñţöüçĥéđ.
• Đéçîšîöñš. Ŕéṽîéŵ đéçîšîöñš ḿàđé öñ ţĥé šéŕṽéŕ àŕé ŕéçöŕđéđ îñ ţĥé þŕöĵéçţ'š đéçîšîöñ ļéđĝéŕ, ŵĥéŕé ţĥéý ţàķé 郃éçţ àţ öñçé àñđ éṽéŕý çĥéçķöüţ öƒ ţĥé þŕöĵéçţ ŕéàđš ţĥéḿ. Ţĥé þüļļ ŵŕîţéš ñö ƒîļé.
• Ĝöṽéŕñéđ ţéŕḿš. Ŵĥéñ ţĥé þŕöĵéçţ îš çļàîḿéđ îñţö à ŵöŕķšþàçé, þüļļ šñàþšĥöţš ţĥé ŵöŕķšþàçé'š çöñçéþţš àñđ ţĥéîŕ ŕéļàţîöñš îñţö ţĥé þŕöĵéçţ'š ţéŕḿš šţöŕé àñđ ŕéçöŕđš à ƃàšéļîñé, šö à ļàţéŕ kapi push çàñ đ ļöçàļ ţéŕḿš éđîţš àĝàîñšţ îţ àñđ kapi check --ship ĝàţéš öƒƒļîñé àĝàîñšţ ţĥé šàḿé ĝöṽéŕñéđ ţéŕḿš.

Þüļļ àļšö ŕéþöŕţš ŵĥàţ îţ đîđ ñöţ àþþļý:

• Ŕéţîŕéđ îţéḿš. Þüļļ šķîþš àñ îţéḿ ţĥé šéŕṽéŕ šţîļļ šéñđš ŵĥéñ îţš šöüŕçé îš ĝöñé ƒŕöḿ ţĥîš çĥéçķöüţ.
• Ƃļöçķš ŵîţĥöüţ à ƒîļé. À ƃļöçķ ţĥé šéŕṽéŕ šéñđš ŵîţĥ àñ éḿþţý îţéḿ ñàḿé, öŕ ŵîţĥ öñé ţĥàţ þöîñţš öüţšîđé ţĥé þŕöĵéçţ, ĥàš ñö ƒîļé ţö ļàñđ îñ. Þüļļ šķîþš îţ, þŕîñţš ĥöŵ ḿàñý îţ šķîþþéđ ŵîţĥ ţĥé ƒîŕšţ ƃļöçķ îđš, àñđ ḿöṽéš þàšţ îţ, šö ţĥé ñéẋţ þüļļ çöñţîñüéš ƒŕöḿ ţĥéŕé.
• Ĝöṽéŕñàñçé đîṽéŕĝéñçé. Þüļļ ŕéþöŕţš ţĥé çöļļéçţîöñš ţĥé šéŕṽéŕ ĥöļđš àñđ ĥöŵ îţ ĝöṽéŕñš ţĥéḿ. Ƒöŕ à çöļļéçţîöñ ţĥîš ŕéçîþé đéçļàŕéš, kapi.yaml đéçîđéš. Þüļļ ŕéþöŕţš à þöîñţ, çĥàññéļ öŕ ṽöîçé ţĥàţ đéŕš öñ ţĥé šéŕṽéŕ, àñđ ýöü ŕéšöļṽé îţ îñ ĝîţ.

Éẋîţ çöđéš

• 0: šüççéšš (çĥàñĝéš þüļļéđ öŕ àļŕéàđý üþ ţö đàţé)
• 1: éŕŕöŕ (šéŕṽéŕ üñàṽàîļàƃļé, àüţĥ ƒàîļéđ, àñđ šö öñ)

Ŕéļàţéđ çöḿḿàñđš

• kapi push: ţĥé þŕöţöçöļ, àñđ ŵĥàţ à þüšĥ đéçļàŕéš
• kapi status: çöṽéŕàĝé, šĥîþ šţàñđîñĝ, àñđ ŵĥàţ îš þéñđîñĝ
• kapi diff: ţĥé çĥàñĝéđ ƃļöçķš, þéŕ ƒîļé
• kapi up: þüšĥ, ŕüñ öñ ţĥé šéŕṽéŕ, þüļļ

Ŵĥéñ ţö üšé

Þüļļ ƒŕöḿ Ƃöŵŕàîñ Šéŕṽéŕ ţö:

• Ƒéţçĥ ŕéšüļţš öƒ ŕüñš àñđ ŕéṽîéŵ çöḿþļéţéđ ƃý ţéàḿḿàţéš
• Ţàķé àñ àþþŕöṽéđ àẋîš îñţö ţĥé ŕéçîþé, ƒöŕ ŕéṽîéŵ îñ ĝîţ
• Šýñç ĝöṽéŕñéđ ţéŕḿš, šö kapi check --ship ĝàţéš öƒƒļîñé
• Üþđàţé šöüŕçé çöñţéñţ ţĥàţ éñţéŕéđ Ƃöŵŕàîñ ţĥŕöüĝĥ àñöţĥéŕ çöññéçţöŕ

Šöüŕçé çöñţéñţ çàñ àļšö çöḿé ƒŕöḿ à šéŕṽéŕ-šîđé çöññéçţöŕ: à çöñţéñţ þļàţƒöŕḿ, à đéšîĝñ ţööļ öŕ à ĝîţ ĥöšţ. kapi pull ƃŕîñĝš ţĥöšé çĥàñĝéš đöŵñ, šö ţĥé çĥéçķöüţ ḿîŕŕöŕš çöñţéñţ ţĥàţ éñţéŕéđ Ƃöŵŕàîñ éļšéŵĥéŕé.