Testua eta itzulpenak¶

MRBSk aplikazioaren hiztegia, gunearen formulazio bereziak, Laguntza-orriak eta MkDocs eskuliburu hau bereizten ditu. Aukeratu geruza egokia, bertsio-berritzeak kudeagarriak izan daitezen.

Zeregin	Kokapen zuzena
Aldatu etiketa baten izena instalazio batean	`$vocab_override` `config.inc.php` fitxategian
Gehitu edo hobetu MRBS UI hizkuntza bat	`web/lang/lang.<language>`
Itzuli edo pertsonalizatu aplikazioko Laguntza orria	`web/site_faq/site_faq_<language>.html`
Itzuli eskuliburu hau	`docs/` azpian hizkuntza-atzizkia duen fitxategi bat

Gainidatzi gune baten testua¶

Ez editatu bidalitako hizkuntza-fitxategi bat "Gela" izena aldatzeko edo gunearen izenburua aldatzeko. Bilatu tokena web/lang/lang.en-n, eta, ondoren, baliogabetu:

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

Indize-ordena beti hizkuntza da, gero tokena: $vocab_override[LANG][TOKEN].

Guneak definitutako token erabilgarriak hauek dira:

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

Eremu pertsonalizatuko tokenak Eremu pertsonalizatuak atalean deskribatzen dira. Erreserba motako deskribapenek type.X erabiltzen dute, non X konfiguratutako motaren kodea den.

Gainidazketak mantendu egiten dira bertsio-berritzean, gunearen konfigurazioan baitaude. Egiaztatu berriro haien esanahia bertsio batek jatorrizko tokena edo testuingurua aldatzen badu.

Gorde ordezkapen-markak¶

Hizkuntza-kateek printf markatzaileak izan ditzakete, hala nola %s, %d, edo %1$d bezalako posizio-formak. Kontserba ezazu markatzaile bakoitza eta bere mota. Itzulpen batek posizio formarekin soilik berrantola ditzake argumentuak.

Era berean, gorde nahita HTML zatiak, puntuazio-semantika eta inguruko espazioak. Probatu kateak zero, bat eta askoren zenbaketarekin, hala badagokio.

Hautatu exekuzio-denborako hizkuntza¶

Lehenespenez, MRBSk arakatzailearen ezarpenen arabera aukeratzen du hizkuntza:

$disable_automatic_language_changing = false;

Hizkuntza bat behartzeko:

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

Tokenak erabilgarri dagoen web/lang/lang.* fitxategi batekin bat etorri behar du. Data eta orduetarako tokiko aukeraketa bereizita baliogabe daiteke:

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

$override_locale zerbitzariaren sistema eragileak ere onartu behar du. $cli_language arakatzailetik kanpo exekutatzen diren komandoak kontrolatzen ditu. Diagnostikoa egiteko, $language_debug = true hizkuntza eta tokiko informazioa idazten du erroreen erregistroan; desgaitu berriro arazoak konpondu ondoren.

Gehitu edo mantendu aplikazioaren hizkuntza¶

Ingelesezko fitxategia erreferentzia eta ordezko hizkuntza da. Identifikatzailea xx duen hizkuntza bat sortzeko:

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

Orduan:

Mantendu PHP hasierako lerroa eta $vocab tekla bakoitza.
Itzuli kate-balioak, ez token-izenak.
Gorde fitxategia UTF-8 gisa.
Ez erabili HTML entitateak   izan ezik; idatzi UTF-8 karaktereak zuzenean.
Gorde ordezkapen-markak eta nahita marka.
Egiaztatu PHP sintaxia.

php -l web/lang/lang.xx

MRBSk lehenik ingelesezko erreferentzia eta gero hautatutako hizkuntza kargatzen ditu; beraz, falta diren tokenen ordez ingelesezko testua agertzen da.

Egiaztatu osotasuna¶

checklang.php tresnak hizkuntza-fitxategiak lang.en fitxategiarekin alderatzen ditu. Garapen-instalazio batean, jarri edo mantendu MRBSren web-direktorioan eta ireki:

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

Hizkuntzarik hautatzen ez bada, instalatutako hizkuntza-fitxategi guztiak eskaintzen ditu. Aukerako eguneratze-funtzioak fitxategiak aldatzen ditu eta, beraz, idazteko baimena behar du; ez erabili produkzioan, eta berrikusi sortutako aldaketak. Egiaztapena amaitzean, mugatu tresna horretarako sarbidea edo kendu instalazio publikotik.

Sintaxi-egiaztapenak eta checklang.php tresnak arazo desberdinak hautematen dituzte; erabili biak.

Itzuli aplikazioko Laguntza orria¶

Laguntza-testua ez dator $vocab-tik. Bereiz gordetzen da:

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

Hautatu atzizkia azpimarrarik gabe:

$faqfilelang = 'de';

'_de' bezalako balio zaharragoak bateragarritasunerako onartzen dira baina zaharkituta daude. Ezarpena arakatzailearen hizkuntzatik independentea da, beraz, probatu hautatutako FAQ-ak nahi den publikoarekin bat datozela. Bidaltzen diren FAQ fitxategien tokiko aldaketak berritze batean grabatu eta berriro aplikatu edo batu egin behar dira.

Itzuli eskuliburu hau¶

Dokumentazio-webguneak hizkuntza-atzizkia duten fitxategiak erabiltzen ditu:

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

Ingelesa dokumentazioaren ordezkoa da. Fitxategi hauek ez diote eragiten MRBS aplikazioaren interfazeari edo bere Laguntza-orrian.

Berritze-lan-fluxu segurua¶

Jarri gunerako soilik hitza $vocab_override-n.
Gorde lokalean mantentzen diren hizkuntza eta FAQ fitxategien zerrenda.
Konparatu lang.en berri bat aurreko bertsioarekin gehitutako edo aldatutako tokenetarako.
Exekutatu php -l aldatutako hizkuntza-fitxategi guztietan.
Exekutatu checklang.php garapen mugatuko instantzia batean.
Berrikusi ohiko aldaketak bereizita.
Probatu hizkuntza aktibo guztiak zabaldu aurretik.

Egiaztapen-zerrenda¶

Arakatzailea hautematea eta behartutako lehenetsia hautatzen dute espero den hizkuntza.
Falta diren tokenak ingeles ulergarrira itzultzen dira.
Nabigazioa, inprimakiak, akatsak, onespenak eta administrazio-orriak behar bezala errendatzen dira.
%s, %d eta posizio-markak balio egokiak jasotzen dituzte.
Datek, orduek, astegunek eta ordu-eremuek aurreikusitako lokalizazioa erabiltzen dute.
Posta elektronikoaren gai-lerroek eta gorputzek, txostenek, esportazioek eta komando-lerroko lanek aurreikusitako hizkuntza erabiltzen dute.
Eremu pertsonalizatuak, erreserba motak, leku-markak eta baliozkotze-mezuak itzultzen dira.
Laguntza-orriak espero den site_faq fitxategia erabiltzen du.
Erregistroek ez dute hizkuntza-arazketa iraunkorrik edo inprimaki-balio sentikorrik.