Çoklu dil desteği ile XPages uygulaması geliştirmek için öncelikle uygulamamızın Application Properties > XPages > Localization Options bölümünde desteklenecek diller seçilir.
Akabinde menüden Project > Clean işlemi yapılır. Böylece desteklenecek diller için gerekli resource dosyaları oluşturulmuş olur.
Peki bu Resource dosyaları nerede ?
XPages görünümü (prespective) açılır. Veya Package Explorer açılır.
XPages, CustomControls klasörlerinde (eğer varsa Files klasöründe de) ekstra dosyalar oluşacaktır. Bu dosyalar [Design Elemanı Adı]_tr.properties, [Design Elemanı Adı]_fr.properties ismindeki dosyalardır.
Domino Designer, XPages ve Custom Control design elemanlarında kullanılan TEXT değerleri (Bunlar label, view panel kolon başlığı, computed text içindeki yazılar) özel bir formatta çıkarır.
Örneğin;
/xp\:view[1]/xp\:div[1]/xe\:tagCloud[1]/@alternateText=[tr| {0} Entries ]
Burada yapılması gereken “=” işareti sonrasındaki ifadeleri düzenlemek.
TR için aşağıdaki şekilde bir düzenleme olacaktır.
/xp\:view[1]/xp\:div[1]/xe\:tagCloud[1]/@alternateText={0} Adet
Ancak sorun şu ki .properties dosyaları ISO-8859-1 formatındadır. Text File Encoding değerini ne seçerseniz seçin bozuk gösteriyor. Kendi kendine dönüşüm yapıyor mu emin değilim ancak olur da yapmazsa Türkçe karakterleri browserda düzgün görüntülemek için encoding yapmamız gerekiyor.
Bunun için de JDK içinde bulunan native2ascii.exe imdadımıza yetişiyor.
Yapmanız gereken;
- .resource dosyasını türkçe karakterli bir şekilde Notepad de hazırlanır.
- Bu dosyayı UTF-8 encoding olacak şekilde TXT formatında kaydedilir.
- Command Prompt açılır.
- Aşağıdaki komutlar çalıştırılır.
C:\Program Files (x86)\Java\jdk1.6.0_20\bin>native2ascii.exe -encoding utf8 res1.txt res2.txt
C:\Program Files (x86)\Java\jdk1.6.0_20\bin>
res2.txt dosyasında encode edilmiş bilgiler mevcut olacaktır. Bu bilgileri aynen .resource dosyasına yapıştırın.
Türkçe karakterler browser da olması gerektiği gibi görünecektir.
Örnek Çıktı :
/xp\:view[1]/@pageTitle=Test Kullanıcısı Yönetim Aracı —> /xp\:view[1]/@pageTitle=[tr| Test Kullan\u00FDc\u00FDs\u00FD Y\u00F6netim Arac\u00FD ]
Referanslar
- http://www-10.lotus.com/ldd/ddwiki.nsf/dx/UsingLocalizationOptions.htm
- http://docs.oracle.com/javase/1.4.2/docs/tooldocs/windows/native2ascii.html
Çoklu dil desteği ile XPages uygulaması geliştirmek için öncelikle uygulamamızın Application Properties > XPages > Localization Options bölümünde desteklenecek diller seçilir.
Akabinde menüden Project > Clean işlemi yapılır. Böylece desteklenecek diller için gerekli resource dosyaları oluşturulmuş olur.
Peki bu Resource dosyaları nerede ?
XPages görünümü (prespective) açılır. Veya Package Explorer açılır.
XPages, CustomControls klasörlerinde (eğer varsa Files klasöründe de) ekstra dosyalar oluşacaktır. Bu dosyalar [Design Elemanı Adı]_tr.properties, [Design Elemanı Adı]_fr.properties ismindeki dosyalardır.
Domino Designer, XPages ve Custom Control design elemanlarında kullanılan TEXT değerleri (Bunlar label, view panel kolon başlığı, computed text içindeki yazılar) özel bir formatta çıkarır.
Örneğin;
/xp\:view[1]/xp\:div[1]/xe\:tagCloud[1]/@alternateText=[tr| {0} Entries ]
Burada yapılması gereken “=” işareti sonrasındaki ifadeleri düzenlemek.
TR için aşağıdaki şekilde bir düzenleme olacaktır.
/xp\:view[1]/xp\:div[1]/xe\:tagCloud[1]/@alternateText={0} Adet
Ancak sorun şu ki .properties dosyaları ISO-8859-1 formatındadır. Text File Encoding değerini ne seçerseniz seçin bozuk gösteriyor. Kendi kendine dönüşüm yapıyor mu emin değilim ancak olur da yapmazsa Türkçe karakterleri browserda düzgün görüntülemek için encoding yapmamız gerekiyor.
Bunun için de JDK içinde bulunan native2ascii.exe imdadımıza yetişiyor.
Yapmanız gereken;
- .resource dosyasını türkçe karakterli bir şekilde Notepad de hazırlanır.
- Bu dosyayı UTF-8 encoding olacak şekilde TXT formatında kaydedilir.
- Command Prompt açılır.
- Aşağıdaki komutlat çalıştırılır.
C:\Program Files (x86)\Java\jdk1.6.0_20\bin>native2ascii.exe -encoding utf8 res1.txt res2.txt
C:\Program Files (x86)\Java\jdk1.6.0_20\bin>
res2.txt dosyasında encode edilmiş bilgiler mevcut olacaktır. Bu bilgileri aynen .resource dosyasına yapıştırın.
Türkçe karakterler browser da olması gerektiği gibi görünecektir.
Örnek Çıktı :
/xp\:view[1]/@pageTitle=Test Kullanıcısı Yönetim Aracı —> /xp\:view[1]/@pageTitle=[tr| Test Kullan\u00FDc\u00FDs\u00FD Y\u00F6netim Arac\u00FD ]
Referanslar
- http://www-10.lotus.com/ldd/ddwiki.nsf/dx/UsingLocalizationOptions.htm
- http://docs.oracle.com/javase/1.4.2/docs/tooldocs/windows/native2ascii.html