Käännökset

Näytä Markdown-muodossa

Blockstudio sisältää käännöksensä kansiossa languages. WordPress käyttää niitä, kun sivuston tai käyttäjäprofiilin kieli vastaa jotakin niistä. Tämä toimii samalla tavalla, kun Blockstudio toimii lisäosana, pakollisena lisäosana tai Composer-pakettina.

Saatavilla olevat kielet

Blockstudio sisältää käännökset sen WordPress kielen alueversioille, jotka on kirjattu sen mukana toimitettavaan languages/locales.json-tiedostoon, mukaan lukien alueelliset sekä muodolliset ja epämuodolliset variantit. Englanti (en_US) on lähdekieli eikä tarvitse käännöstiedostoa. Luettelossa yhdistyvät WordPressn tukemat GlotPress-kielet ja WordPressn ytimen käännös-APIssa saatavilla olevat variantit.

Olemassa olevat saksan (de_DE) ja muodollisen saksan (de_DE_formal) käännökset säilytetään. Lisäkäännökset on luotu tekoälyllä GPT-6 Lunaa käyttäen, ja ne on merkitty koneellisesti tuotetuiksi .po-otsakkeissaan. Ne läpäisevät automaattiset kattavuus- ja muototarkistukset, mutta äidinkieliset puhujat eivät ole tarkistaneet niitä kaikkia. Korjaukset ovat tervetulleita.

Käännökset kattavat lohkomuokkaimen kenttäohjaimet, ylläpitosivun, kanvaasin, kehittäjätyökalujen peittokuvan ja REST-päätepisteiden viestit. Omissa block.json-tiedostoissasi olevat nimet ja ohjetekstit kuuluvat teemaan tai lisäosaan, ja niissä käytetään sen tekstialuetta.

Valitse kieli kohdasta Asetukset > Yleiset > Sivuston kieli tai valitse henkilökohtainen kieli WordPress-profiilissasi. Blockstudio käyttää kyseistä kielialuetta automaattisesti. Se ei lisää kieliä WordPressn kielivalitsimeen: kielialueen on oltava saatavilla myös WordPress-asennuksessasi. Sivustollasi ei tarvita tekoälypyyntöä, käännöstilausta tai ylimääräistä ajonaikaista asetusta.

Käännöksen korvaaminen

Kohteen wp-content/languages/plugins käännöstiedostoilla on etusija mukana toimitettuihin tiedostoihin nähden sekä PHP-merkkijonojen (blockstudio-de_DE.mo tai blockstudio-de_DE.l10n.php) että skriptien osalta (yksi tiedosto käsittelijää kohden, esimerkiksi blockstudio-de_DE-blockstudio-blocks.json).

Käännöksen tekeminen

Jokainen kieli on .po-tiedosto, jota voit muokata millä tahansa tekstieditorilla tai käännöstyökalulla, kuten Poeditilla. Korjaukset ja uudet kielet ovat tervetulleita pull-pyyntöinä.

Lisää kieli kopioimalla languages/blockstudio.pot kohteeseen languages/blockstudio-<locale>.po, esimerkiksi blockstudio-fr_FR.po, ja asettamalla Language– ja Plural-Forms-otsakkeet. Paranna kieltä muokkaamalla sen olemassa olevaa .po-tiedostoa.
Käännä merkkijonot. Säilytä käännöksessä paikkamerkit, kuten %1$s.
Suorita npm run i18n. Se kirjoittaa tiedostot .mo, .l10n.php ja .json, jotka WordPress lataa.
Tallenna .po-tiedosto yhdessä luotujen tiedostojen kanssa ja avaa pull-pyyntö.

Jos et voi suorittaa komentoa npm, pull-pyyntö, joka sisältää vain tiedoston .po, käy hyvin. Luodut tiedostot voidaan lisätä ennen yhdistämistä.

Puuttuvien käännösten luominen

Ylläpitäjät voivat luoda puuttuvat merkinnät tunnistetulla Codex CLI-komennolla. Tämä on valinnainen kehityskomento, jota WordPress ei suorita:

Shell

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

Oletusmalli on gpt-6-luna. Voit käsitellä yhtä kielialuetta komennolla npm run i18n:translate -- --locale fr_FR. Komento poimii uusimmat lähdemerkkijonot, täyttää puuttuvat käännökset ja kääntää sitten tiedostot .mo, .l10n.php ja skriptikohtaiset .json. Codexlle lähetetään vain julkiset käyttöliittymämerkkijonot, niiden konteksti ja olemassa olevat muodot, ei sivuston sisältöä tai käyttäjätietoja.

Olemassa olevia, ei-tyhjiä käännöksiä ei koskaan korvata. Valmiit erät tallennetaan, joten keskeytyksen jälkeen komennon uudelleen suorittaminen jatkaa puuttuvista käännöksistä. Paikkamerkit, kuten %1$s, HTML-merkkaus, tekniset tunnisteet ja vaaditut monikkomuodot tarkistetaan ennen tallennusta. Epävarmat merkinnät ja muuttuneet lähteen monikkomuodot jätetään kääntäjän tarkistettaviksi. Mallia ei vaihdeta, jos pyydetty malli ei ole saatavilla.

npm run i18n:locales päivittää kieliluettelon ja monikkosäännöt erikseen lähteestä WordPress/GlotPress. npm run i18n:coverage tarkistaa, että jokainen versionhallintaan tallennetun luettelon kielialue on täydellinen. Kattavuustarkistukset ja tavallinen CI eivät kutsu tekoälyä eivätkä hae kielialuetietoja. Katso repositorion README eräajon, samanaikaisuuden ja palautumisen vaihtoehdot.

Käännettävät merkkijonot koodissa

PHP: käytä blockstudio-tekstialueen WordPress-funktioita, esimerkiksi __( 'Invalid block.', 'blockstudio' ).
JavaScript: tuo __ moduulista @/utils/__ ja välitä sille merkkijonoliteraali, esimerkiksi __( 'Add row' ). Ajonaikaisesti koottua merkkijonoa ei voi kääntää, joten käytä yhtä merkkijonoliteraalia kutakin varianttia kohden.
Uusi skriptipaketti, joka sisältää käännettäviä merkkijonoja, tarvitsee merkinnän tiedostoon scripts/i18n.ts ja kutsun funktiolle wp_set_script_translations() käyttäen samaa tunnistetta ja arvoa Translations::script_path().

Kun olet muuttanut merkkijonoja, suorita npm run i18n. Se päivittää tiedoston languages/blockstudio.pot ja kaikki tiedostot .po. Uudet merkkijonot säilyvät englanniksi, kunnes kääntäjä tai npm run i18n:translate täyttää niiden käännökset. CI suorittaa npm run i18n:check ja npm run i18n:coverage, jotka hylkäävät vanhentuneet käännetyt tiedostot, poimintaongelmat tai puutteellisen kielialueiden kattavuuden. Generointi pysyy ylläpitäjän erikseen käynnistämänä toimena.