AppLocalizator

Lokal Lokal

Alat yang kuat yang menyediakan kemampuan untuk menerjemahkan teks dengan cepat, yang dapat berguna saat mengembangkan restapi dengan multibahasa

Instalasi

 dotnet add package OftobTech.AppLocalizator

atau melalui alat Nuget di Visual Studio

Penggunaan dasar

Buat folder Lang di root proyek yang diterbitkan

Di dalam folder ini Anda dapat membuat file terjemahan, misalnya

 en.txt
jp.txt
ar.txt

Maka Anda tidak dapat menggunakan alat ini dalam kode

 using OftobTech . AppLocalizator ;

OftobTech . AppLocalizator . Reader . UpdateLangs ( ) ;

var message = T . Compile ( "[Text to transalete]" ) ;
Console . WriteLine ( message ) ;

Format file bahasa

[sentence for translate] : [translated sentence]
[sentence for translate] : [translated sentence]
[sentence for translate] : [translated sentence]
....

Setiap kalimat yang diterjemahkan harus diakhiri dengan transisi ke baris baru, pemisah teks untuk terjemahan dan teks yang diterjemahkan adalah usus besar

Konfigurasi

Perpustakaan juga mendukung konfigurasi minimal, yang memungkinkan Anda untuk mengkonfigurasi bahasa default dan lokasi folder dengan file terjemahan relatif terhadap proyek.

Jika file konfigurasi belum dibuat, yang default diambil:

 # The default language will be used if it 
# was not passed an additional parameter when using the library
DefaultLang: en

# The address of the language files can be either relative or absolute
LangsFilesPath: Langs

Anda dapat secara manual membuat data file menggunakan config/lang.conf berikut

Atau hubungi konstruksi berikut:

 using OftobTech . AppLocalizator ;

OftobTech . AppLocalizator . Config . PublishConfig ( ) ;

Yang secara otomatis akan membuat konfigurasi default

Mengubah bahasa selama eksekusi

Untuk mengubah bahasa selama pelaksanaan program, Anda perlu memanggil metode setLang(string lang)

 using OftobTech . AppLocalizator ;

T . setLang ( item . DeviceLanguage ) ;

Ini juga dapat dipanggil setiap kali sebelum terjemahan, (patut dipertimbangkan bahwa bahasa yang terakhir diingat)

 using OftobTech . AppLocalizator ;

T . setLang ( item . DeviceLanguage ) . Compile ( "[Text to transalete]" ) ; 

Terjemahan baris dengan parameter

Untuk menerjemahkan string dengan parameter dalam file terjemahan, Anda perlu menanamkan parameter ke dalam string terjemahan, ini dilakukan dengan membungkus beberapa pengidentifikasi parameter dalam contoh braket keriting:

Hello : Hello {parametr_1}  {parametr_2}

Untuk menerjemahkan string seperti itu ke dalam metode Compile, atribut ganti untuk memberikan objek dengan tipe Dictionary<string, string> , di mana kunci adalah pengidentifikasi parameter (tanpa kurung keriting) dan nilainya perlu diganti dengan

Contoh

 using OftobTech . AppLocalizator ;

var params = new Dictionary < string , string > ( ) {
    { "parametr_1" , "beautiful" } ,
    { "parametr_2" , "world!" } ,
}

T . setLang ( item . DeviceLanguage ) . Compile ( "Hello" , params ) ; 

Mode ketat

Perpustakaan mendukung 2 mode terjemahan mode dan waktu normal, dalam mode normal, jika tidak ada string yang cocok ditemukan dalam file terjemahan, string yang diteruskan dikembalikan, dalam mode ketat, jika string terjemahan tidak ditemukan, nol akan dikembalikan

Contoh

 using OftobTech . AppLocalizator ;

T . Compile ( "[Text to transalete]" , true ) ;
/// OR
T . Compile ( "[Text to transalete]" , params , true ) ; 

Memperbarui file bahasa

Ada kasus ketika ada kebutuhan untuk menambah atau memperbarui file bahasa, tetapi Anda tidak dapat memulai ulang aplikasi, maka metode updatelangs () dapat membantu Anda, yang memungkinkan Anda untuk memperbarui terjemahan dalam memori aplikasi dengan cepat

 using OftobTech . AppLocalizator ;

OftobTech . AppLocalizator . Reader . UpdateLangs ( ) ;