Liigu sisu juurde

Tõlked

Vaata Markdownina

Blockstudio sisaldab tõlkeid kaustas languages. WordPress kasutab neid alati, kui saidi keel või kasutajaprofiilis määratud keel vastab mõnele neist. See toimib samamoodi, kui Blockstudio käitatakse plugina, kohustusliku plugina või paketina Composer.

Saadaolevad keeled

Blockstudio sisaldab tõlkeid WordPress lokaadi jaoks, mis on kirjas kaasasolevas languages/locales.json, sealhulgas piirkondlikud ning ametlikud ja mitteametlikud variandid. Inglise keel (en_US) on lähtkeel ega vaja tõlkefaili. Loend ühendab WordPress toetatud lokaadid GlotPressist ja variandid, mis on saadaval WordPress tuuma tõlkeAPIs.

Olemasolevad saksa keele (de_DE) ja ametliku saksa keele (de_DE_formal) tõlked säilivad. Täiendavad tõlked on loodud tehisintellekti abil mudeliga GPT-6 Luna ning nende .po päistes on märgitud, et need on masintõlked. Need läbivad automaatsed täielikkuse ja vormingu kontrollid, kuid kõiki pole veel emakeelsed kõnelejad üle vaadanud. Parandused on teretulnud.

Tõlked hõlmavad plokiredaktori väljade juhtelemente, halduslehte, lõuendit, arendustööriistade ülekatet ning REST lõpp-punktide sõnumeid. Teie enda block.json failide sildid ja abitekstid kuuluvad teie teema või plugina juurde ning kasutavad selle tekstidomeeni.

Valige keel jaotises Settings > General > Site Language või määrake oma profiilis WordPress isiklik keel. Blockstudio kasutab seda lokaati automaatselt. See ei lisa keeli WordPress keelevalijasse: lokaat peab olema saadaval ka teie WordPress paigalduses. Teie saidil pole vaja tehisintellektile päringuid saata, tõlketellimust võtta ega täiendavaid käitusajasätteid määrata.

Tõlke asendamine

Kaustas wp-content/languages/plugins olevad tõlkefailid on kaasasolevatest failidest ülimuslikud nii PHP stringide (blockstudio-de_DE.mo või blockstudio-de_DE.l10n.php) kui ka skriptide puhul (üks fail iga skriptikäitleja kohta, näiteks blockstudio-de_DE-blockstudio-blocks.json).

Tõlkimisse panustamine

Iga keel on .po fail, mida saate muuta mis tahes tekstiredaktoris või tõlketööriistaga, näiteks Poeditiga. Parandused ja uued keeled on teretulnud pull request’idena.

  1. Keele lisamiseks kopeerige languages/blockstudio.pot faili languages/blockstudio-<locale>.po, näiteks blockstudio-fr_FR.po, ning määrake päised Language ja Plural-Forms. Keele parandamiseks muutke selle olemasolevat .po faili.
  2. Tõlkige stringid. Säilitage tõlkes kohatäited, näiteks %1$s.
  3. Käivitage npm run i18n. See kirjutab failid .mo, .l10n.php ja .json, mida WordPress laeb.
  4. Lisage .po fail koos genereeritud failidega commit’i ja avage pull request.

Kui te ei saa käivitada npm, sobib ka pull request, mis sisaldab ainult faili .po. Genereeritud failid saab lisada enne liitmist.

Puuduvate tõlgete genereerimine

Haldajad saavad puuduvaid kirjeid genereerida autentitud Codex CLI abil. See on valikuline arenduskäsk, mida WordPress ei käivita:

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

Vaikemudel on gpt-6-luna. Ühe lokaadiga töötamiseks kasutage käsku npm run i18n:translate -- --locale fr_FR. Käsk eraldab uusimad lähtestringid, täidab puuduvad tõlked ja kompileerib seejärel failid .mo, .l10n.php ning iga skripti jaoks eraldi .json failid. Codex-le saadetakse ainult avalikud kasutajaliidese stringid, nende kontekst ja olemasolevad vormid, mitte saidi sisu ega kasutajaandmed.

Olemasolevaid mittetühje tõlkeid ei asendata kunagi. Valmis partiid salvestatakse, seega jätkab katkestuse järel uuesti käivitamine puuduvast tööst. Enne salvestamist kontrollitakse kohatäiteid, näiteks %1$s, HTML-märgendust, tehnilisi tunnuseid ja nõutavaid mitmusevorme. Ebaselged kirjed ja muudetud lähteteksti mitmusvormid jäetakse tõlkija ülevaatamiseks. Kui soovitud mudel pole saadaval, ei kasutata varumudelit.

npm run i18n:locales värskendab sõnaselgelt lokaadiloendit ja mitmuse reegleid allikast WordPress/GlotPress. npm run i18n:coverage kontrollib, kas kõik sisse kantud loendi lokaadid on täielikud. Ei katvuse kontrollid ega tavapärane CI kasuta tehisintellekti ega hangi lokaadiandmeid. Partiide, samaaegsuse ja taastamise võimaluste kohta vaadake hoidla README.

Koodis tõlgitavad stringid

  • PHP: kasutage blockstudio tekstidomeeniga funktsioone WordPress, näiteks __( 'Invalid block.', 'blockstudio' ).
  • JavaScript: importige __ asukohast @/utils/__ ja edastage sellele literaalsõne, näiteks __( 'Add row' ). Käitusajal koostatavat sõnet ei saa tõlkida, seega kasutage iga variandi jaoks üht literaalsõnet.
  • Tõlgitavaid sõnesid sisaldava uue skriptikomplekti jaoks tuleb lisada kirje faili scripts/i18n.ts ja kutsuda funktsiooni wp_set_script_translations() sama pideme ja Translations::script_path()-ga.

Pärast sõnede muutmist käivitage npm run i18n. See uuendab languages/blockstudio.pot ja kõik .po-failid. Uued sõned jäävad ingliskeelseks, kuni tõlkija või npm run i18n:translate need tõlgib. CI käivitab npm run i18n:check ja npm run i18n:coverage, mis lükkavad tagasi aegunud kompileeritud failid, ekstraktimisprobleemid või puuduliku lokaatide katvuse. Genereerimine jääb haldaja selgesõnaliseks toiminguks.