Kalo te përmbajtja kryesore

Përkthimet

Sajti about përdor JSON i18next te about/public/translations/{lang}/default.json. Përkthimet burimore të Docusaurus ndodhen veçmas te docs/i18n/.

Çelësat e sajtit about​

Përdorni .agents/skills/translate/SKILL.md. Zbuloni gjuhët aktuale nga disku dhe ruani vendmbajtësit, markup-in, termat teknikë dhe emrat e markave. Për kërkesa më të mëdha, agjentët fëmijë mund të gjenerojnë harta të pavarura, por të gjitha shkrimet në skedarët gjuhësorë i zbaton në seri një prind i vetëm; përditësuesi nuk ka kyç shkrimi.

Përdorni një shteg unik për hartën, në pronësi të detyrës. Shikojeni paraprakisht me node scripts/update-translations.js --key <key> --map <map.json> --include-en --dry, pastaj zbatojeni me të njëjtat argumente dhe --write. Pas shkrimit verifikoni mbulimin/vlerat dhe hiqni vetëm hartat e përkohshme që i zotëron kjo detyrë.

Përdorni --delete për heqjet e kërkuara. Inspektoni gjetjet e --audit --dry përpara një --audit --write të autorizuar; çelësat dinamikë të përkthimit kërkojnë rishikim manual të kodit burimor. Kopjojeni tekstin anglisht në çdo gjuhë vetëm për një term teknik, një markë ose një vendmbajtës.

Faqet e Docusaurus​

scripts/translate-docs.py është një shkrues masiv për të gjitha faqet/gjuhët dhe nuk ka filtër për skedarë të veçantë; mos e përdorni për një redaktim të ngushtë përkthimi. scripts/check-docs-translations.py është verifikuesi vetëm për lexim dhe mbështet --locales dhe --paths.

Mbajini blloqet e kodit, lidhjet, kodin brenda rreshtit, adresat e kontratave, titujt, tabelat dhe kutitë e shënimeve (admonitions) të përputhura me burimin anglisht. Zgjidhni gabimet e verifikuesit; paralajmërimet frontmatter-untranslated për emra markash mund të jenë të pritshme. Ndiqni docs/AGENTS.md dhe ndërtoni përmes rrënjës kur ndryshoni temën ose sjelljen i18n të dokumentacionit, që dalja statike dhe Pagefind të mbeten të përputhura.

Rishikimi semantik opsional​

Për çelësa të zgjedhur i18next, përdorni scripts/jev/translation-README.md. Për faqet e dokumentacionit, ekzekutoni së pari node scripts/jev/docs-translations.mjs --locales it,de --paths browser-p2p.md. Kjo kërkon një përzgjedhje të shprehur gjuhësh/faqesh, ekzekuton verifikuesin strukturor dhe e raporton rishikimin semantik si të paverifikuar derisa të aktivizohet inferenca e drejtpërdrejtë. Shtoni --live vetëm me autorizimin e ofruesit dhe buxhetin e detyrës; konfigurimi privat i përbashkët i makinës siguron kredencialet dhe një model të fiksuar. Variablat e mjedisit dhe --model mund ta mbishkruajnë këtë konfigurim. Komanda nuk i redakton kurrë përkthimet.

Përshtatësi i faqeve ruan kontekstin e plotë të faqes dhe e kufizon çdo faqe në 24 KB dhe çdo ekzekutim në 30 çifte. Për faqe më të mëdha, përgatitni çifte paragrafësh burim/përkthim të përafruara shprehimisht për translations.mjs --pairs; mos i çiftoni paragrafët automatikisht sipas indeksit. Rezultatet semantike janë këshilluese: inspektoni problemet dhe pasiguritë e raportuara dhe ruani kontrollet deterministe të kodit/lidhjeve/adresave.