Teksti ja käännökset¶

MRBS käsittelee erikseen sovelluksen käyttöliittymätekstit, sivustokohtaiset sanamuodot, ohjesivut ja tämän MkDocs-käsikirjan. Valitse muutokselle oikea taso, jotta päivitykset pysyvät hallittavina.

Tehtävä	Oikea sijainti
Muuta yksittäisen asennuksen käyttöliittymätekstiä	`$vocab_override` tiedostossa `config.inc.php`
Lisää MRBS-käyttöliittymän kieli tai paranna sitä	`web/lang/lang.<language>`
Käännä tai muokkaa sovelluksen sisäistä ohjesivua	`web/site_faq/site_faq_<language>.html`
Käännä tämä käsikirja	Kielitunnuksella nimetty tiedosto hakemistossa `docs/`

Ohita yhden sivuston sanamuoto¶

Älä muokkaa mukana toimitettua kielitiedostoa vain nimetäksesi esimerkiksi ”Huone”-tekstin uudelleen tai muuttaaksesi sivuston otsikkoa. Etsi tunnus tiedostosta web/lang/lang.en ja ohita sen arvo:

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

Taulukon indeksien järjestys on aina ensin kieli ja sitten tunnus: $vocab_override[LANG][TOKEN].

Hyödyllisiä sivuston määrittämiä tunnuksia ovat:

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

Mukautettujen kenttien tunnukset kuvataan luvussa Mukautetut kentät. Varaustyyppien nimissä käytetään tunnusta type.X, jossa X on määritetty tyyppikoodi.

Ohitukset säilyvät päivityksissä, koska ne ovat sivuston omissa määrityksissä. Tarkista niiden merkitys uudelleen, jos uusi julkaisu muuttaa alkuperäistä tunnusta tai sen käyttöyhteyttä.

Säilytä muotoilumääreet¶

Kielimerkkijonot voivat sisältää printf-muotoilumääreitä, kuten %s ja %d, tai argumentin sijainnin ilmaisevia muotoja, kuten %1$d. Säilytä jokainen määre ja sen tyyppi. Argumenttien järjestystä voi muuttaa käännöksessä vain käyttämällä sijainnin ilmaisevaa muotoa.

Säilytä myös tarkoitukselliset HTML-katkelmat, välimerkkien merkitys ja ympäröivät välilyönnit. Testaa määrää ilmaisevat tekstit tarvittaessa arvoilla nolla, yksi ja monta.

Valitse käyttöliittymän kieli¶

Oletusarvoisesti MRBS valitsee kielen selaimesta:

$disable_automatic_language_changing = false;

Yhden kielen pakottaminen:

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

Kielitunnuksen on vastattava saatavilla olevaa tiedostoa web/lang/lang.*. Päivämäärien ja kellonaikojen maa-asetuksen voi ohittaa erikseen:

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

Myös palvelimen käyttöjärjestelmän on tuettava $override_locale-arvoa. $cli_language määrittää selaimen ulkopuolella suoritettavien komentojen kielen. Vianmääritystä varten $language_debug = true kirjoittaa kieli- ja maa-asetustiedot virhelokiin. Poista asetus käytöstä vianmäärityksen jälkeen.

Lisää tai säilytä sovelluskieli¶

Englanninkielinen tiedosto toimii viitteenä ja varakielenä. Luo tunnuksella xx tunnistettava kieli näin:

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

Sitten:

Säilytä PHP-aloitusrivi ja kaikki $vocab-avaimet.
Käännä merkkijonojen arvot, älä tunnusten nimiä.
Tallenna tiedosto UTF-8-muodossa.
Älä käytä HTML-entiteettejä lukuun ottamatta entiteettiä  ; kirjoita UTF-8-merkit suoraan.
Säilytä muotoilumääreet ja tarkoitukselliset merkintärakenteet.
Tarkista PHP-syntaksi.

php -l web/lang/lang.xx

MRBS lataa ensin englanninkielisen viitetiedoston ja sitten valitun kielen, joten puuttuvien tunnusten tekstit näytetään englanniksi.

Tarkista täydellisyys¶

checklang.php vertaa kielitiedostoja tiedostoon lang.en. Sijoita tai säilytä apuohjelma MRBS:n verkkohakemistossa vain kehitysasennuksessa ja avaa:

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

Ilman kielivalintaa apuohjelma näyttää kaikki asennetut kielitiedostot. Valinnainen päivitystoiminto kirjoittaa tiedostoihin ja tarvitsee siksi kirjoitusoikeuden. Älä käytä sitä tuotannossa, ja tarkista sen tekemät muutokset. Estä julkinen pääsy kehitysapuohjelmaan tai poista se, kun tarkistus on valmis.

Syntaksin tarkistus ja checklang.php havaitsevat erilaiset ongelmat: käytä molempia.

Käännä sovelluksen sisäinen ohjesivu¶

Ohjeteksti ei tule $vocab-taulukosta, vaan se tallennetaan erillisiin tiedostoihin:

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

Valitse pääte ilman alaviivaa:

$faqfilelang = 'de';

Vanhemmat arvot, kuten '_de', hyväksytään yhteensopivuuden vuoksi, mutta ne ovat vanhentuneita. Asetus ei riipu selaimen kielestä, joten varmista, että valittu UKK sopii kohdeyleisölle. Säilytä mukana toimitettuihin UKK-tiedostoihin tehdyt paikalliset muutokset ja ota ne päivityksen yhteydessä uudelleen käyttöön tai yhdistä ne uuteen versioon.

Käännä tämä käsikirja¶

Dokumentaatiosivusto käyttää päätetiedostoja:

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

Englanti toimii dokumentaation varakielenä. Nämä tiedostot eivät vaikuta MRBS-sovelluksen käyttöliittymään tai sen sisäiseen ohjesivuun.

Päivitysturvallinen työnkulku¶

Lisää vain sivuston sanamuoto kohtaan $vocab_override.
Pidä luetteloa paikallisesti ylläpidetyistä kieli- ja UKK-tiedostoista.
Vertaa uutta lang.en-tiedostoa aiempaan versioon ja etsi lisätyt tai muutetut tunnukset.
Suorita php -l jokaisessa muuttuneessa kielitiedostossa.
Suorita checklang.php suojatussa kehitysasennuksessa.
Tarkista UKK-muutokset erikseen.
Testaa kaikki aktiiviset kielet ennen käyttöönottoa.

Vahvistuksen tarkistuslista¶

Selaimen tunnistus ja pakotettu oletus valitsevat odotetun kielen.
Puuttuvat tunnukset näkyvät ymmärrettävänä englanninkielisenä tekstinä.
Navigointi-, lomakkeet, virheet, hyväksynnät ja hallintasivut näkyvät oikein.
%s, %d ja muut muotoilumääreet saavat oikeat arvot.
Päivämäärät, kellonajat, viikonpäivät ja aikavyöhykkeet käyttävät tarkoitettua maa-asetusta.
Sähköpostien aiheet ja viestit, raportit, vientitoiminnot ja komentorivitehtävät käyttävät haluttua kieltä.
Mukautettujen kenttien nimet, varaustyypit, esimerkkitekstit ja tarkistusviestit on käännetty.
Ohje-sivu käyttää odotettua site_faq-tiedostoa.
Lokeihin ei jää kielivirheenkorjausta tai arkaluontoisia lomakearvoja.