Text och översättningar¶

MRBS skiljer mellan programmets ordlista, platsspecifika texter, hjälpsidor och den här MkDocs-handboken. Välj rätt nivå för ändringen så att uppgraderingar förblir hanterbara.

Uppgift	Rätt plats
Byt namn på en etikett för en installation	`$vocab_override` i `config.inc.php`
Lägg till eller förbättra ett MRBS UI-språk	`web/lang/lang.<language>`
Översätt eller anpassa hjälpsidan i applikationen	`web/site_faq/site_faq_<language>.html`
Översätt den här manualen	En fil med språksuffix nedan `docs/`

Åsidosätt ordalydelsen för en webbplats¶

Redigera inte en skickad språkfil bara för att byta namn på "Rum" eller ändra webbplatsens titel. Hitta token i web/lang/lang.en och åsidosätt den sedan:

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

Indexordningen är alltid språk, sedan token: $vocab_override[LANG][TOKEN].

Användbara platsdefinierade tokens inkluderar:

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

Custom-field tokens beskrivs i Anpassade fält. Beskrivningar av bokningstyp använder type.X, där X är den konfigurerade typkoden.

Åsidosättningar överlever en uppgradering eftersom de lever i webbplatsens konfiguration. Kontrollera deras innebörd igen om en utgåva ändrar den ursprungliga token eller dess sammanhang.

Bevara ersättningsmarkörer¶

Språksträngar kan innehålla printf-markörer som %s, %d eller positionsformer som %1$d. Bevara varje markör och dess typ. En översättning kan endast ordna om argument med positionsformen.

Bevara även avsiktliga HTML-fragment, skiljeteckensemantik och omgivande utrymmen. Teststrängar med noll, ett och många där tillämpligt.

Välj körtidsspråk¶

Som standard väljer MRBS ett språk från webbläsaren:

$disable_automatic_language_changing = false;

För att tvinga fram ett språk:

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

Token måste matcha en tillgänglig web/lang/lang.*-fil. Val av språk för datum och tider kan åsidosättas separat:

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

$override_locale måste också stödjas av serverns operativsystem. $cli_language kontrollerar kommandon som körs utanför webbläsaren. För diagnos skriver $language_debug = true språk- och lokalinformation till felloggen; inaktivera den igen efter felsökning.

Lägg till eller underhåll ett applikationsspråk¶

Den engelska filen är referens och reserv. Så här skapar du ett språk vars identifierade token är xx:

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

Sedan:

Behåll öppningslinjen PHP och varje $vocab-nyckel.
Översätt strängvärden, inte tokennamn.
Spara filen som UTF-8.
Använd inte HTML-entiteter förutom  ; skriv UTF-8-tecken direkt.
Bevara ersättningsmarkörer och avsiktlig markering.
Validera syntaxen PHP.

php -l web/lang/lang.xx

MRBS laddar först den engelska referensen och sedan det valda språket, så saknade tokens faller tillbaka till engelska.

Kontrollera fullständigheten¶

checklang.php jämför språkfiler med lang.en. För en utvecklingsinstans, placera eller behåll den i webbkatalogen MRBS och öppna:

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

Utan språkval erbjuder den alla installerade språkfiler. Den valfria uppdateringsfunktionen skriver filer och kräver därför skrivåtkomst; undvika det vid produktion och granska genererade förändringar. Begränsa eller ta bort detta utvecklingsverktyg från en offentlig distribution när kontrollen är klar.

Syntaxkontroll och checklang.php fångar olika problem: använd båda.

Översätt hjälpsidan i applikationen¶

Hjälptexten kommer inte från $vocab. Den lagras separat:

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älj suffixet utan understreck:

$faqfilelang = 'de';

Äldre värden som '_de' accepteras för kompatibilitet men fasas ut. Inställningen är oberoende av webbläsarens språk, så testa att vald FAQ matchar den avsedda målgruppen. Lokala redigeringar av skickade FAQ-filer måste registreras och tillämpas igen eller slås samman under en uppgradering.

Översätt den här manualen¶

Dokumentationswebbplatsen använder suffixfiler:

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

Engelska är dokumentationens reserv. Dessa filer påverkar inte applikationens MRBS eller dess hjälpsida.

Uppgraderingssäkert arbetsflöde¶

Sätt endast webbplatsens ordalydelse i $vocab_override.
Håll en lista över lokalt underhållna språk- och FAQ-filer.
Jämför en ny lang.en med den tidigare versionen för tillagda eller ändrade tokens.
Kör php -l på varje ändrad språkfil.
Kör checklang.php på en begränsad utvecklingsinstans.
Granska ändringar av vanliga frågor separat.
Testa alla aktiva språk före implementering.

Verifieringschecklista¶

Webbläsardetektering och påtvingad standard väljer det förväntade språket.
Saknade tokens faller tillbaka till begriplig engelska.
Navigering, formulär, fel, godkännanden och administrationssidor återges korrekt.
%s, %d och positionsmarkörer får rätt värden.
Datum, tider, veckodagar och tidszoner använder det avsedda språket.
E-postämnen och texter, rapporter, exporter och kommandoradsjobb använder det avsedda språket.
Anpassade fält, bokningstyper, platshållare och valideringsmeddelanden översätts.
Hjälpsidan använder den förväntade site_faq-filen.
Loggar innehåller inga ihållande språkfelsökning eller känsliga formulärvärden.