Vertimai

Peržiūrėti kaip Markdown

Blockstudio pateikia vertimus aplanke languages. WordPress juos naudoja, kai svetainės arba naudotojo profilyje nustatyta kalba sutampa su viena iš jų. Tai veikia vienodai, kai Blockstudio naudojamas kaip papildinys, privalomas naudoti papildinys arba Composer paketas.

Prieinamos kalbos

Blockstudio pateikia vertimus WordPress lokalėms, įrašytoms kartu pateikiamame languages/locales.json, įskaitant regioninius ir formalius bei neformalius variantus. Anglų kalba (en_US) yra šaltinio kalba, todėl jai vertimo failo nereikia. Sąraše sujungtos WordPress palaikomos GlotPress lokalės ir variantai, kuriuos galima rasti WordPress pagrindinio kodo vertimų API.

Esami vokiečių (de_DE) ir formaliosios vokiečių kalbos (de_DE_formal) vertimai išsaugoti. Papildomus vertimus automatiškai sugeneravo DI, naudodamas GPT-6 Luna; jų .po antraštėse jie pažymėti kaip sugeneruoti mašinos. Jie atitinka automatinius išsamumo ir formato patikrinimus, tačiau gimtakalbiai juos peržiūrėjo ne visus. Pataisymai laukiami.

Vertimai apima blokų redaktoriaus laukų valdiklius, administravimo puslapį, drobę, kūrimo įrankių perdangą ir REST galinių punktų pranešimus. Jūsų block.json failuose esantys užrašai ir pagalbos tekstai priklauso jūsų temai arba papildiniui ir naudoja jo teksto sritį.

Pasirinkite kalbą skiltyje Nustatymai > Bendrieji > Svetainės kalba arba nustatykite asmeninę kalbą savo WordPress profilyje. Blockstudio automatiškai naudoja šią lokalę. Jis neprideda kalbų prie WordPress kalbų pasirinkimo sąrašo: lokalė taip pat turi būti prieinama jūsų WordPress įdiegtyje. Svetainėje nereikia siųsti DI užklausų, prenumeruoti vertimo paslaugos ar nustatyti papildomų vykdymo parametrų.

Vertimo perrašymas

Vertimo failai, esantys wp-content/languages/plugins, turi pirmenybę prieš kartu pateikiamus failus tiek PHP eilutėms (blockstudio-de_DE.mo arba blockstudio-de_DE.l10n.php), tiek scenarijams (po vieną failą kiekvienam scenarijaus identifikatoriui, pavyzdžiui, blockstudio-de_DE-blockstudio-blocks.json).

Prisidėkite prie vertimo

Kiekvienos kalbos vertimas yra .po failas, kurį galite redaguoti bet kuria tekstų rengykle arba vertimo įrankiu, pavyzdžiui, Poedit. Pataisymai ir naujos kalbos laukiami kaip užklausos sujungti pakeitimus.

Norėdami pridėti kalbą, nukopijuokite languages/blockstudio.pot į languages/blockstudio-<locale>.po, pavyzdžiui, blockstudio-fr_FR.po, ir nustatykite Language bei Plural-Forms antraštes. Norėdami patobulinti kalbos vertimą, redaguokite esamą .po failą.
Išverskite eilutes. Vertime palikite vietaženklius, pavyzdžiui, %1$s.
Paleiskite npm run i18n. Jis įrašo .mo, .l10n.php ir .json failus, kuriuos įkelia WordPress.
Pateikite .po failą kartu su sugeneruotais failais ir atidarykite užklausą sujungti pakeitimus.

Jei negalite paleisti npm, pakanka pateikti užklausą sujungti pakeitimus, kurioje būtų tik .po failas. Sugeneruotus failus galima pridėti prieš sujungiant pakeitimus.

Trūkstamų vertimų generavimas

Prižiūrėtojai gali sugeneruoti trūkstamus įrašus naudodami autentifikuotą Codex CLI. Tai pasirenkama kūrimo komanda, kurios WordPress nevykdo:

Shell

npm run i18n:translate -- --dry-run
npm run i18n:translate

Numatytasis modelis yra gpt-6-luna. Norėdami dirbti su viena lokale, naudokite npm run i18n:translate -- --locale fr_FR. Komanda ištraukia naujausias šaltinio eilutes, užpildo trūkstamus vertimus, tada sukompiliuoja .mo, .l10n.php ir kiekvieno scenarijaus .json failus. Codex siunčiamos tik viešosios sąsajos eilutės, jų kontekstas ir esamos formos, o ne svetainės turinys ar naudotojų duomenys.

Esami netušti vertimai niekada neperrašomi. Užbaigtos paketų partijos išsaugomos, todėl po pertrūkio paleidus komandą iš naujo tęsiamas trūkstamas darbas. Prieš įrašant patikrinami vietaženkliai, pavyzdžiui, %1$s, HTML žymėjimas, techniniai identifikatoriai ir privalomos daugiskaitos formos. Neaiškūs įrašai ir pasikeitusios šaltinio daugiskaitos formos paliekamos vertėjui peržiūrėti. Jei prašomas modelis nepasiekiamas, kitas modelis nenaudojamas.

npm run i18n:locales aiškiai atnaujina lokalių sąrašą ir daugiskaitos taisykles iš WordPress/GlotPress. npm run i18n:coverage patikrina, ar visų į įrašytą sąrašą įtrauktų lokalių vertimai yra išsamūs. Nei aprėpties patikros, nei įprastas CI nenaudoja DI ar negauna lokalės duomenų. Paketinio apdorojimo, lygiagretumo ir atkūrimo parinktis rasite saugyklos README.

Verčiamos kodo eilutės

PHP: naudokite funkcijas WordPress su teksto domenu blockstudio, pavyzdžiui, __( 'Invalid block.', 'blockstudio' ).
JavaScript: importuokite __ iš @/utils/__ ir perduokite literalų eilutės tekstą, pavyzdžiui, __( 'Add row' ). Vykdymo metu sudarytos eilutės išversti negalima, todėl kiekvienam variantui naudokite atskirą literalų eilutės tekstą.
Naujam scenarijaus pakete esančiam verčiamam tekstui reikia įrašo faile scripts/i18n.ts ir iškvietimo wp_set_script_translations() su tuo pačiu deskriptoriumi bei Translations::script_path().

Pakeitę eilutes, paleiskite npm run i18n. Ji atnaujina languages/blockstudio.pot ir visus .po failus. Naujos eilutės lieka anglų kalba, kol vertėjas arba npm run i18n:translate jas užpildo. CI vykdo npm run i18n:check ir npm run i18n:coverage, kurios atmeta pasenusius sukompiliuotus failus, ištraukimo problemas arba neužbaigtą lokalės aprėptį. Generavimas lieka aiškiai prižiūrėtojo atliekamu veiksmu.