Preskoči na vsebino

Prevodi

Prikaži kot Markdown

Blockstudio vključuje prevode v mapi languages. WordPress jih uporabi, kadar se jezik spletnega mesta ali jezik v uporabniškem profilu ujema z enim od njih. Enako velja, kadar Blockstudio deluje kot vtičnik, obvezni vtičnik ali paket Composer.

Razpoložljivi jeziki

Blockstudio vključuje prevode za WordPress jezikovnih različic, zabeleženih v priloženem languages/locales.json, vključno z regionalnimi ter formalnimi in neformalnimi različicami. Angleščina (en_US) je izvorni jezik, zato zanjo prevodna datoteka ni potrebna. Seznam združuje jezikovne različice, ki jih podpira WordPress v GlotPressu, in različice, ki so na voljo v osrednjem prevodnem WordPress za API.

Obstoječa nemška (de_DE) in formalna nemška (de_DE_formal) prevoda sta ohranjena. Dodatni prevodi so ustvarjeni z umetno inteligenco GPT-6 Luna in v svojih glavah .po označeni kot strojno ustvarjeni. Prestali so samodejno preverjanje popolnosti in oblike, vendar jih naravni govorci niso pregledali vseh. Popravki so dobrodošli.

Prevodi zajemajo kontrolnike polj v urejevalniku blokov, skrbniško stran, platno, prekrivni vmesnik za razvojna orodja in sporočila končnih točk REST. Oznake in besedila pomoči v vaših datotekah block.json pripadajo vaši temi ali vtičniku in uporabljajo njuno besedilno domeno.

Jezik izberite v Settings > General > Site Language ali pa v svojem profilu WordPress izberite osebni jezik. Blockstudio samodejno uporabi to jezikovno različico. Jezikov ne doda v izbirnik jezikov WordPress: jezikovna različica mora biti na voljo tudi v vaši namestitvi WordPress. Na vašem spletnem mestu niso potrebni zahteva za umetno inteligenco, naročnina na prevajanje ali dodatna nastavitev izvajalnega okolja.

Prepis prevoda

Prevajalne datoteke v wp-content/languages/plugins imajo prednost pred priloženimi datotekami, tako za nize PHP (blockstudio-de_DE.mo ali blockstudio-de_DE.l10n.php) kot za skripte (ena datoteka za vsako ročico skripta, na primer blockstudio-de_DE-blockstudio-blocks.json).

Prispevajte prevod

Vsak jezik je datoteka .po, ki jo lahko urejate s katerim koli urejevalnikom besedila ali prevajalskim orodjem, kot je Poedit. Dobrodošli so popravki in prevodi v nove jezike, poslani kot predlogi za združitev.

  1. Če želite dodati jezik, kopirajte languages/blockstudio.pot v languages/blockstudio-<locale>.po, na primer blockstudio-fr_FR.po, in nastavite glavi Language in Plural-Forms. Če želite izboljšati jezik, uredite njegovo obstoječo datoteko .po.
  2. Prevedite nize. V prevodu ohranite nadomestne oznake, kot je %1$s.
  3. Zaženite npm run i18n. Ustvari datoteke .mo, .l10n.php in .json, ki jih naloži WordPress.
  4. Datoteko .po skupaj z ustvarjenimi datotekami vključite v objavo sprememb in odprite predlog za združitev.

Če ne morete zagnati npm, zadošča predlog za združitev, ki vsebuje samo datoteko .po. Ustvarjene datoteke lahko dodate pred združitvijo.

Ustvarjanje manjkajočih prevodov

Vzdrževalci lahko ustvarijo manjkajoče vnose z overjenim Codex CLI. To je izbirni razvojni ukaz, ki ga WordPress ne izvaja:

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

Privzeti model je gpt-6-luna. Če želite delati na posamezni jezikovni različici, uporabite npm run i18n:translate -- --locale fr_FR. Ukaz pridobi najnovejše izvorne nize, dopolni manjkajoče prevode in nato prevede datoteke .mo, .l10n.php ter datoteke .json za posamezne skripte. V Codex se pošljejo samo nizi javnega vmesnika, njihov kontekst in obstoječe oblike, ne pa vsebina spletnega mesta ali uporabniški podatki.

Obstoječi neprazni prevodi se nikoli ne prepišejo. Dokončane skupine se shranijo, zato se ob ponovnem zagonu po prekinitvi nadaljuje manjkajoče delo. Pred shranjevanjem se preverijo nadomestne oznake, kot sta %1$s, oznake HTML, tehnični identifikatorji in zahtevane množinske oblike. Nejasni vnosi in spremenjene množinske oblike izvornega besedila so prepuščeni pregledu prevajalca. Če zahtevani model ni na voljo, se ne uporabi nadomestnega modela.

npm run i18n:locales izrecno osveži seznam jezikovnih različic in pravila za množino iz WordPress/GlotPressa. npm run i18n:coverage preveri, ali so vse jezikovne različice na seznamu v repozitoriju popolne. Preverjanje pokritosti in običajni CI ne kličeta umetne inteligence in ne pridobivata jezikovnih podatkov. Možnosti paketne obdelave, sočasnega izvajanja in obnovitve so opisane v README repozitorija.

Nizi, ki jih je mogoče prevesti v kodi

  • PHP: uporabite funkcije WordPress z besedilno domeno blockstudio, na primer __( 'Invalid block.', 'blockstudio' ).
  • JavaScript: uvozite __ iz @/utils/__ in podajte dobesedni niz, na primer __( 'Add row' ). Niza, sestavljenega med izvajanjem, ni mogoče prevesti, zato za vsako različico uporabite en dobesedni niz.
  • Nov sveženj skript z nizi, ki jih je mogoče prevesti, potrebuje vnos v scripts/i18n.ts in klic wp_set_script_translations() z istim ročajem in Translations::script_path().

Po spremembi nizov zaženite npm run i18n. Posodobi languages/blockstudio.pot in vsako datoteko .po. Novi nizi ostanejo v angleščini, dokler jih ne izpolni prevajalec ali npm run i18n:translate. CI zažene npm run i18n:check in npm run i18n:coverage, ki zavrneta zastarele prevedene datoteke, težave pri ekstrakciji ali nepopolno pokritost jezikovnih različic. Generiranje ostaja izrecno opravilo vzdrževalca.