Yerelleştirme dosyası biçimleri

Weblate, çok çeşitli çeviri biçimlerini destekler. Her biçimin farklı yetenekler sağlayan farklı özellikleri vardır.

İpucu

Uygulamanız için bir dosya biçimi seçerken, kullandığınız araç takımında/platformda iyi çalışan bir biçime bağlı kalmak daha iyidir. Böylece, çevirmenleriniz alışkın oldukları araçları kullanabilir ve projenize katkıda bulunulma olasılığı yükselir.

Ayrıca bakınız

Translation Related File Formats

Kendiliğinden algılama

Weblate, Çeviri projelerini ve bileşenleri eklemek sırasında dosya biçimini algılamaya çalışır. Aynı serileştirme biçiminin (JSON, YAML, özellikler) ya da dosya kodlamasının farklı çeşitleri yanlış algılanabilir. Bu nedenle lütfen bileşeni oluşturmadan önce Dosya biçimi değerinin doğru olduğundan emin olun.

Çeviri türü yetenekleri

Desteklenen tüm biçimlerdeki yetenekler

Biçim	Dil bilgisi [1]	Çoğullar [2]	Açıklamalar [3]	Bağlam [4]	Konum [5]	İmler [8]	Ek durumlar [6]
GNU gettext PO (Portable Object)	iki dilde	evet	evet	evet	evet	evet [9]	düzenlenmesi gerekli
Tek dilli gettext	tek	evet	evet	evet	evet	evet [9]	düzenlenmesi gerekli
XLIFF 1.1 and 1.2	ikisi de	evet	evet	evet	evet	evet	düzenlenmesi gerekli, onaylanmış
Java özellikleri	ikisi de	hayır	evet	hayır	hayır	hayır
draggable/i18n dil dosyaları	tek	hayır	evet	hayır	hayır	hayır
GWT özellikleri	tek	evet	evet	hayır	hayır	hayır
Joomla! çevirileri	tek	hayır	evet	hayır	evet	hayır
Qt Linguist .ts	ikisi de	evet	evet	hayır	evet	evet	düzenlenmesi gerekli
Android dizge kaynakları	tek	evet	evet [7]	hayır	hayır	evet
Apple iOS dizgeleri	ikisi de	hayır	evet	hayır	hayır	hayır
PHP dizgeleri	tek	hayır [10]	evet	hayır	hayır	hayır
JSON dosyaları	tek	hayır	hayır	hayır	hayır	hayır
i18next JSON dosyaları	tek	evet	hayır	hayır	hayır	hayır
go-i18n JSON dosyaları	tek	evet	evet	hayır	hayır	hayır
gotext JSON dosyaları	tek	evet	evet	hayır	evet	hayır
ARB dosyası	tek	evet	evet	hayır	hayır	hayır
WebExtension JSON	tek	evet	evet	hayır	hayır	hayır
.NET kaynak dosyaları (RESX, RESW)	tek	hayır	evet	hayır	hayır	evet
ResourceDictionary dosyaları	tek	hayır	hayır	hayır	hayır	evet
CSV dosyaları	ikisi de	hayır	evet	evet	evet	hayır	düzenlenmesi gerekli
YAML dosyaları	tek	hayır	hayır	hayır	hayır	hayır
Ruby YAML dosyaları	tek	evet	hayır	hayır	hayır	hayır
DTD dosyaları	tek	hayır	hayır	hayır	hayır	hayır
Düz XML dosyaları	tek	hayır	hayır	hayır	hayır	evet
Windows RC dosyaları	tek	hayır	evet	hayır	hayır	hayır
Excel Open XML	tek	hayır	evet	evet	evet	hayır	düzenlenmesi gerekli
Uygulama mağazası üst veri dosyaları	tek	hayır	hayır	hayır	hayır	hayır
Alt yazı dosyaları	tek	hayır	hayır	hayır	evet	hayır
HTML dosyaları	tek	hayır	hayır	hayır	hayır	hayır
Markdown dosyaları	tek	hayır	hayır	hayır	hayır	hayır
OpenDocument biçimi	tek	hayır	hayır	hayır	hayır	hayır
IDML biçimi	tek	hayır	hayır	hayır	hayır	hayır
INI çevirileri	tek	hayır	hayır	hayır	hayır	hayır
Inno Setup INI çevirileri	tek	hayır	hayır	hayır	hayır	hayır
TermBase eXchange biçimi	iki dilde	hayır	evet	evet	hayır	evet
Metin dosyaları	tek	hayır	hayır	hayır	hayır	hayır
Stringsdict biçimi	tek	evet	hayır	hayır	hayır	hayır
Fluent biçimi	tek	hayır [11]	evet	hayır	hayır	hayır

[1]

Ayrıntılı bilgi almak için: İki dilli ve tek dilli biçimler

[2]

Ayrıntılı bilgi almak için: Çoğul biçimli dizgeler

[3]

Ayrıntılı bilgi almak için: Kaynak dizge açıklaması

[4]

Ayrıntılı bilgi almak için: Bağlam

[5]

Ayrıntılı bilgi almak için: Kaynak dizge konumu

[6]

Ayrıntılı bilgi almak için: Dizge durumları

[7]

<string> bileşeninden önce yerleştirilmiş XML açıklaması, kaynak dizge açıklaması olarak işlenir.

[8]

Ayrıntılı bilgi almak için: Çeviri imleri.

[9] (1,2)

Gettext türü yorumlar im olarak kullanılır.

[10]

Çoğul biçimler yalnızca bunları tanımlamak için dizge söz diziminde kullanan Laravel için desteklenir. Ayrıntılı bilgi almak için: Laravel ile yerelleştirme.

[11]

Çoğul biçimler, dizgelerin söz diziminde işlenir ve Weblate üzerinde çoğul olarak gösterilmez.

İki dilli ve tek dilli biçimler

Hem tek dilli hem de iki dilli biçimler desteklenir. İki dilli biçimler iki dili tek bir dosyada tutar. Kaynak ve çeviri (tipik örnekler GNU gettext PO (Portable Object), XLIFF 1.1 and 1.2 ya da Apple iOS dizgeleri). Diğer taraftan, tek dilli biçimler dizgeyi kimliğine göre tanımlar ve her dil dosyasında yalnızca bunların belirli bir dille eşleşmesi bulunur (genellikle Android dizge kaynakları). Bazı dosya biçimleri her iki çeşit için de kullanılır. Aşağıda ayrıntılı açıklamayı bulabilirsiniz.

Tek dilli dosyaların doğru kullanımı için Weblate, kaynaklarıyla çevrilecek dizgelerin tam listesinin bulunduğu bir dosyaya erişmelidir. Bu dosyaya Weblate içinde Tek dilli temel dil dosyası adı verilir. Ancak adlandırma yapınızda bu ad değişebilir.

Ayrıca, bu iş akışı, geliştiriciler tarafından sağlanan dizgeleri kapsayacak şekilde Ara dil dosyası kullanılarak genişletilebilir. Ancak son dizgelerde olduğu gibi kullanılmamalıdır.

Dizge durumları

Çoğu dosya biçimi yalnızca “Çevrilmemiş” ve “Çevrilmiş” dizgeleri birbirinden ayırır. Bazı biçimlerde, “Düzenlenmesi gerekli” ya da “Onaylanmış” gibi daha ayrıntılı durum bilgileri tutulabilir.

Kaynak dizge açıklaması

Kaynak dizge açıklamaları, çevrilecek dizge ile ilgili ek bilgiler vermek için kullanılabilir.

Çeşitli biçimler çevirmenlere ek bilgi sağlamak için yerel destek sağlar (XLIFF 1.1 and 1.2, GNU gettext PO (Portable Object), WebExtension JSON, CSV dosyaları, Excel Open XML, Qt Linguist .ts, go-i18n JSON dosyaları, gotext JSON dosyaları, ARB dosyası, .NET kaynak dosyaları (RESX, RESW) gibi). Diğer birçok biçim, kaynak dizge açıklaması olarak en yakın yorumu işler.

Açıklama

Dizgelerdeki Açıklama birkaç dosya biçiminde tutulabilir ve işlenebilir.

Şu anda yalnızca TermBase eXchange biçimi ile destekleniyor.

Kaynak dizge konumu

Bir dizgenin kaynak kodundaki konumu, yetkin çevirmenlerin dizgenin nasıl kullanıldığını anlamalarına yardımcı olabilir.

Bu bilgiler genellikle dizgelerin araçlar kullanılarak kaynak koddan ayıklandığı iki dilli biçimlerde bulunur. Örneğin GNU gettext PO (Portable Object) ve Qt Linguist .ts.

Çeviri imleri

Çeviri imleri, Weblate davranışının özelleştirilmesini sağlar. Bazı biçimler, imlerin çeviri dosyasında tanımlanmasını destekler (Weblate arayüzünden her zaman tanımlayabilirsiniz. Ayrıntılı bilgi almak için: Parametreleri kullanarak davranışı özelleştirmek).

Bu özellik, GNU gettext PO (Portable Object) içindeki imlerde modellenmiştir.

İmler, tüm XML tabanlı biçimler için standart olmayan weblate-flags özniteliğinden ayıklanır. Ek olarak, max-length:N, XLIFF standardında tanımlandığı gibi maxwidth özniteliği ile desteklenir. Ayrıntılı bilgi almak için: Çeviri imlerini belirtmek.

Ayrıca bakınız

• Parametreleri kullanarak davranışı özelleştirmek

• PO dosyaları belgeleri

Bağlam

Bağlam, farklı kapsamlarda kullanılan özdeş dizgeleri ayırt etmek için kullanılır (örneğin, İngilizce Sun, “Pazar” gününün kısaltılmış biçimi olarak ya da bize en yakın yıldızın adı olarak kullanılabilir).

Tek dilli biçimler için dizge belirteci (genellikle anahtar olarak adlandırılır) aynı amaca hizmet edebilir ve ek bağlam gerekli değildir.

Çoğul biçimli dizgeler

Çoğul biçimler, değişken sayısı olan dizgeleri doğru yerelleştirmek için gereklidir. Kurallar hedef dile bağlıdır ve birçok biçim bunun için CLDR teknik özelliklerini kullanılır.

İpucu

Çoğul biçimli dizgeler uygulama çatısı tarafından da desteklenmelidir. Platformunuza uygun GNU gettext PO (Portable Object), Android dizge kaynakları ya da Stringsdict biçimi yerel biçimini seçin.

Salt okunur dizgeler

Çeviri dosyalarındaki salt okunur dizgeler de alınır. Ancak Weblate üzerinde düzenlenemez. Bu özellik yerel olarak birkaç biçim (XLIFF 1.1 and 1.2 ve Android dizge kaynakları) tarafından desteklenir. Ancak salt okunur imi eklenerek diğerlerinde taklit edilebilir. Ayrıntılı bilgi almak için: Parametreleri kullanarak davranışı özelleştirmek.

Diğer biçimlerin desteği

Serileştirmeyi destekleyen translate-toolkit tarafından desteklenen çoğu biçim kolayca desteklenebilir. Ancak (henüz) herhangi bir deneme yapılmamıştır. Çoğu durumda, farklı depoların davranış farklılıklarını gizlemek için Weblate üzerinde bazı ince katmanlar gereklidir.

Yeni bir biçim desteği eklemek için yeğlenen yaklaşım, önce translate-toolkit içine bu biçim için desteği eklemektir.

Ayrıca bakınız

Translation Related File Formats

Dosya biçimi parametreleri

Dosya biçimi parametreleri, dosya biçimiyle ilgili ayarları yapılandırmak için bir yol sağlar. Bileşen düzeyinde yapılandırılırlar ve dosya işleme ile serileştirmesinin nasıl işleneceğini özelleştirmenizi sağlarlar.

Dosya biçimi parametreleri listesi

Parametre adı	Dosya biçimleri	Etiket	Yardım içeriği
csv_encoding	csv csv-multi	File encoding	Encoding used for CSV files Kullanılabilecek seçenekler: auto Auto-detect utf-8 UTF-8
csv_simple_encoding	csv-simple	File encoding	Encoding used for simple CSV files Kullanılabilecek seçenekler: auto Auto-detect utf-8 UTF-8 iso-8859-1 ISO-8859-1
flatxml_key_name	flatxml	FlatXML anahtar adı
flatxml_root_name	flatxml	FlatXML kök adı
flatxml_value_name	flatxml	FlatXML değer adı
gwt_encoding	gwt	File encoding	Encoding used for GWT Properties files Kullanılabilecek seçenekler: utf-8 UTF-8 iso-8859-1 ISO-8859-1
json_indent	json json-nested webextension i18next i18nextv4 arb go-i18n-json go-i18n-json-v2 formatjs gotext	JSON girintisi
json_indent_style	json json-nested webextension i18next i18nextv4 arb go-i18n-json go-i18n-json-v2 formatjs gotext	JSON girintisinin biçemi	Kullanılabilecek seçenekler: spaces Boşluklar tabs Sekmeler
json_sort_keys	json json-nested webextension i18next i18nextv4 arb go-i18n-json go-i18n-json-v2 formatjs gotext	JSON anahtarlarını sıralama
json_use_compact_separators	json json-nested webextension i18next i18nextv4 arb go-i18n-json go-i18n-json-v2 formatjs gotext	Ayraçlardan sonra boşluk bırakılmasın
merge_duplicates	markdown html txt dokuwiki mediawiki	Deduplicate identical strings	Consolidates identical source strings into a single translation unit. Prevents translation loss during file restructuring or table reordering by removing position-dependent context.
po_fuzzy_matching	po	Belirsiz eşleşme kullanılsın
po_keep_previous	po	Çevrilmiş dizgelerin önceki msgid değerleri saklansın
po_line_wrap	po po-mono	Uzun satırları kaydırma	Varsayılan olarak gettext satırları 77 karakterden sonra ve yeni satırlarda kaydırılır. --no-wrap parametresi kullanıldığında kaydırma yalnızca yeni satırlarda yapılır. Kullanılabilecek seçenekler: 77 Satırlar, 77 karakterden sonra ve yeni satırlarda kaydırılır (xgettext varsayılanı) 65535 Satırlar yalnızca yeni satırlarda kaydırılır (xgettext --no-wrap gibi) -1 Satırlar kaydırılmaz
po_no_location	po	Konum bilgileri dosyaya katılmasın
properties_encoding	properties xwiki-page-properties	File encoding	Encoding used for Java Properties files Kullanılabilecek seçenekler: iso-8859-1 ISO-8859-1 utf-8 UTF-8 utf-16 UTF-16
strings_encoding	strings	File encoding	Encoding used for iOS strings files Kullanılabilecek seçenekler: utf-16 UTF-16 utf-8 UTF-8
xml_closing_tags	ts plainxliff xliff xliff2 xliff2-placeables poxliff resx aresource moko-resource cmp-resource tbx	Boş XML kod imlerine kapanış kod imini ekler
yaml_indent	yaml ruby-yaml	YAML girintisi
yaml_line_break	yaml ruby-yaml	Satır sonları	Kullanılabilecek seçenekler: dos DOS (\r\n) unix UNIX (\n) mac MAC (\r)
yaml_line_wrap	yaml ruby-yaml	Uzun satırları kaydırma	Kullanılabilecek seçenekler: 80 Satırlar 80. karakterde kaydırılır 100 Satırlar 100. karakterde kaydırılır 120 Satırlar 120. karakterde kaydırılır 180 Satırlar 180. karakterde kaydırılır 65535 Satırlar kaydırılmaz