Preklady

Zobraziť ako Markdown

Blockstudio dodáva svoje preklady v priečinku languages. WordPress ich používa, keď sa jazyk webu alebo jazyk v používateľskom profile zhoduje s niektorým z nich. Funguje to rovnako, keď Blockstudio beží ako doplnok, povinný doplnok alebo balík Composer.

Dostupné jazyky

Blockstudio obsahuje preklady pre WordPress lokál zaznamenaných v pribalenom languages/locales.json vrátane regionálnych a formálnych/neformálnych variantov. Angličtina (en_US) je zdrojový jazyk a nepotrebuje prekladový súbor. Zoznam spája lokály podporované WordPress z GlotPressu s variantmi dostupnými v prekladovom API jadra WordPress.

Existujúce preklady do nemčiny (de_DE) a formálnej nemčiny (de_DE_formal) zostávajú zachované. Ďalšie preklady vytvoril model GPT-6 Luna a v hlavičkách .po sú označené ako strojovo generované. Prešli automatizovanými kontrolami úplnosti a formátu, no nie všetky skontrolovali rodení hovoriaci. Opravy sú vítané.

Preklady pokrývajú ovládacie prvky polí v editore blokov, stránku administrácie, plátno, prekryvnú vrstvu vývojárskych nástrojov a správy koncových bodov REST. Popisy a pomocné texty vo vlastných súboroch block.json patria k vašej téme alebo doplnku a používajú jeho textovú doménu.

Jazyk vyberte v Nastavenia > Všeobecné > Jazyk webu alebo si zvoľte osobný jazyk vo svojom profile WordPress. Blockstudio toto miestne nastavenie používa automaticky. Nepridáva jazyky do výberu jazykov WordPress: dané miestne nastavenie musí byť dostupné aj vo vašej inštalácii WordPress. Na vašom webe nie je potrebná požiadavka na AI, predplatné prekladov ani ďalšie nastavenie behu.

Prepísanie prekladu

Prekladové súbory v wp-content/languages/plugins majú prednosť pred pribalenými súbormi, a to pre reťazce PHP (blockstudio-de_DE.mo alebo blockstudio-de_DE.l10n.php), ako aj pre skripty (jeden súbor pre každý identifikátor skriptu, napríklad blockstudio-de_DE-blockstudio-blocks.json).

Prispievanie do prekladov

Každý jazyk je súbor .po, ktorý môžete upravovať v ľubovoľnom textovom editore alebo prekladateľskom nástroji, napríklad Poedit. Opravy a nové jazyky sú vítané formou požiadaviek na začlenenie zmien.

Ak chcete pridať jazyk, skopírujte languages/blockstudio.pot do languages/blockstudio-<locale>.po, napríklad blockstudio-fr_FR.po, a nastavte hlavičky Language a Plural-Forms. Ak chcete vylepšiť jazyk, upravte jeho existujúci súbor .po.
Preložte reťazce. V preklade zachovajte zástupné symboly, napríklad %1$s.
Spustite npm run i18n. Vytvorí súbory .mo, .l10n.php a .json, ktoré načítava WordPress.
Súbor .po odovzdajte spolu s vygenerovanými súbormi a otvorte požiadavku na začlenenie zmien.

Ak nemôžete spustiť npm, postačí požiadavka na začlenenie zmien obsahujúca iba súbor .po. Vygenerované súbory možno pridať pred zlúčením zmien.

Generovanie chýbajúcich prekladov

Správcovia môžu vygenerovať chýbajúce položky pomocou overeného Codex CLI. Ide o voliteľný vývojársky príkaz, ktorý WordPress nespúšťa:

Shell

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

Predvolený model je gpt-6-luna. Ak chcete pracovať s jedným miestnym nastavením, použite npm run i18n:translate -- --locale fr_FR. Príkaz extrahuje najnovšie zdrojové reťazce, doplní chýbajúce preklady a potom skompiluje súbory .mo, .l10n.php a .json pre každý skript. Do Codex sa odosielajú iba reťazce verejného rozhrania, ich kontext a existujúce tvary, nie obsah webu ani údaje používateľov.

Existujúce neprázdne preklady sa nikdy neprepisujú. Dokončené dávky sa ukladajú, takže opätovným spustením po prerušení sa pokračuje v chýbajúcej práci. Pred uložením sa overujú zástupné symboly, napríklad %1$s, značky HTML, technické identifikátory a požadované tvary množného čísla. Nejasné položky a zmenené množné čísla zdroja sa ponechávajú na kontrolu prekladateľovi. Ak požadovaný model nie je dostupný, nepoužije sa náhradný model.

npm run i18n:locales výslovne obnoví zoznam lokál a pravidlá množného čísla z WordPress/GlotPressu. npm run i18n:coverage overí, či sú úplné všetky lokály v zozname uloženom v repozitári. Kontroly pokrytia ani bežná integrácia priebežne nespúšťajú AI a nenačítavajú údaje o lokáloch. Možnosti dávkovania, súbežnosti a obnovy nájdete v README repozitára.

Reťazce v kóde určené na preklad

PHP: použite funkcie WordPress s textovou doménou blockstudio, napríklad __( 'Invalid block.', 'blockstudio' ).
JavaScript: importujte __ z @/utils/__ a odovzdajte doslovný reťazec, napríklad __( 'Add row' ). Reťazec zostavený počas behu sa nedá preložiť, preto pre každý variant použite jeden doslovný reťazec.
Nový balík skriptov s preložiteľnými reťazcami potrebuje záznam v scripts/i18n.ts a volanie wp_set_script_translations() s rovnakým identifikátorom a Translations::script_path().

Po zmene reťazcov spustite npm run i18n. Aktualizuje languages/blockstudio.pot a každý súbor .po. Nové reťazce zostanú v angličtine, kým ich nevyplní prekladateľ alebo npm run i18n:translate. CI spúšťa npm run i18n:check a npm run i18n:coverage, ktoré odmietnu zastarané skompilované súbory, problémy pri extrakcii alebo neúplné pokrytie jazykovými verziami. Generovanie zostáva výslovným úkonom správcu.