Tekst i prevodi¶

MRBS odvaja rečnik aplikacije, tekstove konkretnog sajta, stranice pomoći i ovaj MkDocs priručnik. Izaberite odgovarajući nivo izmena kako bi nadogradnje ostale jednostavne.

Zadatak	Tačna lokacija
Preimenujte oznaku za jednu instalaciju	`$vocab_override` u `config.inc.php`
Dodajte ili poboljšajte MRBS UI jezik	`web/lang/lang.<language>`
Prevedite ili prilagodite stranicu pomoći u aplikaciji	`web/site_faq/site_faq_<language>.html`
Prevedite ovaj priručnik	Datoteka sa jezičkim sufiksom ispod `docs/`

Zameni formulaciju za jedan sajt¶

Nemojte uređivati isporučenu jezičku datoteku samo da biste preimenovali „Soba“ ili promenili naslov sajta. Pronađite token u web/lang/lang.en, a zatim ga zamenite:

$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';

Redosled indeksa je uvek jezik, a zatim token: $vocab_override[LANG][TOKEN].

Korisni tokeni definisani na sajtu uključuju:

$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';

Tokeni prilagođenog polja su opisani u Prilagođena polja. Opisi tipa rezervacije koriste type.X, gde je X konfigurisani kod tipa.

Zaobilaženja preživljavaju nadogradnju jer žive u konfiguraciji sajta. Ponovo proverite njihovo značenje ako izdanje promeni originalni token ili njegov kontekst.

Sačuvajte markere zamene¶

Nizovi jezika mogu da sadrže markere printf kao što su %s, %d ili pozicione forme kao što je %1$d. Sačuvajte svaki marker i njegovu vrstu. Prevod može preurediti argumente samo sa pozicionom formom.

Takođe sačuvajte namerno HTML fragmente, semantiku interpunkcije i okolne prostore. Test stringovi sa brojem nula, jedan i mnogo gde je primenljivo.

Izaberite jezik za izvršavanje¶

Podrazumevano, MRBS bira jezik iz pretraživača:

$disable_automatic_language_changing = false;

Da biste prisilili jedan jezik:

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

Token mora da odgovara dostupnoj web/lang/lang.* datoteci. Izbor lokalnog jezika za datume i vremena može se posebno zameniti:

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

$override_locale takođe mora biti podržan od strane operativnog sistema servera. $cli_language kontroliše komande koje se pokreću van pretraživača. Za dijagnozu, $language_debug = true upisuje informacije o jeziku i lokalitetu u dnevnik grešaka; ponovo ga onemogućite nakon rešavanja problema.

Dodajte ili održavajte jezik aplikacije¶

Engleska datoteka je referenca i rezervni. Da biste kreirali jezik čiji je otkriveni token xx:

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

onda:

Zadržite početnu liniju PHP i svaki taster $vocab.
Prevedite vrednosti stringova, a ne imena tokena.
Sačuvajte datoteku kao UTF-8.
Nemojte koristiti HTML entitete osim  ; direktno upišite UTF-8 znakove.
Sačuvajte markere zamene i namerno označavanje.
Potvrdite sintaksu PHP.

php -l web/lang/lang.xx

MRBS prvo učitava referencu na engleskom, a zatim izabrani jezik, tako da se tokeni koji nedostaju vraćaju na engleski.

Proverite kompletnost¶

checklang.php upoređuje jezičke datoteke sa lang.en. Za primer razvoja, stavite ili zadržite ga u veb direktorijumu MRBS i otvorite:

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

Bez izbora jezika nudi sve instalirane jezičke datoteke. Opciona funkcija ažuriranja piše datoteke i stoga zahteva pristup pisanju; izbegavajte to u proizvodnji i pregledajte generisane promene. Ograničite ili uklonite ovaj razvojni uslužni program iz javne primene kada se provera završi.

Provera sintakse i checklang.php otkrivaju različite probleme: koristite oba.

Prevedite stranicu pomoći u aplikaciji¶

Tekst pomoći ne dolazi sa $vocab. Čuva se odvojeno:

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

Izaberite sufiks bez donje crte:

$faqfilelang = 'de';

Starije vrednosti kao što je '_de' su prihvaćene radi kompatibilnosti, ali su zastarele. Podešavanje je nezavisno od jezika pretraživača, pa proverite da li izabrana česta pitanja odgovara ciljanoj publici. Lokalne izmene isporučenih datoteka sa čestim pitanjima moraju biti snimljene i ponovo primenjene ili spojene tokom nadogradnje.

Prevedite ovaj priručnik¶

Veb lokacija za dokumentaciju koristi datoteke sa sufiksima:

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

Engleski je rezervni za dokumentaciju. Ove datoteke ne utiču na korisničko sučelje aplikacije MRBS ili njegovu stranicu pomoći.

Tok rada bezbedan nadogradnjom¶

Stavite formulaciju samo za sajt u $vocab_override.
Čuvajte listu lokalno održavanih jezika i datoteka sa čestim pitanjima.
Uporedite novu lang.en sa prethodnom verzijom za dodate ili promenjene tokene.
Pokrenite php -l na svakoj promenjenoj jezičkoj datoteci.
Pokrenite checklang.php na ograničenoj razvojnoj instanci.
Pregledajte izmene u čestim pitanjima zasebno.
Testirajte sve aktivne jezike pre primene.

Kontrolna lista za verifikaciju¶

Otkrivanje pretraživača i prinudna podrazumevana podešavanja biraju očekivani jezik.
Tokeni koji nedostaju vraćaju se na razumljiv engleski.
Navigacija, obrasci, greške, odobrenja i stranice administracije se prikazuju ispravno.
%s, %d i pozicioni markeri dobijaju prave vrednosti.
Datumi, vremena, dani u nedelji i vremenske zone koriste predviđeni lokalitet.
Predmeti i tela e-pošte, izveštaji, izvozi i poslovi komandne linije koriste predviđeni jezik.
Prilagođena polja, tipovi rezervacija, čuvari mesta i poruke o validaciji se prevode.
Stranica pomoći koristi očekivanu datoteku site_faq.
Dnevnici ne sadrže trajno otklanjanje grešaka u jeziku ili osetljive vrednosti obrasca.