Tulkojumi

Skatīt kā Markdown

Blockstudio iekļauj savus tulkojumus mapē languages. WordPress tos izmanto, ja vietnes vai lietotāja profila valoda atbilst kādai no šīm valodām. Tas darbojas vienādi neatkarīgi no tā, vai Blockstudio darbojas kā spraudnis, obligāti ielādējams spraudnis vai Composer pakotne.

Pieejamās valodas

Blockstudio ietver tulkojumus WordPress lokālēm, kas norādītas komplektā iekļautajā languages/locales.json, tostarp reģionālajiem un formālā/neformālā stila variantiem. Avota valoda ir angļu (en_US), un tai tulkojuma fails nav vajadzīgs. Sarakstā apvienotas WordPress atbalstītās lokāles no GlotPress un varianti, kas pieejami WordPress kodola tulkojumu API.

Esošie tulkojumi vācu (de_DE) un formālajā vācu valodā (de_DE_formal) ir saglabāti. Pārējos tulkojumus ģenerējis mākslīgais intelekts, izmantojot GPT-6 Luna; to .po galvenēs tie ir atzīmēti kā mašīntulkojumi. Tie iztur automātiskās pilnīguma un formāta pārbaudes, taču ne visus ir pārbaudījuši dzimtās valodas runātāji. Labojumi ir laipni gaidīti.

Tulkojumi aptver bloku redaktora lauku vadīklas, administrēšanas lapu, kanvu, izstrādātāju rīku pārklājumu un REST galapunktu ziņojumus. Pašu block.json failu etiķetes un palīdzības teksti pieder jūsu dizainam vai spraudnim un izmanto tā teksta domēnu.

Izvēlieties valodu sadaļā Iestatījumi > Vispārīgi > Vietnes valoda vai izvēlieties personīgo valodu savā WordPress profilā. Blockstudio šo lokāli izmanto automātiski. Tas nepievieno valodas WordPress valodu atlasītājam: lokālei jābūt pieejamai arī jūsu WordPress instalācijā. Vietnei nav vajadzīgs AI pieprasījums, tulkošanas abonements vai papildu izpildlaika iestatījums.

Tulkojuma aizstāšana

Tulkojumu faili mapē wp-content/languages/plugins ir prioritāri par komplektā iekļautajiem failiem gan PHP virknēm (blockstudio-de_DE.mo vai blockstudio-de_DE.l10n.php), gan skriptiem (pa vienam failam katram skripta rokturim, piemēram, blockstudio-de_DE-blockstudio-blocks.json).

Tulkojuma veidošana

Katras valodas tulkojums ir .po fails, ko var rediģēt ar jebkuru teksta redaktoru vai tulkošanas rīku, piemēram, Poedit. Labojumi un jaunas valodas ir laipni gaidīti kā izmaiņu pieprasījumi.

Lai pievienotu valodu, kopējiet languages/blockstudio.pot uz languages/blockstudio-<locale>.po, piemēram, blockstudio-fr_FR.po, un iestatiet galvenes Language un Plural-Forms. Lai uzlabotu tulkojumu, rediģējiet attiecīgās valodas esošo .po failu.
Iztulkojiet virknes. Saglabājiet tulkojumā vietturus, piemēram, %1$s.
Palaidiet npm run i18n. Tas izveido .mo, .l10n.php un .json failus, ko ielādē WordPress.
Iekļaujiet .po failu kopā ar ģenerētajiem failiem un atveriet izmaiņu pieprasījumu.

Ja nevarat palaist npm, pietiek ar izmaiņu pieprasījumu, kurā iekļauts tikai .po fails. Ģenerētos failus var pievienot pirms apvienošanas.

Trūkstošo tulkojumu ģenerēšana

Uzturētāji var ģenerēt trūkstošos ierakstus, izmantojot autentificētu Codex CLI. Šī ir neobligāta izstrādes komanda, ko WordPress nepalaiž:

Apvalks

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

Noklusējuma modelis ir gpt-6-luna. Lai strādātu ar vienu lokāli, izmantojiet npm run i18n:translate -- --locale fr_FR. Komanda izgūst jaunākās avota virknes, aizpilda trūkstošos tulkojumus un pēc tam kompilē .mo, .l10n.php un katram skriptam paredzētos .json failus. Uz Codex tiek nosūtītas tikai publiskās saskarnes virknes, to konteksts un esošie varianti, nevis vietnes saturs vai lietotāju dati.

Esošie tulkojumi, kas nav tukši, nekad netiek aizstāti. Pabeigtās paketes tiek saglabātas, tāpēc pēc pārtraukuma komandu var palaist atkārtoti, lai turpinātu trūkstošo darbu. Pirms saglabāšanas tiek pārbaudīti vietturi, piemēram, %1$s, HTML marķējums, tehniskie identifikatori un obligātās daudzskaitļa formas. Neskaidrie ieraksti un mainītās avota teksta daudzskaitļa formas tiek atstātas tulkotāja pārbaudei. Ja pieprasītais modelis nav pieejams, cits modelis netiek izmantots kā aizstājējs.

npm run i18n:locales nepārprotami atjauno lokāļu sarakstu un daudzskaitļa veidošanas noteikumus no WordPress/GlotPress. npm run i18n:coverage pārbauda, vai visas lokāles reģistrētajā sarakstā ir pilnīgas. Ne pilnīguma pārbaudes, ne parastā CI neizmanto AI un neiegūst lokāļu datus. Paketizēšanas, vienlaicīgas izpildes un atkopšanas iespējas skatiet repozitorija README.

Tulkojamās virknes kodā

PHP: izmantojiet blockstudio teksta domēna funkcijas WordPress, piemēram, __( 'Invalid block.', 'blockstudio' ).
JavaScript: importējiet __ no @/utils/__ un nododiet burtisku virkni, piemēram, __( 'Add row' ). Virkni, kas tiek veidota izpildlaikā, nevar tulkot, tāpēc katram variantam izmantojiet atsevišķu burtisku virkni.
Jaunam skripta komplektam ar tulkojamām virknēm nepieciešams ieraksts failā scripts/i18n.ts un izsaukums wp_set_script_translations() ar to pašu apstrādātāju un Translations::script_path().

Pēc virkņu maiņas palaidiet npm run i18n. Tas atjaunina languages/blockstudio.pot un visus .po failus. Jaunās virknes paliek angļu valodā, līdz tulkotājs vai npm run i18n:translate tās aizpilda. CI palaiž npm run i18n:check un npm run i18n:coverage, kas noraida novecojušus kompilētos failus, izvilkšanas problēmas vai nepilnīgu lokalizāciju pārklājumu. Ģenerēšana joprojām ir skaidri veicama uzturētāja darbība.