Fordítások

Megtekintés Markdownként

A Blockstudio a fordításait a languages mappában tárolja. A WordPress ezeket használja, ha a webhely nyelve vagy a felhasználói profil nyelve megegyezik valamelyikükkel. Ez ugyanúgy működik akkor is, ha a Blockstudio bővítményként, kötelezően betöltendő bővítményként vagy Composer csomagként fut.

Elérhető nyelvek

A Blockstudio tartalmaz fordításokat a mellékelt languages/locales.json fájlban rögzített WordPress területi beállításokhoz, beleértve a regionális, valamint a formális és informális változatokat. Az angol (en_US) a forrásnyelv, ezért nincs szükség hozzá fordítási fájlra. A lista egyesíti a GlotPress által támogatott WordPress területi beállításokat az WordPress magfordítási API változataival.

A meglévő német (de_DE) és formális német (de_DE_formal) fordítások megmaradnak. A további fordításokat a GPT-6 Luna generálta, és a .po fejléceik gépi fordításként jelölik őket. Sikeresen átmennek az automatizált teljességi és formátumellenőrzéseken, de nem mindegyiket ellenőrizték anyanyelvi beszélők. A javításokat szívesen fogadjuk.

A fordítások a blokkszerkesztő mezővezérlőire, az adminisztrációs oldalra, a vászonra, a fejlesztői eszközök átfedő felületére és a REST végpontok üzeneteire terjednek ki. A saját block.json fájljaidban szereplő címkék és súgószövegek a témádhoz vagy bővítményedhez tartoznak, és annak szövegtartományát használják.

Válaszd ki a nyelvet a Beállítások > Általános > A webhely nyelve részen, vagy állíts be személyes nyelvet a WordPress profilodban. A Blockstudio automatikusan ezt a területi beállítást használja. Nem ad hozzá nyelveket a WordPress nyelvválasztójához: egy területi beállításnak a WordPress telepítésedben is elérhetőnek kell lennie. A webhelyeden nincs szükség AI-kérésre, fordítási előfizetésre vagy további futásidejű beállításra.

Fordítás felülbírálása

A wp-content/languages/plugins mappában található fordítási fájlok elsőbbséget élveznek a mellékelt fájlokkal szemben, mind a PHP karakterláncok (blockstudio-de_DE.mo vagy blockstudio-de_DE.l10n.php), mind a szkriptek esetében (minden szkriptkezelőhöz egy fájl, például blockstudio-de_DE-blockstudio-blocks.json).

Fordítás beküldése

Minden nyelv egy .po fájlból áll, amelyet bármely szövegszerkesztővel vagy fordítóeszközzel, például a Poedittel szerkeszthetsz. A javításokat és az új nyelveket pull requestként szívesen fogadjuk.

Nyelv hozzáadásához másold a languages/blockstudio.pot fájlt ide: languages/blockstudio-<locale>.po, például blockstudio-fr_FR.po néven, majd állítsd be a Language és Plural-Forms fejléceket. Egy nyelv javításához szerkeszd a meglévő .po fájlt.
Fordítsd le a karakterláncokat. A fordításban hagyd meg az olyan helyőrzőket, mint a %1$s.
Futtasd a npm run i18n parancsot. Ez létrehozza az .mo, .l10n.php és .json fájlokat, amelyeket a WordPress betölt.
Véglegesítsd a .po fájlt a generált fájlokkal együtt, majd nyiss egy pull requestet.

Ha nem tudod futtatni a npm parancsot, a kizárólag a .po fájlt tartalmazó pull request is megfelelő. A generált fájlok az összevonás előtt hozzáadhatók.

Hiányzó fordítások generálása

A karbantartók hitelesített Codex CLI használatával generálhatják a hiányzó bejegyzéseket. Ez egy opcionális fejlesztői parancs, amelyet a WordPress nem futtat:

Shell

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

Az alapértelmezett modell: gpt-6-luna. Egyetlen területi beállítás fordításához használd ezt: npm run i18n:translate -- --locale fr_FR. A parancs kinyeri a legfrissebb forráskarakterláncokat, pótolja a hiányzó fordításokat, majd lefordítja az .mo, .l10n.php és szkriptenkénti .json fájlokat. Az Codex részére csak nyilvános felületi karakterláncok, azok kontextusa és a meglévő alakok kerülnek elküldésre, webhelytartalom vagy felhasználói adat nem.

A meglévő, nem üres fordításokat a rendszer soha nem cseréli le. Az elkészült kötegeket elmenti, így megszakítás után újrafuttatva a hiányzó munkát folytatja. Mentés előtt ellenőrzi az olyan helyőrzőket, mint a %1$s, a HTML jelöléseket, a műszaki azonosítókat és a kötelező többes számú alakokat. Az ellenőrzést igénylő bejegyzések és a megváltozott forrásoldali többes számú alakok fordítói felülvizsgálatra várnak. Ha a kért modell nem érhető el, a rendszer nem vált át másik modellre.

A npm run i18n:locales kifejezetten frissíti a területi beállítások listáját és a többes számú szabályokat a WordPress/GlotPress forrásból. A npm run i18n:coverage ellenőrzi, hogy a verziókezelésben rögzített lista minden területi beállítása teljes-e. Sem a lefedettség ellenőrzése, sem a szokásos CI nem hív AI-t, és nem tölt le területi beállításokra vonatkozó adatokat. A kötegelt feldolgozásról, a párhuzamosságról és a helyreállítási lehetőségekről a tároló README fájljában olvashatsz.

Fordítható karakterláncok a kódban

PHP: használja a blockstudio szövegtartományhoz tartozó WordPress függvényeket, például: __( 'Invalid block.', 'blockstudio' ).
JavaScript: importálja a __ elemet innen: @/utils/__, és adjon át egy literális karakterláncot, például: __( 'Add row' ). A futásidőben összeállított karakterlánc nem fordítható le, ezért minden változathoz egyetlen literális karakterláncot használjon.
A fordítható karakterláncokat tartalmazó új scriptcsomaghoz bejegyzés szükséges a scripts/i18n.ts fájlban, valamint egy wp_set_script_translations() hívás ugyanazzal a handle-lel és a Translations::script_path() értékkel.

A karakterláncok módosítása után futtassa a npm run i18n parancsot. Ez frissíti a languages/blockstudio.pot fájlt és az összes .po fájlt. Az új karakterláncok angolul maradnak, amíg egy fordító vagy a npm run i18n:translate ki nem tölti őket. A CI futtatja a npm run i18n:check és a npm run i18n:coverage ellenőrzést, amelyek elutasítják az elavult lefordított fájlokat, a kinyerési problémákat vagy a hiányos nyelvi lefedettséget. A generálás továbbra is a karbantartó kifejezett művelete marad.