Eklentiler¶

Eklentiler, çeviri iş akışını özelleştirmesi ve kendiliğinden yapılması için yöntemler sağlar. Yöneticiler, her bir çeviri bileşenine İşlemler ↓ Eklentiler menüsünden eklentiler ekleyip yönetebilir. Eklentiler Yönetim arayüzü bölümünden de site genelinde kurulabilir.

İpucu

Eklentileri API, DEFAULT_ADDONS ya da install_addon kullanarak da yapılandırabilirsiniz.

Eklentileri tetikleyen olaylar¶

Eklenti kurulumu¶

Eklenti kurulurken tetiklenir.

Bileşen güncellemesi¶

Bir bileşende aşağıdaki gibi bir değişiklik olduğunda tetiklenir:

Depodaki dizgeler değiştirildiğinde.
Bir dizge eklendiğinde.
Yeni bir çeviri eklendi.

Günlük¶

Günlük olarak tetiklenir, ancak eklentiler genellikle BACKGROUND_TASKS seçeneğine bağlı olarak günlük yükü bileşenler arasında paylaştırır.

Değişiklik etkinliği¶

Bir değişiklik etkinliğinin kaydedilmesinden sonra tetiklenir.

Depo ekleme sonrası¶

Yeni çeviri eklendikten ve işlendikten hemen sonra tetiklenir.

Depo işleme sonrası¶

Değişiklikler işlendikten hemen sonra tetiklenir.

Depo itme sonrası¶

Depo yukarı akışa itildikten hemen sonra tetiklenir.

Depo güncelleme sonrası¶

Yukarı akış deposundan yeni değişiklikler her çekildiğinde tetiklenir.

Depo işleme öncesi¶

Değişiklikler işlenmeden hemen önce tetiklenir.

Depo itme öncesi¶

Depo yukarı akışa itilmeden hemen önce tetiklenir.

Depo güncelleme öncesi¶

Deponun güncellenmesi denenmeden hemen önce tetiklenir.

Birim kaydetme sonrası¶

Dizgenin kaydedilmesinden hemen sonra tetiklenir.

Birim eşitleme sonrası¶

Dizgenin sürüm denetimi sistemi ile eşitlenmesinden sonra tetiklenir.

Birim oluşturma öncesi¶

Yeni oluşturulan dizge kaydedildikten hemen sonra tetiklenir.

Hazır eklentiler¶

Kendiliğinden çeviri¶

Eklenti kimliği:

weblate.autotranslate.autotranslate

Yapılandırma:

mode

Kendiliğinden çeviri kipi

Kullanılabilecek seçenekler:¶
`suggest`	Öneri olarak ekle
`translate`	Çeviri olarak ekle
`fuzzy`	“Düzenlenmesi gerekli” olarak ekle

q

Sorgu

Lütfen tüm dizgeleri çevirdiğinizde var olan tüm çevirileri yok sayılacağını unutmayın.

auto_source

Kendiliğinden yapılmış çevirilerin kaynağı

Kullanılabilecek seçenekler:¶
`others`	Diğer çeviri bileşenleri
`mt`	Makine çevirisi

component

Bileşen

Kaynak olarak kullanılacak bir bileşenin kısaltmasını yazın. Geçerli projedeki tüm bileşenlerin kullanılması için boş bırakın.

engines

Makine çevirisi hizmetleri

threshold

Skor eşiği

Tetikleyiciler:

Eklenti kurulumu, Bileşen güncellemesi, Günlük, Değişiklik etkinliği

Makine çevirisini ya da diğer bileşenleri kullanarak dizgeleri kendiliğinden çevirir.

Ayrıca bakınız

JavaScript yerelleştirme CDN¶

Added in version 4.2.

Eklenti kimliği:

weblate.cdn.cdnjs

Yapılandırma:

`threshold`	Çeviri eşiği	Çevirinin katılması için ulaşılması gereken çevrilmiş dizge yüzdesi.
`css_selector`	CSS seçici	Yerelleştirilebilir ögeleri algılamak için CSS seçici.
`cookie_name`	Dil tanımlama bilgisinin adı	Dil seçiminin kaydedildiği tanımlama bilgisinin adı.
`files`	Dizgeleri HTML dosyalarından ayıklama	Geçerli depoda ya da uzak adreslerde çevrilebilir dizgeler için işlenecek dosya adlarının listesi.

Tetikleyiciler:

Eklenti kurulumu, Günlük, Depo işleme sonrası, Depo güncelleme sonrası

JavaScript ya da HTML yerelleştirmesinde kullanılmak üzere içerik dağıtım ağına çevirileri yayınlar.

Durağan HTML sayfalarını yerelleştirmek veya JavaScript kodunda yerelleştirmeyi yüklemek için kullanılabilir.

Bileşeniniz için, bunları yerelleştirmek amacıyla HTML sayfalarına ekleyebileceğiniz benzersiz bir adres oluşturur. Ayrıntılı bilgi almak için: Weblate içerik aktarım ağını kullanarak HTML ve JavaScript çevirmek.

Not

Bu eklenti için, Weblate sunucusunda ek yapılandırma gerekir. LOCALIZE_CDN_PATH, oluşturulan dosyaların nereye yazılacağını (bir dosya sisteminde) ayarlar ve LOCALIZE_CDN_URL, bunların nereden sunulacağını (adres) belirler. Dosyalar Weblate tarafından sunulmaz ve dışarıdan ayarlanması gerekir (genellikle bir CDN içerik dağıtımı ağı hizmeti kullanılarak).

Bu eklenti Hosted Weblate üzerinde yapılandırılmıştır ve dosyaları https://weblate-cdn.com/ adresinden sunar.

Ayrıca bakınız

Boş dizgeleri silme¶

Added in version 4.4.

Eklenti kimliği:: weblate.cleanup.blank
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Eklenti kurulumu, Depo işleme sonrası, Depo güncelleme sonrası

Çeviri dosyalarından çevirisi olmayan dizgeleri kaldırır.

Çeviri dosyalarında boş dizgelerin görünmemesi için bunu kullanın (yerelleştirme kitaplığınızın kaynak dizgeyi kullanmak yerine boş dizgeler görüntülemesi gibi durumlarda).

Ayrıca bakınız

Weblate, çevirilerin yanında çeviri dosyalarını da günceller mi?

Çeviri dosyalarını temizleme¶

Eklenti kimliği:: weblate.cleanup.generic
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Eklenti kurulumu, Depo güncelleme sonrası, Depo işleme öncesi

Tüm çeviri dosyalarını tek dilli temel dosyayla eşleşecek şekilde günceller. Bu işlem çoğu dosya biçiminde temel dosyada artık bulunmayan eski çeviri anahtarlarını kaldırır.

Çeviri dizgelerinin yanı sıra ek içerik barındıran biçimler için (HTML dosyaları, Windows RC dosyaları veya OpenDocument biçimi gibi) bu işlem çeviri dosyasını temel dosyayla eşitler.

Ayrıca bakınız

Weblate, çevirilerin yanında çeviri dosyalarını da günceller mi?

Eksik dilleri ekleme¶

Eklenti kimliği:: weblate.consistency.languages
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Eklenti kurulumu, Günlük, Depo ekleme sonrası

Proje içindeki tüm bileşenler için tutarlı bir dil kümesinin kullanılmasını sağlar.

Not

Diğer projelerden paylaşılan bileşenler bu kapsamda değerlendirilmemiştir.

Eksik diller her 24 saatte bir ve Weblate üzerine yeni diller eklendiğinde denetlenir.

Diğerlerinden farklı olarak, bu eklenti tüm projeyi etkiler.

İpucu

Yeni eklenen dizgeler Kendiliğinden çeviri ile kendiliğinden çevrilir.

Bileşen keşfi¶

Eklenti kimliği:

weblate.discovery.discovery

Yapılandırma:

`match`	Çeviri dosyalarıyla eşleştirilecek kurallı ifade
`file_format`	Dosya biçimi
`name_template`	Bileşen adını özelleştirme
`base_file_template`	Tek dil temel dosya adını tanımlama	İki dilli çeviri dosyaları için boş bırakın.
`new_base_template`	Yeni çeviriler için temel dosyayı tanımlama	Yeni çevirileri oluşturmak için kullanılan dosyanın adı. Gettext için .pot dosyası olarak seçin.
`intermediate_template`	Ara dil dosyası	Ara çeviri dosyasının adı. Çoğu durumda bu dosya geliştiriciler tarafından sunulan bir çeviri dosyasıdır ve gerçek kaynak dizgeler oluşturulurken kullanılır.
`language_regex`	Dil süzgeci	Dosya maskesi taranırken çeviri dosyalarını süzmek için kullanılan kurallı ifade.
`copy_addons`	Ana bileşendeki eklentileri yeni oluşturulanlara kopyalama
`remove`	Var olmayan dosyalar için bileşenleri kaldırma
`confirm`	Yukarıdaki eşleşmelerin doğru göründüğünü onaylıyorum

Tetikleyiciler:

Eklenti kurulumu, Depo güncelleme sonrası

Sürüm denetim sistemindeki dosya değişikliklerine göre proje bileşenlerini kendiliğinden ekler ya da siler.

Eşleştirme, karmaşık yapılandırmayı etkinleştiren kurallı ifadeler kullanılarak yapılır. Ancak bunu yapmak için bazı bilgiler gerekir. Yaygın kullanım örnekleri eklenti yardımı bölümünde bulunabilir.

Çeviri dosyalarını eşleştirmek için kurallı ifadede, bileşen ve dili eşleştirmek için iki adlandırılmış grup bulunmalıdır. Kurallı ifadedeki tüm adlandırılmış gruplar, kalıp alanlarında değişken olarak kullanılabilir.

Django kalıbındaki markup kodlarını tüm dosya adı alanlarında kullanabilirsiniz. Örneğin:

{{ component }}: Bileşenin dosya adıyla eşleşir
{{ component|title }}: İlk harfi büyük bileşenin dosya adıyla eşleşir
{{ path }}: {{ component }}: Kurallı ifadedeki özel grup ile eşleşir

Kaydet üzerine tıkladığınızda, yapılandırmanın gereksinimlerinize uyup uymadığını denetleyebileceğiniz biçimde eşleşen bileşenlerin ön izlemesi sunulur:

{{ originalHierarchy }}: {{ component }}

Eşleşen dosyalar:

parent/module1/submodule/src/main/resources/ApplicationResources_fr.properties
parent/module1/submodule/src/main/resources/ApplicationResource_es.properties
parent/module2/src/main/resources/ApplicationResource_de.properties
parent/module2/src/main/resources/ApplicationResource_ro.properties

İpucu

Bileşen bulma eklentisi İç Weblate adresleri kullanır. Sürüm denetimi sistemi kurulumunu birden çok bileşen arasında paylaşmanın kullanışlı bir yoludur. Bağlı bileşenler, ilgili her bir bileşenin Kaynak kod deposu alanına (İşlemler ↓ Ayarlar ↓ Sürüm denetimi sistemi) weblate://project/main-component doldurularak kurulan ana bileşenin yerel deposunu kullanır. Böylece yapılandırma ve sistem kaynakları açısından da zaman kazanılır.

İpucu

Yeni bileşende Eksik dilleri ekleme ile çevrilebilecek dillerin tam kümesinin bulunduğundan emin olun.

Uyarı

Yeni bir bileşenin keşfedilebilmesi için base_file_template ile eşleşen bir dosya ve match ile eşleşen bir adı olan en az bir dosya içermesi gerekir. Yani, bileşende bir temel dil dosyası ve en az bir var olan çeviri bulunmalıdır. Böyle değilse yok sayılır.

Ayrıca bakınız

Toplu düzenleme¶

Eklenti kimliği:

weblate.flags.bulk

Yapılandırma:

q

Sorgu

state

Ayarlanacak durum

Kullanılabilecek seçenekler:¶
`-1`	Değiştirilmesin
`10`	Düzenlenmesi gerekli
`20`	Çevrilmiş
`30`	Onaylanmış

add_flags

Eklenecek çeviri imleri

remove_flags

Kaldırılacak çeviri imleri

add_labels

Eklenecek etiketler

remove_labels

Kaldırılacak etiketler

Tetikleyiciler:

Eklenti kurulumu, Bileşen güncellemesi

Dizgelerin imlerini, etiketlerini veya durumlarını toplu düzenleyin.

Örnekler:

Yeni dizgeler kendiliğinden etiketlensin¶
Arama sorgusu	`NOT has:label`
Eklenecek etiketler	son

Tüm Uygulama mağazası üst veri dosyaları değişiklik günlüğü dizgelerini salt okunur olarak imleme¶
Arama sorgusu	`language:en AND key:changelogs/`
Eklenecek çeviri imleri	`read-only`

Belirli dizgeleri salt okunur olarak imleme¶
Arama sorgusu	source:r"^\`\`[.a-zA-Z0-9_-]*\`\`$" AND language:en
Eklenecek çeviri imleri	`read-only`

Ayrıca bakınız

Değiştirilmemiş çevirileri “Düzenlenmesi gerekli” olarak imleme¶

Eklenti kimliği:: weblate.flags.same_edit
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Birim oluşturma öncesi

Sürüm denetimi sisteminden yeni bir çevrilebilir dizge içe aktarıldığında ve bir kaynak dizgeyle eşleştiğinde, Weblate üzerinde düzenlenmesi gerekli olarak imlenir. Özellikle çevrilmemiş dizgeler için kaynak dizgeleri içeren dosya biçimleri için kullanışlıdır.

İpucu

Ayrıca, Çeviri imleri için strict-same imini ekleyerek Çeviri değiştirilmemiş kalite denetimini sıkılaştırmak isteyebilirsiniz.

Ayrıca bakınız

Çeviri durumları

Yeni kaynak dizgeleri “Düzenlenmesi gerekli” olarak imleme¶

Eklenti kimliği:: weblate.flags.source_edit
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Birim oluşturma öncesi

Sürüm denetimi sisteminden yeni bir kaynak dizge içe her aktarıldığında, Weblate üzerinde düzenlenmesi gerekli olarak imlenir. Böylece geliştiriciler tarafından yazılan kaynak dizgeleri kolayca süzebilir ve düzenleyebilirsiniz.

Ayrıca bakınız

Çeviri durumları

Yeni çevirileri “Düzenlenmesi gerekli” olarak imleme¶

Eklenti kimliği:: weblate.flags.target_edit
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Birim oluşturma öncesi

Sürüm denetimi sisteminden yeni bir çevrilebilir dizge içeri her aktarıldığında, Weblate üzerinde düzenlenmesi gerekli olarak imlenir. Böylece geliştiricilerin oluşturduğu çevirileri kolayca süzebilir ve düzenleyebilirsiniz.

Ayrıca bakınız

Çeviri durumları

Depodan güncellenmiş çevirileri “Düzenlenmesi gerekli” olarak imle¶

Eklenti kimliği:: weblate.flags.target_repo_update
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Birim eşitleme sonrası

Sürüm denetimi sisteminden bir dizge çevirisi değiştirildiğinde, Weblate üzerinde düzenlenmesi gerekli olarak imlenir. Özellikle çeviri dosyaları sık sık el ile veya bir dış hizmet tarafından güncelleniyorsa kullanışlıdır.

Ayrıca bakınız

Çeviri durumları

Salt okunur dizgeleri kaynak ile doldurma¶

Added in version 4.18.

Eklenti kimliği:: weblate.generate.fill_read_only
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Eklenti kurulumu, Bileşen güncellemesi, Günlük

Salt okunur dizgelerin çevirilerini kaynak dizgeler ile doldurur.

İstatistik oluşturma¶

Eklenti kimliği:

weblate.generate.generate

Yapılandırma:

`filename`	Oluşturulacak dosyanın adı
`template`	Oluşturulacak dosyanın içeriği

Tetikleyiciler:

Depo işleme öncesi

Çeviri durumu ile ilgili ayrıntılı bilgiler içeren bir dosya oluşturur.

Hem dosya adında hem de içerikte bir Django kalıbı kullanabilirsiniz. Markup ile ilgili ayrıntılı bilgi almak için Kalıp kodlaması bölümüne bakabilirsiniz.

Örneğin, her çeviri için bir özet dosyası oluşturma:

Oluşturulacak dosyanın adı

locale/{{ language_code }}.json

İçerik

{
   "language": "{{ language_code }}",
   "strings": "{{ stats.all }}",
   "translated": "{{ stats.translated }}",
   "last_changed": "{{ stats.last_changed }}",
   "last_author": "{{ stats.last_author }}",
}

Ayrıca bakınız

Kalıp kodlaması

Çeviriyi kaynak dizgeyle önceden doldurma¶

Added in version 4.11.

Eklenti kimliği:: weblate.generate.prefill
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Eklenti kurulumu, Bileşen güncellemesi, Günlük

Çeviri dizgelerini kaynak dizgeler ile doldurur.

Bileşendeki tüm çevrilmemiş dizgeler kaynak dizgeyle doldurulur ve düzenlenmesi gerekli olarak imlenir. Çeviri dosyalarında boş dizge kabul edilmediğinde bunu kullanın.

Sözde yerel oluşturma¶

Added in version 4.5.

Eklenti kimliği:

weblate.generate.pseudolocale

Yapılandırma:

`source`	Kaynak dizgeler
`target`	Hedef çeviri	Bu çevirideki tüm dizgelerin üzerine yazılacak
`prefix`	Başa eklenmiş sabit yazı
`var_prefix`	Başa eklenmiş değişken yazı
`suffix`	Sona eklenmiş sabit yazı
`var_suffix`	Sona eklenmiş değişken yazı
`var_multiplier`	Değişken yazı çarpanı	Kaynak dizgenin uzunluğuna bağlı olarak değişken yazının kaç kez yineleneceği.
`include_readonly`	Salt okunur dizgeleri katma

Tetikleyiciler:

Eklenti kurulumu, Bileşen güncellemesi, Günlük

Kaynak dizgelere kendiliğinden ön ek ve son ek ekleyerek çeviri oluşturur.

Sözde yereller, yerelleştirme için hazırlanmamış dizgeleri bulmaya yarar. Böylece, uygulamayı sözde yerel dilde çalıştırırken değiştirilmemiş dizgelerin bulunmasını kolaylaştırmak için tüm çevrilebilir kaynak dizgeleri değiştirilir.

Yerelleştirilmiş karşılıkları yerleşime uymayabilecek dizgeler de bulunabilir.

Değişken bölümlerin kullanılması, yerelleştirmeden sonra kullanıcı arabirimine sığmayabilecek dizgelerin bulunmasını sağlar. İçerik kaynak dizge uzunluğuna göre genişletilir. Değişken yazılar, içeriğin uzunluğunun çarpanla çarpılmasıyla yinelenir. Örneğin, Merhaba dünya ve _ değişken yazısı ile değişken çarpanı 1 olduğunda Merhaba dünya___________ olur. Yazı kaynak dizgedeki her karakter için bir kez yinelenir.

Dizgeler şu model kullanılarak oluşturulacak:

Başa eklenmiş sabit yazı Başa eklenmiş değişken yazı Kaynak dizge Sona eklenmiş değişken yazı Sona eklenmiş sabit yazı

İpucu

Deneme için gerçek dilleri kullanabilirsiniz. Bunun yanında Weblate üzerinde en_XA ve ar_XB gibi bu iş için ayrılmış sahte ayarlar vardır.

İpucu

Bu eklentiyi, var olan bir dilin ya da benzer bir dilin yeni bir yerel ayarına çeviri başlatmak için kullanabilirsiniz. Çeviriyi bileşene ekledikten sonra, eklentiyi izleyin. Örnek: fr diliniz varsa ve fr_CA çevirisini başlatmak istiyorsanız, kaynak olarak fr, hedef olarak fr_CA ayarlayın ve ön ek ile son eki boş bırakın.

Kopyalamadan sonra yapılan çevirilerin Weblate tarafından değiştirilmesini önlemek için yeni çeviriyi doldurduktan sonra eklentiyi kaldırın.

Katılımcıları yorum bölümünde görüntüleme¶

Eklenti kimliği:: weblate.gettext.authors
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Depo işleme öncesi

PO dosyası üst bilgilerinin yorum bölümü, katılımcı adlarını ve katkı yıllarını içerecek biçimde güncellenir.

PO dosya üst bilgileri şöyle görünür:

# Michal Čihař <michal@weblate.org>, 2012, 2018, 2019, 2020.
# Pavel Borecki <pavel@example.com>, 2018, 2019.
# Filip Hron <filip@example.com>, 2018, 2019.
# anonymous <noreply@weblate.org>, 2019.

“configure” dosyasındaki ALL_LINGUAS değişkeni güncelleme¶

Eklenti kimliği:: weblate.gettext.configure
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Eklenti kurulumu, Günlük, Depo ekleme sonrası

Yeni bir çeviri eklendiğinde configure, configure.in ya da herhangi bir configure.ac dosyasında ALL_LINGUAS değişkeni güncellenir.

Gettext çıktısını özelleştirme¶

Removed in version 5.13: Dosya biçimi parametreleri ile değiştirildi.

LINGUAS dosyasını güncelleme¶

Eklenti kimliği:: weblate.gettext.linguas
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Eklenti kurulumu, Günlük, Depo ekleme sonrası

Yeni bir çeviri eklendiğinde LINGUAS dosyası güncellenir.

MO dosyaları üretme¶

Eklenti kimliği:

weblate.gettext.mo

Yapılandırma:

`path`	Oluşturulan MO dosyasının yolu	Belirtilmemişse, PO dosyasının konumu kullanılır.
`fuzzy`	Düzenlenmesi gereken dizgeler katılsın	Düzenlenmesi gereken (belirsiz) dizgeler genellikle çeviri olarak kullanılmaya hazır değildir.

Tetikleyiciler:

Depo işleme öncesi

PO dosyası her değiştirildiğinde MO dosyası kendiliğinden oluşturulur.

Oluşturulan MO dosyasının konumu özelleştirilebilir ve bunun için Kalıp kodlaması alanı kullanılır.

Not

Bir çeviri silinirse, PO dosyası depodan silinir, ancak bu eklenti tarafından oluşturulmuş MO dosyası silinmez. MO dosyası yukarı akıştan el ile kaldırılmalıdır.

PO dosyalarını POT ile eşleştirerek güncelleme (msgmerge)¶

5.13 sürümünde değişti: Ayarlar yapılandırması Dosya biçimi parametreleri konumuna taşındı.

Eklenti kimliği:: weblate.gettext.msgmerge
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Eklenti kurulumu, Depo güncelleme sonrası

Tüm PO dosyalarını (Dosya maskesi ile yapılandırıldığı gibi) msgmerge komutunu kullanarak POT dosyasıyla eşleşecek şekilde (Yeni çeviriler kalıbı ile yapılandırıldığı gibi) günceller.

Bu eklenti, POT (kalıb) dosyasının yeni dizgelerle ya da var olan dizgelerdeki değişikliklerle güncellendiği gettext PO dosyalarıyla çalışırken çok önemlidir. POT dosyası depoda güncellendiğinde, bu eklenti bu değişiklikleri otomatik olarak tüm dil PO dosyalarıyla birleştirerek şunları sağlar:

Yeni çevrilebilir dizgeler tüm dillerde görüntülenir
Kaldırılmış dizgeler kullanılmıyor olarak işaretlenir
Değiştirilmiş dizgeler gözden geçirilmesi gerekli olarak işaretlenir (bulanık)

Çoğu msgmerge komut satırı seçeneği dosya biçimi parametreleri yapılandırması ile ayarlanabilir.

Ayrıca bakınız

Git işlemelerini bir araya toplar¶

Eklenti kimliği:

weblate.git.squash

Yapılandırma:

squash

İşlemeleri bir araya toplama

Kullanılabilecek seçenekler:¶
`all`	Tüm işlemeler bir arada
`language`	Dile göre
`file`	Dosyaya göre
`author`	Katkıda bulunana göre

append_trailers

Bir araya toplanmış işlemelerin iletisine art bilgiler eklensin

‘Co-authored-by: …’ gibi bir işleme iletisinin başka bir serbest biçim bölümünün sonunda, art bilgi satırları RFC 822 e-posta üst bilgilerine benzeyen satırlardır.

commit_message

İşleme iletisi

Bu işleme iletisi, bir araya toplanmış işleme iletilerinden gelen birleşik işleme iletileri yerine kullanılır.

Tetikleyiciler:

Eklenti kurulumu, Depo işleme sonrası

Değişiklikleri yollamadan önce Git işlemelerini bir araya toplar.

İpucu

Gereksiz çakışmaları önlemek için, yukarı akış değişikliklerinin internet kancaları veya API ile kendiliğinden alınacak şekilde yapılandırmanız önerilir. Ayrıntılı bilgi almak için: Depoları güncellemek.

Git işlemeleri, değişiklikler itilmeden önce aşağıdaki kiplerden biri kullanılarak bir araya toplanabilir:

Tüm işlemeler bir arada
Dile göre
Dosyaya göre
Katkıda bulunana göre

Özgün işleme iletileri korunur. Ancak Katkıda bulunana göre olarak seçilmediği ya da işleme iletisi eklenecek şekilde özelleştirilmediği sürece katkıda bulunan bilgisi eksik kalır.

Özgün işleme iletileri, isteğe bağlı olarak özel bir işleme iletisiyle değiştirilebilir.

Art bilgiler (Co-authored-by: … gibi işleme satırları) isteğe bağlı olarak özgün işleme iletilerinden kaldırılabilir ve bir araya toplanmış işleme iletisinin sonuna eklenebilir. Bu aynı zamanda her çevirmen için özel bir Co-authored-by: bilgisi oluşturur.

JSON çıktısını özelleştirme¶

5.12 sürümünde değişti: Ayraçlardan sonra boşluk bırakılmasın seçeneği eklendi.

Removed in version 5.13: Dosya biçimi parametreleri ile değiştirildi.

Java özellikleri dosyasını biçimlendirme¶

Eklenti kimliği:

weblate.properties.sort

Yapılandırma:

case_sensitive

Büyük/küçük harfe duyarlı anahtar sıralaması kullanılsın

Tetikleyiciler:

Depo işleme öncesi

Java özellikleri dosyasını biçimlendirir ve sıralar.

Yeni satır karakterlerini Unix karakterleri olarak değiştirir.
Unicode kaçınma dizilerini büyük harfle biçimlendirir (varsa).
Boş satırları ve yorumları siler.
Dizgeleri anahtarlara göre sıralar.
Yinelenen dizgeleri kaldırır.

Eski yorumları kaldırma¶

Eklenti kimliği:

weblate.removal.comments

Yapılandırma:

age

Tutulacak gün sayısı

Tetikleyiciler:

Eklenti kurulumu, Günlük

Yorumların kaldırılması için bir zaman dilimi ayarlayabilirsiniz.

Bu özellik, güncelliğini yitirmiş olabilecek eski yorumları kaldırmak için yararlı olabilir. Bir yorumun eski olması önemini yitirdiği anlamına gelmediğinden dikkatli kullanın.

Eski önerileri kaldırma¶

Eklenti kimliği:

weblate.removal.suggestions

Yapılandırma:

`age`	Tutulacak gün sayısı
`votes`	Oy verme eşiği	Kaldırma eşiği. Oylama kapalıyken bu alanın herhangi bir etkisi yoktur.

Tetikleyiciler:

Eklenti kurulumu, Günlük

Önerilerin kaldırılması için bir zaman dilimi ayarlayabilirsiniz.

Belirli bir zaman diliminde yeterince olumlu oy almayan önerilerin kaldırılması için öneri oylamayla (ayrıntılı bilgi almak için: Akran değerlendirmesi) bağlantılı olarak çok yararlı olabilir.

RESX dosyalarını güncelleme¶

Eklenti kimliği:: weblate.resx.update
Yapılandırma:: Bu eklentinin yapılandırması yok.
Tetikleyiciler:: Eklenti kurulumu, Depo güncelleme sonrası

Tüm çeviri dosyalarını tek dilli temel dosya ile eşleşecek biçimde günceller. Kullanılmayan dizgeler kaldırılır ve yeni dizgeler kaynak dizgenin kopyaları olarak eklenir.

İpucu

Yalnızca eski çeviri anahtarlarını kaldırmak istiyorsanız Çeviri dosyalarını temizleme kullanın.

Ayrıca bakınız

Weblate, çevirilerin yanında çeviri dosyalarını da günceller mi?

Slack internet kancaları¶

Added in version 5.12.

Eklenti kimliği:

weblate.webhook.slack

Yapılandırma:

webhook_url

İnternet kancası adresi

events

Değişiklik etkinlikleri

Kullanılabilecek seçenekler:¶
`0`	Kaynak güncellendi
`1`	Çeviri tamamlandı
`2`	Çeviri değiştirildi
`3`	Yorum eklendi
`4`	Öneri eklendi
`5`	Çeviri eklendi
`6`	Kendiliğinden çevrildi
`7`	Öneri kabul edildi
`8`	Çeviri geri alındı
`9`	Çeviri yüklendi
`13`	Kaynak dizge eklendi
`14`	Bileşen kilitlendi
`15`	Bileşenin kilidi açıldı
`17`	Değişiklikler işlendi
`18`	Değişiklikler itildi
`19`	Depo sıfırlandı
`20`	Depo birleştirildi
`21`	Depo yeniden yerleştirildi
`22`	Depo birleştirilemedi
`23`	Depo yeniden yerleştirilemedi
`24`	İşlenemedi
`25`	Çeviri silindi
`26`	Öneri silindi
`27`	Çeviri değiştirildi
`28`	Depo itilemedi
`29`	Öneri temizleme sırasında silindi
`30`	Kaynak dizge değiştirildi
`31`	Dizge eklendi
`32`	Durum toplu olarak değiştirildi
`33`	Görünürlük değiştirildi
`34`	Kullanıcı eklendi
`35`	Kullanıcı silindi
`36`	Çeviri onaylandı
`37`	Düzenlenmek üzere imlendi
`38`	Bileşen silindi
`39`	Proje silindi
`41`	Proje yeniden adlandırıldı
`42`	Bileşen yeniden adlandırıldı
`43`	Bileşen taşındı
`45`	Katkıda bulunan katıldı
`46`	Duyuru gönderildi
`47`	Uyarı tetiklendi
`48`	Dil eklendi
`49`	Dil istendi
`50`	Proje oluşturuldu
`51`	Bileşen oluşturuldu
`52`	Kullanıcı çağrıldı
`53`	Depo bildirimi alındı
`54`	Çeviri dosya yüklemesi ile değiştirildi
`55`	Lisans değiştirildi
`56`	Katılımcı lisans anlaşması değiştirildi
`57`	Ekran görüntüsü eklendi
`58`	Ekran görüntüsü yüklendi
`59`	Depodaki dizge değiştirildi
`60`	Eklenti kuruldu
`61`	Eklenti yapılandırması değiştirildi
`62`	Eklenti kaldırıldı
`63`	Dizge kaldırıldı
`64`	Yorum silindi
`65`	Yorum çözümlendi
`66`	Açıklama güncellendi
`67`	Kategori silindi
`68`	Kategori yeniden adlandırıldı
`69`	Kategori taşındı
`70`	Dizge kaydedilemedi
`71`	Depoya dizge eklendi
`72`	Yüklemedeki dizge güncellendi
`73`	Yüklemeye dizge eklendi
`74`	Çeviri kaynak yüklemesi ile değiştirildi
`75`	Bileşen çevirisi tamamlandı
`76`	Zorunlu denetim uygulandı
`77`	Değişiklik yayıldı
`78`	Dosya yüklendi
`79`	Ek imler güncellendi
`80`	Yazı tipi yüklendi
`81`	Yazı tipi değiştirildi
`82`	Yazı tipi silindi
`83`	Çevirilerin eşitlenmesi dayatıldı
`84`	Çevirilerin yeniden taranması dayatıldı

Tetikleyiciler:

Değişiklik etkinliği

Seçilmiş etkinliklere göre bir Slack kanalına bildirim gönderir.

Uyarı

Bildirim içeriğinde HTML kod imleri görüntülenebilir. Bu durum, bilinen ve yakında ele alınacak olan bir sorundur. Ayrıntılı bilgi almak için: https://github.com/WeblateOrg/weblate/issues/15056.

İpucu

Bir internet kancası adresi edinmek için, Slack gelen internet kancaları belgesi içinde anlatılan adımları izleyin

İnternet kancası¶

Added in version 5.11.

Eklenti kimliği:

weblate.webhook.webhook

Yapılandırma:

webhook_url

İnternet kancası adresi

secret

Parola

Base64 ile kodlanmış bir dizge

events

Değişiklik etkinlikleri

Kullanılabilecek seçenekler:¶
`0`	Kaynak güncellendi
`1`	Çeviri tamamlandı
`2`	Çeviri değiştirildi
`3`	Yorum eklendi
`4`	Öneri eklendi
`5`	Çeviri eklendi
`6`	Kendiliğinden çevrildi
`7`	Öneri kabul edildi
`8`	Çeviri geri alındı
`9`	Çeviri yüklendi
`13`	Kaynak dizge eklendi
`14`	Bileşen kilitlendi
`15`	Bileşenin kilidi açıldı
`17`	Değişiklikler işlendi
`18`	Değişiklikler itildi
`19`	Depo sıfırlandı
`20`	Depo birleştirildi
`21`	Depo yeniden yerleştirildi
`22`	Depo birleştirilemedi
`23`	Depo yeniden yerleştirilemedi
`24`	İşlenemedi
`25`	Çeviri silindi
`26`	Öneri silindi
`27`	Çeviri değiştirildi
`28`	Depo itilemedi
`29`	Öneri temizleme sırasında silindi
`30`	Kaynak dizge değiştirildi
`31`	Dizge eklendi
`32`	Durum toplu olarak değiştirildi
`33`	Görünürlük değiştirildi
`34`	Kullanıcı eklendi
`35`	Kullanıcı silindi
`36`	Çeviri onaylandı
`37`	Düzenlenmek üzere imlendi
`38`	Bileşen silindi
`39`	Proje silindi
`41`	Proje yeniden adlandırıldı
`42`	Bileşen yeniden adlandırıldı
`43`	Bileşen taşındı
`45`	Katkıda bulunan katıldı
`46`	Duyuru gönderildi
`47`	Uyarı tetiklendi
`48`	Dil eklendi
`49`	Dil istendi
`50`	Proje oluşturuldu
`51`	Bileşen oluşturuldu
`52`	Kullanıcı çağrıldı
`53`	Depo bildirimi alındı
`54`	Çeviri dosya yüklemesi ile değiştirildi
`55`	Lisans değiştirildi
`56`	Katılımcı lisans anlaşması değiştirildi
`57`	Ekran görüntüsü eklendi
`58`	Ekran görüntüsü yüklendi
`59`	Depodaki dizge değiştirildi
`60`	Eklenti kuruldu
`61`	Eklenti yapılandırması değiştirildi
`62`	Eklenti kaldırıldı
`63`	Dizge kaldırıldı
`64`	Yorum silindi
`65`	Yorum çözümlendi
`66`	Açıklama güncellendi
`67`	Kategori silindi
`68`	Kategori yeniden adlandırıldı
`69`	Kategori taşındı
`70`	Dizge kaydedilemedi
`71`	Depoya dizge eklendi
`72`	Yüklemedeki dizge güncellendi
`73`	Yüklemeye dizge eklendi
`74`	Çeviri kaynak yüklemesi ile değiştirildi
`75`	Bileşen çevirisi tamamlandı
`76`	Zorunlu denetim uygulandı
`77`	Değişiklik yayıldı
`78`	Dosya yüklendi
`79`	Ek imler güncellendi
`80`	Yazı tipi yüklendi
`81`	Yazı tipi değiştirildi
`82`	Yazı tipi silindi
`83`	Çevirilerin eşitlenmesi dayatıldı
`84`	Çevirilerin yeniden taranması dayatıldı

Tetikleyiciler:

Değişiklik etkinliği

Standart Webhooks teknik özelliklerine uygun olarak, seçilmiş etkinliklere göre dış hizmetlere bildirim gönderir.

İstek yükü Weblate Messaging şeması ile uyumludur. OpenAPI açıklaması /api/docs/ adresinde de bulunabilir. Örnek istek gövdesi:

{
   "change_id": 99,
   "action": "Translation changed",
   "timestamp": "2019-08-24T14:15:22Z",
   "target": "Nazdar svete!",
   "old": "Nazdar!",
   "source": "Hello, world",
   "url": "/translate/project-slug/component-slug/cs/?checksum=46add148a53cab6f",
   "author": "author-username",
   "user": "user-username",
   "project": "project-slug",
   "component": "component-slug",
   "translation": "cs"
}

Kategoriler ile örnek istek gövdesi:

{
   "change_id": 8910,
   "action": "Component renamed",
   "timestamp": "2025-06-11T07:15:09Z",
   "target": ["new-name"],
   "old": ["component-slug"],
   "url": "/projects/project-slug/parent-category/child-category/sub-category/component-slug/",
   "user": "testuser",
   "project": "project-slug",
   "component": "component-slug",
   "category": [
      "sub-category",
      "child-category",
      "parent-category"
   ]
}

Örnek istek üst bilgileri:

{
   "webhook-id": "7f1c5477f6275a69af7b83236c20cb1a",
   "webhook-timestamp": "1748505623.044281",
   "webhook-signature": "v1,Ceo5qEr07ixe2NLpvHk3FH9bwy/WavXrAFQ/9tdO6mc="
}

Webhook-signature, secret dizgesi, istek yükü, webhook-timestamp ve webhook-id kullanılarak oluşturulan HMAC imzalarının boşluklarla ayrılmış bir listesidir. Bu imza internet kancası isteğinin gerçekliğini ve bütünlüğünü doğrular.

Bir isteği doğrulamak için standardwebhooks kitaplığındaki Webhook.verify yöntemini veya “Standart Webhooks teknik özelliklerinin” bir uygulamasını kullanabilirsiniz.

Ayrıca bakınız

XML çıktısını özelleştirme¶

Added in version 4.15.

Removed in version 5.13: Dosya biçimi parametreleri ile değiştirildi.

YAML çıktısını özelleştirme¶

Removed in version 5.13: Dosya biçimi parametreleri ile değiştirildi.

Eklenti listesini özelleştirme¶

Eklenti listesi WEBLATE_ADDONS tarafından yapılandırılır. Başka bir eklenti eklemek için, bu seçeneğe mutlak sınıf adını eklemeniz yeterlidir.

Eklenti yazma¶

Kendi eklentilerinizi de yazabilir, eklenti üst verilerini tanımlamak için weblate.addons.base.BaseAddon alt sınıfını oluşturabilir ve ardından işlemi yapmak için bir geri çağırma ekleyebilirsiniz.

Ayrıca bakınız

Eklentileri geliştirmek

Eklentiden betikleri çalıştırma¶

Eklentiler, dış betikleri yürütmek için de kullanılabilir. Bu özellik eskiden Weblate ile bütünleşikti. Ancak şimdi betikleri bir eklenti ile sarmalamak için bazı kodlar yazmanız gerekiyor.

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

"""Example pre commit script."""

from __future__ import annotations

from typing import ClassVar

from django.utils.translation import gettext_lazy

from weblate.addons.events import AddonEvent
from weblate.addons.scripts import BaseScriptAddon


class ExamplePreAddon(BaseScriptAddon):
    # Event used to trigger the script
    events: ClassVar[set[AddonEvent]] = {
        AddonEvent.EVENT_PRE_COMMIT,
    }
    # Name of the addon, has to be unique
    name = "weblate.example.pre"
    # Verbose name and long description
    verbose = gettext_lazy("Execute script before commit")
    description = gettext_lazy("This add-on executes a script.")

    # Script to execute
    script = "/bin/true"
    # File to add in commit (for pre commit event)
    # does not have to be set
    add_file = "po/{{ language_code }}.po"

Kurulum ile ilgili ayrıntılı bilgi almak için: Özel kalite denetimleri, eklentiler, kendiliğinden öneriler ve kendiliğinden düzeltmeler.

Betik dosyası, belirtilen bileşen için sürüm denetimi sistemi deposunun kök klasörüne ayarlanmış geçerli klasör ile yürütülür.

Ek olarak, şu ortam değişkenleri kullanılabilir:

WL_VCS¶: Kullanılan sürüm denetimi sistemi.

WL_REPO¶: Yukarı akış deposu adresi.

WL_PATH¶: Sürüm denetimi sistemi deposunun mutlak yolu.

WL_BRANCH¶: Geçerli bileşende yapılandırılmış depo dalı.

WL_FILEMASK¶: Geçerli bileşen için dosya maskesi.

WL_TEMPLATE¶: Tek dilli çeviriler için kalıbın dosya adı (boş olabilir).

WL_NEW_BASE¶: Yeni çeviriler oluşturmak için kullanılan dosyanın adı (boş olabilir).

WL_FILE_FORMAT¶: Geçerli bileşende kullanılan dosya biçimi.

WL_LANGUAGE¶: İşlenmekte olan çevirinin dili (bileşen düzeyinde kancalar için kullanılamaz).

WL_PREVIOUS_HEAD¶: Güncellemeden sonra önceki HEAD (yalnızca güncelleme sonrası kancası çalıştırıldıktan sonra kullanılabilir).

WL_COMPONENT_SLUG¶: Adresi oluşturmak için kullanılan bileşen kısaltması.

WL_PROJECT_SLUG¶: Adresi oluşturmak için kullanılan proje kısaltması.

WL_COMPONENT_NAME¶: Bileşen adı.

WL_PROJECT_NAME¶: Proje adı.

WL_COMPONENT_URL¶: Bileşen adresi.

WL_ENGAGE_URL¶: Proje etkileşim sayfası adresi.

Ayrıca bakınız

Bileşen yapılandırması

Güncelleme sonrası depo işleme¶

Sürüm denetimi sistemi yukarı akış kaynağı değiştiğinde çeviri dosyalarını güncellemek için kullanılabilir. Bunu yapabilmek için lütfen Weblate tarafından yalnızca sürüm denetimi sistemine işlenmiş dosyaların görüldüğünü, bu nedenle değişiklikleri betiğin bir parçası olarak yapmanız gerektiğini unutmayın.

Örneğin Gulp ile bunu şu kodu kullanarak yapabilirsiniz:

#! /bin/sh
gulp --gulpfile gulp-i18n-extract.js
git commit -m 'Update source strings' src/languages/en.lang.json

Depoya işlenmeden önce çevirilerin işlenmesi¶

Bir çevirinin depoya kaydedilmesinden önce kendiliğinden değiştirilmesi için işleme betiğini kullanın.

Geçerli bir çevirinin dosya adından oluşan tek bir parametre olarak aktarılır.

Eklenti işlemleri günlüklerinin kaydedilmesi¶

Eklenti işlem günlüğü, eklentinin çalışmasını izler ve eklenti işlemlerini izlemek için kullanılabilir.

ADDON_ACTIVITY_LOG_EXPIRY seçeneği yapılandırılarak belirli bir zamandan önceki günlük kayıtları kaldırılabilir.