Denetimler ve düzeltmeler

Özel kendiliğinden düzeltmeler

Standart olanların yanında özel kendiliğinden düzeltmeleri de uygulayabilir ve bunları AUTOFIX_LIST içine ekleyebilirsiniz.

Kendiliğinden düzeltmeler güçlüdür ancak bozulmaya da neden olabilir. Bunları yazarken dikkatli olun.

Örneğin, şu kendiliğinden düzeltme, bir çevirideki foo dizgesinin her kopyasını bar ile değiştirir:

from weblate.trans.autofixes.base import AutoFix


class ReplaceFooWithBar(AutoFix):
    """Replace foo with bar."""

    # Might be localized using gettext_lazy
    name = "Foobar"

    def fix_single_target(self, target, source, unit):
        if "foo" in target:
            return target.replace("foo", "bar"), True
        return target, False

Özel denetimler kurmak için, AUTOFIX_LIST içinde Python sınıfının tam yolunu belirtin. Ayrıntılı bilgi almak için: Özel kalite denetimleri, eklentiler, kendiliğinden öneriler ve kendiliğinden düzeltmeler.

Parametreleri kullanarak davranışı özelleştirmek

İmleri kullanarak Weblate davranışında ince ayarlar yapabilirsiniz. İmler çevirmenlere görsel bildirim sağlayarak çeviriyi iyileştirmelerine yardımcı olur. Yer imleri şu kaynaklardan aktarılabilir:

• Kaynak dizge ek imleri:

  • Kaynak dizgeler ile ilgili ek bilgiler manuel düzenlemeyi tanımlar.

  • Toplu düzenleme imleri toplu olarak uygulamak için kullanılabilir.

  • Toplu düzenleme eklentisi imleri otomatik olarak uygulayabilir.

• Dosya biçiminden ayıklanan her dizgenin yer imleri. Ayrıntılı bilgi almak için: Yerelleştirme dosyası biçimleri.

• Çeviri imleri (şu anda yalnızca iki dilli kaynak dizge için ya da tek dilli kalıp düzenlemesi kapatılmışken salt okunur yer imi).

• Dosya biçimine özel yer imleri.

• Bileşen yapılandırması (Çeviri imleri).

• Proje yapılandırması (Çeviri imleri).

İmler virgül ile ayrılır. Parametreleri varsa iki nokta üst üste ile ayrılır. Dizgeye boşluk veya özel karakterler eklemek için tırnak işaretleri kullanabilirsiniz. Örneğin:

placeholders:"special:value":"other value", regex:.*

Hem tek hem de çift tırnak işaretleri kabul edilir. Ters bölü kullanılarak özel karakterlerden kaçınılır:

placeholders:"quoted \"string\"":'single \'quoted\''

placeholders:r"^#*"

Çevirmenlerin bir Markdown belgesinin başlığını değiştirmediğini doğrular: ### Index dizgesi # Indice olarak çevrilirse denetim başarısız olur.

placeholders:r"\]\([^h].*?\)"

İç bağlantıların çevrilmediğinden emin olur (örneğin [test](../checks), [test](../denetimler) olarak çevrilmez.

Daha yüksek bir düzeyde tanımlanan imler discard:NAME sözdizimi kullanılarak atılabilir. Örneğin, bir bileşen safe-html olarak yapılandırılmışsa, bu belirli dizge için atlanması için dizge imlerine discard:safe-html ekleyebilirsiniz.

Kullanılabilecek imlerin listesi şu şekildedir:

read-only

Dizgenin salt okunur olduğunu ve Weblate üzerinde düzenlenemeyeceğini belirler. Ayrıntılı bilgi almak için: Salt okunur dizgeler.

terminology

Sözlük içinde kullanılır. Dizgeyi tüm sözlük dillerine kopyalar. Böylece dizge tüm çevirilerde tutarlı bir şekilde kullanılabilir. Ayrıca, örneğin ürün adlarında read-only ile birlikte kullanışlıdır.

priority:N

Dizgenin önceliğini belirler. Yüksek öncelikli dizgeler daha çevrilir. Varsayılan öncelik değeri: 100. Bir dizgenin önceliği ne kadar yüksekse, o kadar önce çevrilmek üzere sunulur.

max-length:N

Bir dizgenin en fazla uzunluğunu N karakter olarak sınırlandırır. Ayrıntılı bilgi almak için: Çevirinin en fazla uzunluğu.

xml-text

Metnin XML belgesi olarak işlenmesini sağlar. XML söz dizimi ve XML kodlaması parametrelerini etkiler.

font-family:NAME

Görselleştirme denetimleri için yazı tipi ailesini belirler. Ayrıntılı bilgi almak için: Yazı tiplerini yönetmek.

font-weight:WEIGHT

Görselleştirme denetimleri için yazı koyuluğunu belirler. Ayrıntılı bilgi almak için: Yazı tiplerini yönetmek.

font-size:SIZE

Görselleştirme denetimleri için yazı boyutunu belirler. Ayrıntılı bilgi almak için: Yazı tiplerini yönetmek.

font-spacing:SPACING

Görselleştirme denetimleri için harf aralığını belirler. Ayrıntılı bilgi almak için: Yazı tiplerini yönetmek.

icu-flags:FLAGS

ICU MessageFormat kalite denetiminin davranışını özelleştirecek imleri belirler.

icu-tag-prefix:PREFIX

ICU MessageFormat kalite denetimi için XML kod imlerinin gerekli olan ön ekini belirler.

placeholders:NAME:NAME2:...

Çeviride beklenen yer belirtici dizgeleri belirler. Ayrıntılı bilgi almak için: Yer belirticiler.

replacements:FROM:TO:FROM2:TO2...

Ortaya çıkan metin parametreleri denetlenirken yapılacak değişiklikleri belirler (Çevirinin en fazla uzunluğu ya da Çevirinin en fazla uzunluğu gibi). Tipik kullanım örneği, metnin uzun değerlerle bile sığdığından emin olmak için yerleştirilebilir ögelerin genişletilmesidir. Örnek: replacements:%s:"Ali Kaya".

variants:SOURCE

Bu dizgenin, eşleşen kaynağın bir dizge çeşidi olarak imlenmesini sağlar. Ayrıntılı bilgi almak için: Dizge çeşitleri.

regex:REGEX

Çevirilerin eşleştirileceği kurallı ifadeyi belirtir. Ayrıntılı bilgi almak için: Kurallı ifade.

discard:NAME

Daha yüksek bir düzeyde tanımlanan imi yok sayar.

forbidden

Bir sözlükte yasaklanmış bir çeviriyi belirtir. Ayrıntılı bilgi almak için: Yasaklı çeviriler.

strict-same

Çeviri değiştirilmemiş kalite denetiminin iç kara listedeki sözcükleri engellemesini sağlar.

strict-format

Tek değerli çoğul biçimler için bile biçim denetimlerinde biçim kullanımının dayatılmasını sağlar. Ayrıntılı bilgi almak için: Biçimlendirilmiş dizgeler.

case-insensitive

Denetim davranışını büyük/küçük harfe duyarlı olmayacak şekilde ayarlar. Şu anda yalnızca Yer belirticiler kalite denetimini etkiler.

bbcode-text

Bir yazının Bulletin Board Code (BBCode) belgesi olarak işlenmesini sağlar. Çeviri değiştirilmemiş denetimini etkiler. BBCode kodlaması kalite denetimini kullanıma alır.

check-glossary

Sözlük ile uyumlu değil kalite denetimini kullanıma alır.

fluent-parts

Fluent bölümleri kalite denetimini kullanıma alır.

fluent-references

Fluent başvuruları kalite denetimini kullanıma alır.

fluent-target-inner-html

Fluent çevirisinin iç HTML kodu kalite denetimini kullanıma alır.

fluent-target-syntax

Fluent çevirisi söz dizimi kalite denetimini kullanıma alır..

angularjs-format

AngularJS araya ekleme dizgesi kalite denetimini kullanıma alır.

automattic-components-format

Automattic bileşenleri biçimlendirmesi kalite denetimini kullanıma alır.

c-format

C biçimi kalite denetimini kullanıma alır.

c-sharp-format

C# biçimi kalite denetimini kullanıma alır.

csharp-format

C# biçimi kalite denetimini kullanıma alır.

es-format

ECMAScript kalıbı sabitleri kalite denetimini kullanıma alır.

i18next-interpolation

i18next araya ekleme kalite denetimini kullanıma alır.

icu-message-format

ICU MessageFormat ve ICU MessageFormat söz dizimi kalite denetimlerini kullanıma alır.

java-printf-format

Java biçimi kalite denetimini kullanıma alır.

java-format

Java MessageFormat kalite denetimini kullanıma alır.

auto-java-messageformat

Bir yazıyı koşullu Java MessageFormat olarak işler. Yalnızca kaynakta Java MessageFormat yer belirticileri bulunduğunda Java MessageFormat kalite denetimini kullanıma alın. Java MessageFormat kalite denetimini kullanıma alır.

javascript-format

JavaScript biçimi kalite denetimini kullanıma alır.

laravel-format

Laravel biçimi kalite denetimini kullanıma alır.

lua-format

Lua biçimi kalite denetimini kullanıma alır.

object-pascal-format

Object Pascal biçimi kalite denetimini kullanıma alır.

objc-format

Objective-C biçimi kalite denetimini kullanıma alır.

percent-placeholders

Yüzde yer belirticileri kalite denetimini kullanıma alır.

perl-brace-format

Perl süslü parantez biçimi kalite denetimini kullanıma alır.

perl-format

Perl biçimi kalite denetimini kullanıma alır.

php-format

PHP biçimi kalite denetimini kullanıma alır.

python-brace-format

Python süslü parantez biçimi kalite denetimini kullanıma alır.

python-format

Python biçimi kalite denetimini kullanıma alır.

qt-format

Qt biçimi kalite denetimini kullanıma alır.

qt-plural-format

Qt çoğul biçimi kalite denetimini kullanıma alır.

ruby-format

Ruby biçimi kalite denetimini kullanıma alır.

scheme-format

Şema biçimi kalite denetimini kullanıma alır.

vue-format

Vue I18n biçimlendirmesi kalite denetimini kullanıma alır.

rst-text

Bir yazının reStructuredText belgesi olarak işlenmesini sağlar. Çeviri değiştirilmemiş kalite denetimini etkiler. reStructuredText tutarsız ve reStructuredText söz dizimi sorunu kalite denetimlerini kullanıma alır.

md-text

Bir yazının Markdown belgesi olarak işlenmesini sağlar. Çeviri içeriği alanında markdown söz dizimini vurgular. Markdown bağlantıları, Markdown başvuruları ve Markdown söz dizimi kalite denetimlerini kullanıma alır.

max-length

Çevirinin en fazla uzunluğu kalite denetimini kullanıma alır.

max-size

Çevirinin en fazla uzunluğu kalite denetimini kullanıma alır.

placeholders

Yer belirticiler kalite denetimini kullanıma alır.

regex

Kurallı ifade kalite denetimini kullanıma alır.

safe-html

Güvenli olmayan HTML kalite denetimini kullanıma alır.

auto-safe-html

Bir yazıyı koşullu HTML olarak işler, Güvenli olmayan HTML kalite denetimini yalnızca düz yazı veya standart HTML biçimlendirmesi veya geçerli özel bileşenler bulunan kaynak dizgeler için etkinleştirin. Bu denetim, köşeli parantez sözdiziminin HTML olmayabileceği MDX gibi genişletilmiş Markdown çeşitleri için kullanışlıdır. Güvenli olmayan HTML kalite denetimini kullanıma alır.

url

Dizge yalnızca bir adresten oluşmalıdır. Adres kalite denetimini kullanıma alır.

fluent-source-inner-html

Fluent kaynağı iç HTML kodu kalite denetimini kullanıma alır.

fluent-source-syntax

Fluent kaynak söz dizimi kalite denetimini kullanıma alır.

ignore-all-checks

Tüm kalite denetimlerini yok sayar.

ignore-bbcode

BBCode kodlaması kalite denetimini atlar.

ignore-xml-chars-around-tags

XML kod imleri etrafındaki karakterler kalite denetimini atlar.

ignore-duplicate

Art arda yinelenen sözcükler var kalite denetimini atlar.

ignore-check-glossary

Sözlük ile uyumlu değil kalite denetimini atlar.

ignore-double-space

Çift boşluk kalite denetimini atlar.

ignore-fluent-parts

Fluent bölümleri kalite denetimini atlar.

ignore-fluent-references

Fluent başvuruları kalite denetimini atlar.

ignore-fluent-target-inner-html

Fluent çevirisinin iç HTML kodu kalite denetimini atlar.

ignore-fluent-target-syntax

Fluent çevirisi söz dizimi kalite denetimini atlar.

ignore-angularjs-format

AngularJS araya ekleme dizgesi kalite denetimini atlar.

ignore-automattic-components-format

Automattic bileşenleri biçimlendirmesi kalite denetimini atlar.

ignore-c-format

C biçimi kalite denetimini atlar.

ignore-c-sharp-format

C# biçimi kalite denetimini atlar.

ignore-es-format

ECMAScript kalıbı sabitleri kalite denetimini atlar.

ignore-i18next-interpolation

i18next araya ekleme kalite denetimini atlar.

ignore-icu-message-format

ICU MessageFormat kalite denetimini atlar.

ignore-java-printf-format

Java biçimi kalite denetimini atlar.

ignore-java-format

Java MessageFormat kalite denetimini atlar.

ignore-javascript-format

JavaScript biçimi kalite denetimini atlar.

ignore-laravel-format

Laravel biçimi kalite denetimini atlar.

ignore-lua-format

Lua biçimi kalite denetimini atlar.

ignore-object-pascal-format

Object Pascal biçimi kalite denetimini atlar.

ignore-objc-format

Objective-C biçimi kalite denetimini atlar.

ignore-percent-placeholders

Yüzde yer belirticileri kalite denetimini atlar.

ignore-perl-brace-format

Perl süslü parantez biçimi kalite denetimini atlar.

ignore-perl-format

Perl biçimi kalite denetimini atlar.

ignore-php-format

PHP biçimi kalite denetimini atlar.

ignore-python-brace-format

Python süslü parantez biçimi kalite denetimini atlar.

ignore-python-format

Python biçimi kalite denetimini atlar.

ignore-qt-format

Qt biçimi kalite denetimini atlar.

ignore-qt-plural-format

Qt çoğul biçimi kalite denetimini atlar.

ignore-ruby-format

Ruby biçimi kalite denetimini atlar.

ignore-scheme-format

Şema biçimi kalite denetimini atlar.

ignore-vue-format

Vue I18n biçimlendirmesi kalite denetimini atlar.

ignore-translated

Çevrilmiş kalite denetimini atlar.

ignore-inconsistent

Tutarsız kalite denetimini atlar.

ignore-rst-references

reStructuredText tutarsız kalite denetimini atlar.

ignore-kashida

Kashida harfi kullanılmış kalite denetimini atlar.

ignore-md-link

Markdown bağlantıları kalite denetimini atlar.

ignore-md-reflink

Markdown başvuruları kalite denetimini atlar.

ignore-md-syntax

Markdown söz dizimi kalite denetimini atlar.

ignore-max-length

Çevirinin en fazla uzunluğu kalite denetimini atlar.

ignore-max-size

Çevirinin en fazla uzunluğu kalite denetimini atlar.

ignore-escaped-newline

\n aynı değil kalite denetimini atlar.

ignore-end-colon

İki nokta üst üste farklı kalite denetimini atlar.

ignore-end-ellipsis

Üç nokta karakteri farklı kalite denetimini atlar.

ignore-end-exclamation

Ünlem işareti farklı kalite denetimini atlar.

ignore-end-stop

Nokta işareti farklı kalite denetimini atlar.

ignore-end-interrobang

İnterrobang işareti farklı kalite denetimini atlar.

ignore-end-question

Soru işareti farklı kalite denetimini atlar.

ignore-end-semicolon

Noktalı virgül farklı kalite denetimini atlar.

ignore-newline-count

Satır sonları farklı kalite denetimini atlar.

ignore-plurals

Çoğul biçim eksik kalite denetimini atlar.

ignore-multiple-capital

Birden çok büyük harf kullanılmış kalite denetimini atlar.

ignore-kabyle-characters

Kabyle dilinde standart olmayan karakterler var kalite denetimini atlar.

ignore-placeholders

Yer belirticiler kalite denetimini atlar.

ignore-prohibited-initial-character

İzin verilmeyen başlangıç karakteri kalite denetimini atlar.

ignore-punctuation-spacing

Noktalama aralığı kalite denetimini atlar.

ignore-regex

Kurallı ifade kalite denetimini atlar.

ignore-rst-syntax

reStructuredText söz dizimi sorunu kalite denetimini atlar.

ignore-reused

Çeviri yeniden kullanılmış kalite denetimini atlar.

ignore-same-plurals

Tekil ile çoğul biçim aynı kalite denetimini atlar.

ignore-begin-newline

Başta yeni satır var kalite denetimini atlar.

ignore-begin-space

Baştaki boşluk kalite denetimini atlar.

ignore-end-newline

Sondaki yeni satır kalite denetimini atlar.

ignore-end-space

Sondaki boşluk kalite denetimini atlar.

ignore-same

Çeviri değiştirilmemiş kalite denetimini atlar.

ignore-safe-html

Güvenli olmayan HTML kalite denetimini atlar.

ignore-url

Adres kalite denetimini atlar.

ignore-xml-tags

XML kodlaması kalite denetimini atlar.

ignore-xml-invalid

XML söz dizimi kalite denetimini atlar.

ignore-zero-width-space

Sıfır genişlikli boşluk kalite denetimini atlar.

ignore-ellipsis

Üç nokta kalite denetimini atlar.

ignore-fluent-source-inner-html

Fluent kaynağı iç HTML kodu kalite denetimini atlar.

ignore-fluent-source-syntax

Fluent kaynak söz dizimi kalite denetimini atlar.

ignore-icu-message-format

ICU MessageFormat söz dizimi kalite denetimini atlar.

ignore-long-untranslated

Uzun süredir çevrilmemiş kalite denetimini atlar.

ignore-multiple-failures

Birden çok denetim hatası kalite denetimini atlar.

ignore-unnamed-format

Birden çok değişken adlandırılmamış kalite denetimini atlar.

ignore-optional-plural

Çoğul değil kalite denetimini atlar.

Not

Kural genellikle, belirteci kullanılarak herhangi bir denetim için ignore-* olarak adlandırılır. Böylece bunu kendi özel denetimleriniz için bile kullanabilirsiniz.

Bu imler hem Bileşen yapılandırması ayarlarında, her kaynak dizge ayarı için hem de çeviri dosyasının kendisinde (GNU gettext gibi) anlaşılır.

Konum temelli imler

Bazı imler, konumlarına göre varsayılan olarak dizgelere eklenir. Bu işlem, dizgenin kullanıldığı yere bağlı olarak belirli denetimlerin kendiliğinden etkinleştirileceği anlamına gelir.

• rst-text: Bu im, konum uzantısı .rst ise reStructuredText dosyalarındaki dizgelere kendiliğinden eklenir.

• md-text: This flag is automatically added to strings in Markdown and MDX files, if location extension is .md, .markdown, or .mdx.

Denetimleri dayatmak

Dayatılan denetimler reddedilemez ve dizgeyi Düzenlenmesi gerekli olarak imleyemez (ayrıntılı bilgi almak için: Çeviri durumları). Böylece çevirmenlerin bu tür denetimleri gizlemesi önlenir.

İpucu

Denetim dayatması kendiliğinden açılmaz. Bazı denetimler, dizge ya da bileşen imlerine karşılık gelen im eklenerek açılabilir.

Bu en iyi Biçimlendirilmiş dizgeler denetimleri gibi kullanıldığında ciddi sorunlara neden olabilecek denetimlerde kullanılır. Çeviri değiştirilmemiş gibi biçem denetimleri için kullanılması önerilmez. Çünkü bu tür denetimlerde reddetmek bazen kabul edilebilir.

Daha sonra Çeviri kalitesi süzgeci, düzenlenmesi gereken dizgelerin sürüm denetimi sistemine işlenmesini engellemek için kullanılabilir.

Ayrıca bakınız

• Çeviri durumları

• Zorunlu denetimler

• Çeviri kalitesi süzgeci

• Kaynak dizgeler ile ilgili ek bilgiler

• Çeviri imleri

Yazı tiplerini yönetmek

İpucu

Weblate üzerine yüklenen yazı tipleri yalnızca Çevirinin en fazla uzunluğu kalite denetimi için kullanılır. Weblate kullanıcı arayüzünde bir etkisi yoktur.

İşlenen metnin boyutlarını hesaplamak için kullanılan Çevirinin en fazla uzunluğu denetiminin yazı tipinin Weblate üzerine yüklenmesi ve bir çeviri imi kullanılarak seçilmesi gerekir (ayrıntılı bilgi almak için: Parametreleri kullanarak davranışı özelleştirmek).

Çeviri projenizin İşlemler menüsü altındaki Yazı tipleri içindeki Weblate yazı tipi yönetimi aracı, yazı tiplerinin yüklenip yönetilebileceği bir arayüz sağlar. TrueType veya OpenType yazı tipleri yüklenebilir, yazı tipi grupları ayarlanabilir ve bunlar denetimde kullanılabilir.

Yazı tipi grupları, genellikle Latince olmayan farklı diller için gerekli olan farklı yazı tiplerini tanımlanmanızı sağlar:

Yazı tipi grupları, boşluk veya özel karakterler içeremeyen bir ad ile tanımlanır. Böylece denetim tanımında kolayca kullanılabilir:

Font-family and style are automatically recognized after uploading them:

Weblate üzerine çeşitli yazı tipleri yükleyebilirsiniz:

Dizge uzunluğunu denetleme üzere yazı tiplerini kullanmak için, uygun imleri aktarın (ayrıntılı bilgi almak için: Parametreleri kullanarak davranışı özelleştirmek). Büyük olasılıkla şunlara gerek duyacaksınız:

max-size:500 / max-size:300:5

Piksel olarak en fazla genişliği ve isteğe bağlı olarak en fazla satır sayısını belirler (sözcük kaydırma uygulanır).

font-family:ubuntu

Belirteci ile kullanılacak yazı tipi grubunu tanımlar.

font-size:22

Yazı boyutunu piksel olarak tanımlar.

Kendi denetimlerinizi oluşturmak

Çok çeşitli kalite denetimleri hazır olarak bulunur (ayrıntılı bilgi almak için: Kalite denetimleri). Ancak denetlemek istediğiniz her şey kapsanmamış olabilir. Yapılabilecek denetimlerin listesi CHECK_LIST kullanılarak ayarlanabilir. Ayrıca kendi özel denetimlerinizi de ekleyebilirsiniz.

1. weblate.checks.Check alt sınıfı

2. Birkaç öznitelik ayarlayın.

3. check (kodunuzdaki çoğulları işlemek istiyorsanız) ya da check_single yöntemini uygulayın (sizin için hangisi işe yarıyorsa).

Bazı örnekler:

Özel denetimler kurmak için, CHECK_LIST içinde Python sınıfının tam yolunu belirtin. Ayrıntılı bilgi almak için: Özel kalite denetimleri, eklentiler, kendiliğinden öneriler ve kendiliğinden düzeltmeler.

“foo” içermeyen çeviri metinlerini denetlemek

Çeviride “foo” dizgesinin eksik olup olmadığına bakan basit bir denetim.

"""Simple quality check example."""

from django.utils.translation import gettext_lazy

from weblate.checks.base import TargetCheck


class FooCheck(TargetCheck):
    # Used as identifier for check, should be unique
    # Has to be shorter than 50 characters
    check_id = "foo"

    # Short name used to display failing check
    # Might be localized using gettext_lazy
    name = "Foo check"

    # Description for failing check
    description = gettext_lazy("Your translation is foo")

    # Real check code
    def check_single(self, source, target, unit):
        return "foo" in target

Çekçe çeviri metinlerinde çoğulların farklı olup olmadığı denetlemek

Çekçe iki çoğul biçimin aynı olmadığını doğrulamak için dil bilgilerini kullanan denetim.

"""Quality check example for Czech plurals."""

from django.utils.translation import gettext_lazy

from weblate.checks.base import TargetCheck


class PluralCzechCheck(TargetCheck):
    # Used as identifier for check, should be unique
    # Has to be shorter than 50 characters
    check_id = "foo"

    # Short name used to display failing check
    # Might be localized using gettext_lazy
    name = "Foo check"

    # Description for failing check
    description = gettext_lazy("Your translation is foo")

    # Real check code
    def check_target_unit(self, sources, targets, unit):
        if unit.translation.language.is_base({"cs"}):
            return targets[1] == targets[2]
        return False

    def check_single(self, source, target, unit) -> bool:
        """We don't check target strings here."""
        return False