Ƒöŕḿàţš

À ƒöŕḿàţ îñ ñéöķàþî îš à þàîŕéđ ŕéàđéŕ àñđ ŵŕîţéŕ ƒöŕ à đöçüḿéñţ ţýþé. Ţĥé ŕéàđéŕ ţüŕñš à ƒîļé îñţö à šţŕéàḿ öƒ Þàŕţš (ţĥé çöñţéñţ ƃļöçķš àñđ ţĥé šüŕŕöüñđîñĝ šţŕüçţüŕé), àñđ ţĥé ŵŕîţéŕ ţüŕñš ţĥàţ šţŕéàḿ ƃàçķ îñţö à ƒîļé. Éṽéŕý ŕéàđéŕ þŕöđüçéš ţĥé šàḿé Þàŕţš, šö ţĥé šàḿé ţööļš àñđ ƒļöŵš öþéŕàţé öñ àñý ƒöŕḿàţ. À ţööļ ĥàñđļéš à Ƃļöçķ ţĥé šàḿé ŵàý ŵĥéţĥéŕ îţ çàḿé ƒŕöḿ ĴŠÖÑ, ĤŢḾĻ öŕ ĐÖÇẊ.

Ţĥé đîàĝŕàḿ šĥöŵš öñé ŕöüñđ ţŕîþ: ţĥé ŕéàđéŕ ŕéçöŕđš ţĥé šķéļéţöñ, àñđ ţĥé ŵŕîţéŕ ŕéþļàýš îţ àŕöüñđ ţĥé éđîţéđ ƃļöçķš.

:::ţîþ Šéé ţĥé šķéļéţöñ þŕéšéŕṽéđ Ŕéàđîñĝ à ƒîļé šþļîţš îţ îñţö çöñţéñţ ƃļöçķš àñđ à ñöñ-ţŕàñšļàţàƃļé šķéļéţöñ: éṽéŕý ţàĝ, ķéý, àţţŕîƃüţé, àñđ đéļîḿîţéŕ ţĥé ŵŕîţéŕ ñééđš ţö ŕéþŕöđüçé ţĥé öŕîĝîñàļ šţŕüçţüŕé. Ŕüñ à ƒîļé ţĥŕöüĝĥ pseudo-translate ƃéļöŵ àñđ çöḿþàŕé ţĥé šöüŕçé ŵîţĥ ţĥé ŕöüñđ-ţŕîþþéđ öüţþüţ: öñļý ţĥé ļéàƒ ţéẋţ çĥàñĝéš, ŵĥîļé ţĥé šķéļéţöñ çöḿéš ƃàçķ ƃýţé-ƒöŕ-ƃýţé. Ţĥîš ŕüñš ţĥé ŕéàļ kapi ŕéàđéŕ àñđ ŵŕîţéŕ îñ ýöüŕ ƃŕöŵšéŕ ṽîà ŴéƃÀššéḿƃļý. :::

Ļöàđîñĝ ţĥé îñţéŕàçţîṽé ļàƃ…

ñéöķàþî šĥîþš ƃüîļţ-îñ ŕéàđéŕš àñđ ŵŕîţéŕš šþàññîñĝ šéṽéŕàļ ƒàḿîļîéš:

• Šöƒţŵàŕé î18ñ çàţàļöĝš: ĴŠÖÑ (îñçļüđîñĝ î18ñéẋţ, ÀŔƂ, àñđ đéšîĝñ ţöķéñš), ÝÀḾĻ, Ĵàṽà þŕöþéŕţîéš, Àñđŕöîđ strings.xml, Àþþļé .strings/.xcstrings, ŔÉŠẊ, Ǫţ ŢŠ, ĝéţţéẋţ ÞÖ/ḾÖ, ÎÇÜ ḾéššàĝéƑöŕḿàţ.
• Đöçüḿéñţš & ḿàŕķüþ: Ḿàŕķđöŵñ àñđ ḾĐẊ, ĤŢḾĻ, ÀšçîîĐöç, ẊḾĻ (ŵîţĥ çöñƒîĝüŕàƃļé ţŕàñšļàţàƃļé éļéḿéñţš), þļàîñ ţéẋţ.
• Öƒƒîçé & þüƃļîšĥîñĝ: Öƒƒîçé Öþéñ ẊḾĻ (.docx, .xlsx, .pptx), ÖþéñĐöçüḿéñţ, ÉÞÜƂ, ÞĐƑ.
• Đàţà: ÇŠṼ/ŢŠṼ, ŵîţĥ çöļüḿñ-ŕöļé çöñƒîĝüŕàţîöñ.
• Šüƃţîţļéš & ḿéđîà: ŠüƃŔîþ (ŠŔŢ), ŴéƃṼŢŢ; îḿàĝéš, àüđîö, àñđ ṽîđéö àš þéŕ-ļöçàļé àššéţš.
• Šöüŕçé çöđé: ţĥé þŕöšé îñšîđé šöüŕçé ƒîļéš, ŕéàđ ŵîţĥ à ĝŕàḿḿàŕ (à þàçķàĝé çàšķ'š đéšçŕîþţîöñ, à šţŕîñĝ ļîţéŕàļ îñ Ĝö öŕ ŢýþéŠçŕîþţ), þŕöṽîđéđ ƃý ţĥé kapi-sourcecode þļüĝîñ. Îţ îš ŕéàđ-öñļý: à çöļļéçţîöñ îñ ţĥîš ƒöŕḿàţ îš đéçļàŕéđ source_only: true, àñđ ķàþî çĥéçķš îţ ŵîţĥöüţ ţŕàñšļàţîñĝ îţ. Šéé Šöüŕçé çöđé àñđ Ṽéŕîƒý çöñţéñţ îñ šöüŕçé ƒîļéš.
• Ƃîļîñĝüàļ îñţéŕçĥàñĝé: ẊĻÎƑƑ 1.2 àñđ 2.ẋ, ÞÖ, ŢḾẊ, àñđ ţĥé ñàţîṽé Ķàþî ƒöŕḿàţ ƒàḿîļý, ţĥé ţŕàñšļàţöŕ-ĥàñđöƒƒ ļàýéŕ.
• Çöñţàîñéŕš & àŕçĥîṽéš: ŽÎÞ, ŢÀŔ, àñđ ĝžîþ-çöḿþŕéššéđ ŢÀŔ, ţŕéàţéđ àš à ƒöļđéŕ öƒ šüƃ-đöçüḿéñţš (šéé ƃéļöŵ).

Àñ îḿàĝé îš ŕéàđ àš àñ àššéţ îñ îţš öŵñ ŕîĝĥţ: ţĥé þîçţüŕé îţšéļƒ îš ţĥé üñîţ à ŵöŕķƒļöŵ çàñ ŕéþļàçé ŵîţĥ à þéŕ-ļöçàļé ṽàŕîàñţ. Ŵîţĥ ţĥé kapi-vision þļüĝîñ îñšţàļļéđ (àñđ ţĥé ocr/layout öþţîöñš öñ), ţĥé ŕéàđéŕ àļšö éẋţŕàçţš îñ-îḿàĝé ţéẋţ àñđ đöçüḿéñţ ļàýöüţ (ŕéĝîöñš, ŕéàđîñĝ öŕđéŕ, ţàƃļéš), ţüŕñîñĝ à šçŕééñšĥöţ öŕ šçàññéđ þàĝé îñţö šţŕüçţüŕéđ çöñţéñţ. Ţĥé đéšîĝñ, àñđ ţĥé ƒüļļ šéţ öƒ îḿàĝé-àđàþţàţîöñ ḿöđéš, àŕé đéšçŕîƃéđ îñ Ḿ-03.

ÞĐƑ îš ŕéàđ ƃý Ĝööĝļé'š ÞĐƑîüḿ: öñ ţĥé đéšķţöþ àñđ ÇĻÎ ţĥŕöüĝĥ ţĥé kapi-pdfium þļüĝîñ, àñđ îñ ţĥé ƃŕöŵšéŕ ţĥŕöüĝĥ ÞĐƑîüḿ çöḿþîļéđ ţö ŴéƃÀššéḿƃļý. Ƃéýöñđ ţéẋţ, îţ ŕéçöṽéŕš éàçĥ ƒŕàĝḿéñţ'š þöšîţîöñ öñ ţĥé þàĝé (ĝéöḿéţŕý) àñđ ţĥé đöçüḿéñţ'š šţŕüçţüŕé (ĥéàđîñĝš, þàŕàĝŕàþĥš, àñđ ţàƃļéš) ƒŕöḿ ţĥé ÞĐƑ'š öŵñ ţàĝš ŵĥéŕé þŕéšéñţ àñđ ƃý ĝéöḿéţŕîç îñƒéŕéñçé öţĥéŕŵîšé. Ýöü çàñ ţŕý îţ öñ ýöüŕ öŵñ ƒîļéš îñ ţĥé Šţŕüçţüŕé àñđ ļàýöüţ ļàƃ; ţĥé đéšîĝñ îš đéšçŕîƃéđ îñ É-08.

Àñ àŕçĥîṽé (à ŽÎÞ, ŢÀŔ, öŕ ĝžîþ-çöḿþŕéššéđ ŢÀŔ) îš à ñàḿéšþàçé öƒ îññéŕ đöçüḿéñţš, šö ķàþî ĥàñđļéš îţ àš à çöñţàîñéŕ ƃîñđîñĝ (É-04), ñöţ àš à ƒöŕḿàţ ŵîţĥ à ŵŕîţéŕ. Þöîñţéđ àţ àñ öüţþüţ-þŕöđüçîñĝ çöḿḿàñđ, éàçĥ éñţŕý îš þŕöçéššéđ àš îţš öŵñ ƒîļé ŕüñ (ţĥŕöüĝĥ ţĥàţ éñţŕý'š ñöŕḿàļ ŕéàđéŕ àñđ ŵŕîţéŕ ŵîţĥ ƒüļļ šķéļéţöñ ŕöüñđ-ţŕîþ) àñđ ţĥé ŕéšüļţš àŕé ŕéþàçķéđ öṽéŕ ţĥé öŕîĝîñàļ çöñţàîñéŕ, çöþýîñĝ éṽéŕý öţĥéŕ ḿéḿƃéŕ ƃýţé-ƒöŕ-ƃýţé. Ƃéçàüšé éàçĥ éñţŕý îš à ŕéàļ, šţàñđàļöñé ƒîļé ŕüñ, à þàçķàĝéđ ƒöŕḿàţ šüçĥ àš à ĐÖÇẊ öŕ ÉÞÜƂ îñšîđé ţĥé àŕçĥîṽé ŕöüñđ-ţŕîþš ƒàîţĥƒüļļý, àñđ éàçĥ éñţŕý ŕéšöļṽéš îţš öŵñ ƒöŕḿàţ çöñƒîĝüŕàţîöñ. Ƃîñàŕý àššéţš, ñéšţéđ çöñţàîñéŕš, àñđ ƃîļîñĝüàļ îñţéŕçĥàñĝé ƒîļéš þàšš ţĥŕöüĝĥ üñçĥàñĝéđ. Šö kapi pseudo-translate bundle.zip -o out.zip þšéüđö-ţŕàñšļàţéš éṽéŕý ŕéçöĝñîšéđ ƒîļé îñšîđé îţ, ñéšţéđ Öƒƒîçé đöçüḿéñţš îñçļüđéđ, îñ öñé þàšš. Ƒöŕ îñšþéçţîöñ, à ŕéàđ-öñļý archive ŕéàđéŕ šüŕƒàçéš éàçĥ éñţŕý'š çöñţéñţ šö kapi inspect bundle.zip šĥöŵš ŵĥàţ îš îñšîđé.

Éàçĥ ƒöŕḿàţ éẋþöšéš îţš öŵñ çöñƒîĝüŕàţîöñ (éẋţŕàçţîöñ ŕüļéš, šéĝḿéñţàţîöñ, îñļîñé-çöđé ĥàñđļîñĝ). Ţĥé Ƒöŕḿàţ Ŕéƒéŕéñçé îš ĝéñéŕàţéđ ƒŕöḿ ţĥé ƒöŕḿàţ ŕéĝîšţŕý, šö îţ ļîšţš ţĥé ƒöŕḿàţš àñđ þàŕàḿéţéŕš îñ ţĥé çüŕŕéñţ ƃüîļđ.

Ĥöŵ ķàþî ŕéàđš à ƒîļé

Ƃéļöŵ, ķàþî ŕéàđš àñ Àñđŕöîđ strings.xml ŕéšöüŕçé àñđ þŕöđüçéš ţĥé çöñţéñţ ḿöđéļ: ţĥé ƃļöçķš, ţĥéîŕ îđéñţîƒîéŕš àñđ ţĥéîŕ šöüŕçé ţéẋţ. Ţĥîš îš ţĥé ŕéàđéŕ šţàĝé öƒ ţĥé þîþéļîñé, ŵîţĥ ñö ţŕàñšƒöŕḿàţîöñ àþþļîéđ:

Ţĥé šàḿé þàŕšéŕ, þöîñţéđ àţ à đéŕéñţ ƒöŕḿàţ, þŕöđüçéš ƃļöçķš öƒ ţĥé šàḿé šĥàþé. Ĥéŕé àñ ẊĻÎƑƑ ƃîļîñĝüàļ ƒîļé ŕéšöļṽéš ţö ţĥé šàḿé ķîñđ öƒ ƃļöçķ šţŕéàḿ:

Ţĥé ƃļöçķ šĥàþé îš ţĥé šàḿé, ƃüţ ƃîļîñĝüàļ ƒöŕḿàţš çàŕŕý ḿöŕé. À ḿöñöļîñĝüàļ ƒöŕḿàţ (ĴŠÖÑ, ÝÀḾĻ, þŕöþéŕţîéš) þŕöđüçéš ŵĥöļé-ƃļöçķ šöüŕçé çöñţéñţ ŵîţĥ ñö îñţéŕñàļ šéĝḿéñţ šţŕüçţüŕé. À ƃîļîñĝüàļ ƒöŕḿàţ (ẊĻÎƑƑ, ŢḾẊ) àđđîţîöñàļļý þöþüļàţéš šţàñđ-öƒƒ šéĝḿéñţàţîöñ àñđ àļîĝñḿéñţ öṽéŕļàýš: ţĥé ƒîļé'š šéĝḿéñţ ƃöüñđàŕîéš àñđ šöüŕçé↔ţàŕĝéţ þàîŕîñĝš àŕé ŕéçöŕđéđ àš öṽéŕļàýš öṽéŕ ţĥé ŕüñš, àñđ ţĥéý šüŕṽîṽé à ŕöüñđ ţŕîþ. Ţööļš àñđ ŵŕîţéŕš ŕéàđ ţĥöšé öṽéŕļàýš, àñđ ŵöŕķ àţ ŵĥöļé-ƃļöçķ ĝŕàñüļàŕîţý ŵĥéñ à ƒöŕḿàţ éḿîţš ñöñé.

Çöñţéñţ ƒîđéļîţý: çöñţéẋţ ƒöŕ îñĝéšţîöñ

Đöçüḿéñţš àļšö çöñţàîñ üšéƒüļ ţéẋţ öüţšîđé ţĥé çöñţéñţ šéļéçţéđ ƒöŕ ţŕàñšļàţîöñ: çöđé ļîšţîñĝš, îḿàĝé çàþţîöñš àñđ àļţ-ţéẋţ, ƒöŕḿüļàš, šţŕîñĝš ḿàŕķéđ đö-ñöţ-ţŕàñšļàţé, àñđ ṽàļüéš éẋçļüđéđ ƃý çöñƒîĝüŕàţîöñ. Àñ ĻĻḾ öŕ ŕéţŕîéṽàļ îñđéẋ ḿàý ñééđ ţĥîš ḿàţéŕîàļ ţö îñţéŕþŕéţ ţĥé đöçüḿéñţ.

Ƃý đéƒàüļţ, ñéöķàþî ŕéàđéŕš šüŕƒàçé ţĥîš çöñţéẋţüàļ çöñţéñţ àš ñöñ-ţŕàñšļàţàƃļé ƃļöçķš, öüţšîđé ţĥé šķéļéţöñ. Àñýţĥîñĝ ţĥàţ ŕéàđš ţĥé Þàŕţ šţŕéàḿ šééš šüçĥ à ƃļöçķ: ţĥé éđîţöŕ, àñ éẋþöŕţ ţö Ḿàŕķđöŵñ, àñ îñĝéšţîöñ þîþéļîñé. Éàçĥ çàŕŕîéš à ŕöļé (çöđé, ƒöŕḿüļà, çàþţîöñ, …) ţĥàţ ţéļļš çöñšüḿéŕš ŵĥàţ îţ îš. Ḿàçĥîñé ţŕàñšļàţîöñ šķîþš îţ, àñđ ţĥé ŵŕîţéŕ ŕéþļàýš îţš öŕîĝîñàļ ƃýţéš ṽéŕƃàţîḿ, šö ţĥé ŕöüñđ ţŕîþ îš üñàƒƒéçţéđ. Çöḿḿéñţš àñđ šîḿîļàŕ ḿéţàđàţà šüŕƒàçé àš đàţà öŕ ñöţéš àļöñĝšîđé ţĥé çöñţéñţ.

Éàçĥ ŕéàđéŕ ţĥàţ šüþþöŕţš ţĥîš éẋþöšéš àñ extractNonTranslatableContent öþţîöñ (öñ ƃý đéƒàüļţ) îñ ţĥé Ƒöŕḿàţ Ŕéƒéŕéñçé; šéţ îţ ţö ƒàļšé ţö ķééþ ţĥàţ çöñţéñţ îñ ţĥé šķéļéţöñ öñļý. Ţĥé đéšîĝñ, àñđ ŵĥý îţ ļéàṽéš ţŕàñšļàţîöñ öüţþüţ àñđ ţĥé ŕöüñđ-ţŕîþ ĝüàŕàñţéé üñçĥàñĝéđ, îš đéšçŕîƃéđ îñ É-02. Éǫüàţîöñš ĝéţ ţĥéîŕ öŵñ ĥàñđļîñĝ: Ŵöŕđ/ÖḾḾĻ ƒöŕḿüļàš àŕé çöñṽéŕţéđ ţö ĻàŢéẊ/ḾàţĥḾĻ àñđ ŕéñđéŕéđ öñ çŕöšš-ƒöŕḿàţ éẋþöŕţ, àñđ ţĥé ñàţüŕàļ-ļàñĝüàĝé þŕöšé îñšîđé àñ éǫüàţîöñ îš ţŕàñšļàţàƃļé; šéé ķçöñṽ àñđ Ḿ-04.

Þļüĝîñ ƒöŕḿàţš

Þļüĝîñš çàñ ŕéĝîšţéŕ àđđîţîöñàļ ŕéàđéŕš àñđ ŵŕîţéŕš àļöñĝšîđé ţĥé ƃüîļţ-îñ šéţ: ţĥé kapi-pdfium þļüĝîñ àđđš ţĥé ÞĐƑ ŕéàđéŕ, ƒöŕ éẋàḿþļé. Öñçé îñšţàļļéđ, à þļüĝîñ'š ƒöŕḿàţš þàŕţîçîþàţé îñ đéţéçţîöñ, kapi formats, àñđ ƒļöŵš éẋàçţļý ļîķé ţĥé ƃüîļţ-îñ öñéš.

Ƒöŕḿàţ Đéţéçţîöñ

ñéöķàþî đéţéçţš à ƒîļé'š ƒöŕḿàţ ƒŕöḿ ţĥéšé šîĝñàļš, îñ öŕđéŕ:

1. Éẋþļîçîţ ḾÎḾÉ ţýþé (îƒ þŕöṽîđéđ)
2. Ƒîļé éẋţéñšîöñ ḿàþþîñĝ
3. Ḿàĝîç ƃýţéš / çöñţéñţ šñîñĝ

Ýöü çàñ öṽéŕŕîđé đéţéçţîöñ ŵîţĥ ţĥé --format ƒļàĝ öñ àñý çöḿḿàñđ.

Ļîšţîñĝ Ƒöŕḿàţš

kapi formats

Üšé --mime öŕ --ext ţö ƒîļţéŕ:

kapi formats --mime text/html
kapi formats --ext .docx

Îñţéŕàçţîṽé Ƒöŕḿàţ Ŕéƒéŕéñçé

Šéé ţĥé Ƒöŕḿàţ Ŕéƒéŕéñçé þàĝé ƒöŕ îñţéŕàçţîṽé đöçüḿéñţàţîöñ öƒ àļļ ƒöŕḿàţš ŵîţĥ çöñƒîĝüŕàƃļé þàŕàḿéţéŕš.

Ŕéļàţéđ

• Çöñţéñţ Ḿöđéļ: ţĥé Þàŕţš à ŕéàđéŕ þŕöđüçéš.
• Îñļîñé Ƒöŕḿàţţîñĝ: ĥöŵ ḿàŕķüþ îñšîđé à ƃļöçķ ƃéçöḿéš ŕüñš.
• Ƒöŕḿàţ ḿàţüŕîţý: ţĥé éṽîđéñçé ƒöŕ éàçĥ ŕéàđéŕ àñđ ŵŕîţéŕ.