Metin ve çeviriler

MRBS uygulama sözlüğünü, siteye özgü metinleri, Yardım sayfalarını ve bu MkDocs kılavuzunu birbirinden ayırır. Yükseltmelerin yönetilebilir kalması için değişikliği doğru düzeyde yapın.

Görev	Doğru konum
Bir kurulum için etiketi yeniden adlandırın	$vocab_override config.inc.php içinde
MRBS kullanıcı arayüzü dilini ekleyin veya iyileştirin	web/lang/lang.<language>
Uygulama içi Yardım sayfasını çevirin veya özelleştirin	web/site_faq/site_faq_<language>.html
Bu kılavuzu tercüme edin	Aşağıdaki dil ekli dosya docs/

Bir site için ifadeleri geçersiz kıl

Gönderilen bir dil dosyasını yalnızca "Oda"yı yeniden adlandırmak veya site başlığını değiştirmek için düzenlemeyin. web/lang/lang.en'de jetonu bulun ve geçersiz kılın:

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

Dizin sırası her zaman dildir, ardından belirteç: $vocab_override[LANG][TOKEN].

Yararlı site tanımlı belirteçler şunları içerir:

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

Özel alan belirteçleri Özel alanlar'de açıklanmıştır. Rezervasyon türü açıklamalarında type.X kullanılır; burada X yapılandırılan tür kodudur.

Geçersiz kılmalar, site yapılandırmasında yer aldıkları için yükseltme işleminden sonra da hayatta kalırlar. Bir sürüm orijinal belirteci veya içeriğini değiştirirse anlamlarını yeniden kontrol edin.

İkame işaretlerini koru

Dil dizeleri %s, %d gibi printf işaretlerini veya %1$d gibi konumsal formları içerebilir. Her işaretçiyi ve türünü koruyun. Bir çeviri argümanları yalnızca konumsal formla yeniden sıralayabilir.

Ayrıca kasıtlı HTML parçalarını, noktalama işaretlerinin anlamlarını ve çevresindeki boşlukları da koruyun. Uygun olduğu yerde sıfır, bir ve çok sayımlarıyla dizeleri test edin.

Arayüz dilini seçin

Varsayılan olarak MRBS tarayıcıdan bir dil seçer:

$disable_automatic_language_changing = false;

Bir dili zorlamak için:

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

Belirtecin mevcut bir web/lang/lang.* dosyasıyla eşleşmesi gerekir. Tarih ve saatlere ilişkin yerel ayar seçimi ayrı ayrı geçersiz kılınabilir:

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

$override_locale ayrıca sunucu işletim sistemi tarafından da desteklenmelidir. $cli_language tarayıcının dışında çalıştırılan komutları kontrol eder. Teşhis için $language_debug = true dil ve yerel ayar bilgilerini hata günlüğüne yazar; sorun giderme sonrasında tekrar devre dışı bırakın.

Uygulama dili ekleme veya sürdürme

İngilizce dosya referans ve geri dönüştür. Algılanan belirteci xx olan bir dil oluşturmak için:

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

Sonra:

1. PHP açılış satırını ve tüm $vocab tuşlarını koruyun.
2. Belirteç adlarını değil dize değerlerini çevirin.
3. Dosyayı UTF-8 olarak kaydedin.
4.   dışında HTML varlıklarını kullanmayın; UTF-8 karakterlerini doğrudan yazın.
5. Değiştirme işaretleyicilerini ve kasıtlı işaretlemeyi koruyun.
6. PHP sözdizimini doğrulayın.

php -l web/lang/lang.xx

MRBS önce İngilizce referansı ve ardından seçilen dili yükler, böylece eksik belirteçler İngilizceye geri döner.

Eksiksizliğini kontrol edin

checklang.php dil dosyalarını lang.en ile karşılaştırır. Bir geliştirme örneği için, onu MRBS web dizinine yerleştirin veya saklayın ve açın:

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

Dil seçimi olmadan, kurulu tüm dil dosyalarını sunar. İsteğe bağlı güncelleme işlevi dosyaları yazar ve bu nedenle yazma erişimi gerektirir; Üretimde ve oluşturulan değişikliklerin gözden geçirilmesinde bundan kaçının. Denetim tamamlandığında bu geliştirme yardımcı programını genel dağıtımdan kısıtlayın veya kaldırın.

Sözdizimi kontrolü ve checklang.php farklı sorunları yakalar: ikisini de kullanın.

Uygulama içi Yardım sayfasını çevirin

Yardım metni $vocab adresinden gelmiyor. Ayrı olarak saklanır:

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

Alt çizgi olmadan son eki seçin:

$faqfilelang = 'de';

'_de' gibi daha eski değerler uyumluluk açısından kabul edilir ancak kullanımdan kaldırılmıştır. Ayar tarayıcı dilinden bağımsızdır; dolayısıyla seçilen SSS'nin hedef kitleyle eşleşip eşleşmediğini test edin. Gönderilen SSS dosyalarındaki yerel düzenlemeler, yükseltme sırasında kaydedilmeli ve yeniden uygulanmalı veya birleştirilmelidir.

Bu kılavuzu tercüme edin

Dokümantasyon web sitesi son ek dosyalarını kullanır:

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

İngilizce, belgelerin geri dönüşüdür. Bu dosyalar MRBS uygulamasının kullanıcı arayüzünü veya Yardım sayfasını etkilemez.

Yükseltme açısından güvenli iş akışı

1. $vocab_override alanına yalnızca siteye özel ifadeler koyun.
2. Yerel olarak tutulan dil ve SSS dosyalarının bir listesini tutun.
3. Eklenen veya değiştirilen jetonlar için yeni lang.en'yi önceki sürümle karşılaştırın.
4. Değiştirilen her dil dosyasında php -l komutunu çalıştırın.
5. Kısıtlı bir geliştirme örneğinde checklang.php komutunu çalıştırın.
6. SSS değişikliklerini ayrı ayrı inceleyin.
7. Dağıtımdan önce tüm etkin dilleri test edin.

Doğrulama kontrol listesi

• Tarayıcı algılama ve zorunlu varsayılan, beklenen dili seçer.
• Eksik belirteçler anlaşılır İngilizceye geri dönüyor.
• Gezinme, formlar, hatalar, onaylar ve yönetim sayfaları doğru şekilde işleniyor.
• %s, %d ve konum işaretçileri doğru değerleri alır.
• Tarihler, saatler, hafta içi günler ve saat dilimleri amaçlanan yerel ayarı kullanır.
• E-posta konuları ve gövdeleri, raporlar, dışa aktarmalar ve komut satırı işleri amaçlanan dili kullanır.
• Özel alanlar, rezervasyon türleri, yer tutucular ve doğrulama mesajları çevrilir.
• Yardım sayfası beklenen site_faq dosyasını kullanıyor.
• Günlükler kalıcı dil hata ayıklaması veya hassas form değerleri içermez.