Szöveg és fordítások¶

Az MRBS különválasztja az alkalmazás szókincsét, a webhely-specifikus megfogalmazásokat, a súgóoldalakat és ezt az MkDocs kézikönyvet. Válassza ki a megfelelő réteget, hogy a frissítések kezelhetők maradjanak.

Feladat	Helyes hely
Nevezze át egy címkét egy telepítéshez	`$vocab_override` in `config.inc.php`
Adjon hozzá vagy javítson egy MRBS felhasználói felületi nyelvet	`web/lang/lang.<language>`
Fordítsa le vagy szabja testre az alkalmazáson belüli súgóoldalt	`web/site_faq/site_faq_<language>.html`
Fordítsa le ezt a kézikönyvet	Egy nyelvi utótagú fájl a `docs/` alatt

Egy webhely megfogalmazásának felülbírálása¶

Ne szerkessze a mellékelt nyelvi fájlt pusztán a „Szoba” felirat vagy a webhely címének módosításához. Keresse meg a kulcsot a web/lang/lang.en fájlban, majd írja felül az értékét:

$vocab_override['en']['mrbs'] = 'Resource Booking';
$vocab_override['de']['mrbs'] = 'Ressourcenbuchung';
$vocab_override['fr']['mrbs'] = 'Réservation de ressources';
$vocab_override['es']['mrbs'] = 'Reserva de recursos';

Az indexek sorrendje mindig a nyelv, majd a szövegkulcs: $vocab_override[LANG][TOKEN].

A hasznos webhely által meghatározott tokenek a következők:

$vocab_override['en']['room.coffee_machine'] = 'Coffee machine';
$vocab_override['en']['entry.catering'] = 'Catering';
$vocab_override['en']['entry.description.placeholder'] =
    'Add information for the room team';
$vocab_override['en']['users.zip_code.oninvalid'] =
    'Enter a valid ZIP code';
$vocab_override['en']['type.C'] = 'Customer booking';

Az egyéni mezők tokenjeit a Egyéni mezők ismerteti. A foglalási típusú leírások a type.X kódot használják, ahol a X a konfigurált típuskód.

A felülbírálások túlélik a frissítést, mert a webhelykonfigurációban élnek. Ellenőrizze újra a jelentésüket, ha egy kiadás megváltoztatja az eredeti tokent vagy annak kontextusát.

Őrizze meg a formázási helyőrzőket¶

A nyelvi karakterláncok tartalmazhatnak printf jelölőket, például %s, %d, vagy pozícióformákat, például %1$d. Őrizzen meg minden markert és típusát. A fordítás csak a pozíciós formával rendezheti át az argumentumokat.

Őrizze meg a szándékos HTML-részleteket, az írásjelek jelentését és a környező szóközöket is. A mennyiséget tartalmazó szövegeket szükség esetén nulla, egy és több értékkel is tesztelje.

Válassza ki a felület nyelvét¶

Alapértelmezés szerint az MRBS kiválaszt egy nyelvet a böngészőből:

$disable_automatic_language_changing = false;

Egy nyelv kényszerítése:

$disable_automatic_language_changing = true;
$default_language_tokens = 'de';

A tokennek meg kell egyeznie egy elérhető web/lang/lang.* fájllal. A dátumok és időpontok nyelvi beállításai külön felülbírálhatók:

$override_locale = 'de-DE';
$cli_language = 'de';

A $override_locale-t a szerver operációs rendszerének is támogatnia kell. $cli_language a böngészőn kívül futó parancsokat vezérli. A diagnózis érdekében a $language_debug = true nyelvi és területi információkat ír a hibanaplóba; a hibaelhárítás után kapcsolja ki újra.

Alkalmazásnyelv hozzáadása vagy karbantartása¶

Az angol fájl a referencia és a tartalék. Olyan nyelv létrehozása, amelynek észlelt tokenje xx:

cp web/lang/lang.en web/lang/lang.xx

Aztán:

Tartsa meg a PHP nyitósort és minden $vocab gombot.
A karakterlánc-értékeket fordítsa le, ne a tokenneveket.
Mentse el a fájlt UTF-8 formátumban.
Ne használjon HTML entitásokat, kivéve a  ; írjon közvetlenül UTF-8 karaktereket.
Őrizze meg a helyettesítési markereket és a szándékos jelölést.
Érvényesítse a PHP szintaxist.

php -l web/lang/lang.xx

Az MRBS először az angol hivatkozást, majd a kiválasztott nyelvet tölti be, így a hiányzó tokenek visszakerülnek angolra.

Ellenőrizze a teljességet¶

checklang.php összehasonlítja a nyelvi fájlokat a lang.en fájllal. Fejlesztési példány esetén helyezze el vagy tartsa meg az MRBS webkönyvtárban, és nyissa meg:

https://example.invalid/mrbs/checklang.php?lang[]=xx

Nyelvválasztás nélkül az összes telepített nyelvi fájlt kínálja. Az opcionális frissítési funkció fájlokat ír, ezért írási hozzáférést igényel; kerülje el ezt a gyártás során, és tekintse át a generált változtatásokat. Ha az ellenőrzés befejeződött, korlátozza vagy távolítsa el ezt a fejlesztői segédprogramot a nyilvános telepítésből.

A szintaktikai ellenőrzés és a checklang.php különböző problémák észlelése: mindkettőt használja.

Fordítsa le az alkalmazáson belüli súgóoldalt¶

A súgószöveg nem innen származik: $vocab. Külön tárolva:

web/site_faq/site_faq.html
web/site_faq/site_faq_de.html
web/site_faq/site_faq_fr.html
web/site_faq/site_faq_es.html

Válassza ki az aláhúzás nélküli utótagot:

$faqfilelang = 'de';

A régebbi értékeket, például a '_de'-t a rendszer elfogadja a kompatibilitás szempontjából, de elavult. A beállítás független a böngésző nyelvétől, ezért ellenőrizze, hogy a kiválasztott GYIK megfelel-e a célközönségnek. A szállított GYIK-fájlok helyi szerkesztéseit rögzíteni kell, és a frissítés során újra alkalmazni kell vagy egyesíteni kell.

Fordítsa le ezt a kézikönyvet¶

A dokumentációs webhely utótag fájlokat használ:

docs/admin-guide/custom-fields.md
docs/admin-guide/custom-fields.de.md
docs/admin-guide/custom-fields.fr.md
docs/admin-guide/custom-fields.es.md

Az angol a dokumentáció tartaléknyelve. Ezek a fájlok nem befolyásolják az MRBS alkalmazás felhasználói felületét vagy beépített súgóoldalát.

Frissítésbiztos munkafolyamat¶

Helyezze a csak webhelyre vonatkozó szöveget a $vocab_override-be.
Vezessen listát a helyileg karbantartott nyelvi és GYIK-fájlokról.
Hasonlítsa össze az új lang.en-t az előző verzióval a hozzáadott vagy módosított tokenek tekintetében.
Futtassa az php -l parancsot minden megváltozott nyelvi fájlon.
Futtassa az checklang.php kódot egy korlátozott fejlesztési példányon.
Tekintse át külön a GYIK módosításait.
Tesztelje az összes aktív nyelvet a telepítés előtt.

Ellenőrző lista¶

A böngésző észlelése és a kényszerített alapértelmezés kiválasztja a várt nyelvet.
A hiányzó tokenek visszakerülnek az érthető angol nyelvre.
A navigációs, űrlapok, hibák, jóváhagyások és adminisztrációs oldalak megfelelően jelennek meg.
A %s, %d és a helyzetjelzők a megfelelő értékeket kapják.
A dátumok, időpontok, hétköznapok és időzónák a kívánt területi beállítást használják.
Az e-mailek tárgyai és törzsei, jelentések, exportálások és parancssori feladatok a kívánt nyelvet használják.
A rendszer lefordítja az egyéni mezőket, a foglalási típusokat, a helyőrzőket és az érvényesítő üzeneteket.
A súgóoldal a várt site_faq fájlt használja.
A naplók nem tartalmaznak állandó nyelvi hibakeresést vagy érzékeny űrlapértékeket.