calibre - en to tr translation catalogue (20 entries)

en: XPath tutorial
tr: XPath Rehberi

en: In this tutorial, you will be given a gentle introduction to `XPath <https://en.wikipedia.org/wiki/XPath>`_, a query language that can be used to select arbitrary parts of `HTML <https://en.wikipedia.org/wiki/HTML>`_ documents in calibre. XPath is a widely used standard, and googling it will yield a ton of information. This tutorial, however, focuses on using XPath for e-book related tasks like finding chapter headings in an unstructured HTML document.
tr: Bu eğitimde, 'HTML <https:/'nin isteğe bağlı bölümlerini seçmek için kullanılabilecek bir sorgulama dili olan 'XPath <https://en.wikipedia.org/wiki/XPath>'_ hakkında hafif bir giriş yapılacaktır. /en.wikipedia.org/wiki/HTML>`_ calibre'deki belgeler. XPath yaygın olarak kullanılan bir standarttır ve Google'da araştırıldığında tonlarca bilgi elde edilir. Ancak bu eğitim, yapılandırılmamış bir HTML belgesinde bölüm başlıklarını bulmak gibi e-kitapla ilgili görevler için XPath kullanımına odaklanmaktadır.

en: Contents
tr: İçindekiler

en: Selecting by tag name
tr: Etiket ismine göre seçim

en: The simplest form of selection is to select tags by name. For example, suppose you want to select all the ``<h2>`` tags in a document. The XPath query for this is simply::
tr: Seçimin en basit formu etiketleri isme göre seçmektir. Örneğin; belgedeki tüm ``<h2>`` etiketlerini seçmek istediğinizi düşünelim. XPath sorgusu basitçe şöyle olacaktır::

en: The prefix `//` means *search at any level of the document*. Now suppose you want to search for ``<span>`` tags that are inside ``<a>`` tags. That can be achieved with::
tr: Baştaki `//` öneki *belgedeki tüm düzeylerde ara* anlamına gelmektedir. Şimdi ise ``<a>`` etiketi içindeki ``<span>``etiketlerini arıyor olalım. Bunu yapan sorgu::

en: If you want to search for tags at a particular level in the document, change the prefix::
tr: Eğer belgedeki belirli bir düzeydeki etiketleri arayacak olursanız öneki değiştirin::

en: This will match only ``<p>A very short e-book to demonstrate the use of XPath.</p>`` in the :ref:`sample_ebook` but not any of the other ``<p>`` tags. The ``h:`` prefix in the above examples is needed to match XHTML tags. This is because internally, calibre represents all content as XHTML. In XHTML tags have a *namespace*, and ``h:`` is the namespace prefix for HTML tags.
tr: Bu yalnızca :ref:`sample_ebook` içindeki ``<p>XPath kullanımını göstermek için çok kısa bir e-kitap.</p>`` ile eşleşir ancak diğer ``<p>`` etiketlerinden hiçbiriyle eşleşmez. Yukarıdaki örneklerde ``h:`` öneki XHTML etiketleriyle eşleşmesi için gereklidir. Bunun nedeni dahili olarak calibre'nin tüm içeriği XHTML olarak temsil etmesidir. XHTML'de etiketlerin bir *ad alanı* vardır ve ``h:`` HTML etiketleri için ad alanı önekidir.

en: There are several new features in this XPath expression. The first is the use of the wildcard ``*``. It means *match any tag*. Now look at the test expression ``name()='h1' or name()='h2'``. :term:`name()` is an example of a *built-in function*. It simply evaluates to the name of the tag. So by using it, we can select tags whose names are either `h1` or `h2`. Note that the :term:`name()` function ignores namespaces so that there is no need for the ``h:`` prefix. XPath has several useful built-in functions. A few more will be introduced in this tutorial.
tr: Bu XPath ifadesinde pek çok yenilik bulunmaktadır. Bunların ilki ``*`` karakteridir. *herhangi bir etiketle eşleş* anlamına gelmektedir. Şimdi test ifadesine bakalım ``name()='h1' or name()='h2'``. :term:`name()` *tümleşik fonksiyona* bir örnektir. Basitçe etiketin adını değerlendirir. Bu nedenle onu kullanarak, isimleri `h1` veya `h2` olan etiketleri seçebiliriz. :term:`name()` fonksiyonunun isim alanlarını yok saydığını ve bu nedenle ``h:`` ön ekine ihtiyaç olmadığına dikkat edin. XPath çok fazla tümleşik fonksiyona sahiptir. Bunlardan bir kaçına bu rehberde değinilecektir.

en: Selecting by attributes
tr: Özniteliğe göre seçmek

en: To select tags based on their attributes, the use of predicates is required::
tr: Etiketleri özniteliklerine göre seçmek için bu ifadelerin kullanılması gereklidir::

en: Here, the ``@`` operator refers to the attributes of the tag. You can use some of the `XPath built-in functions`_ to perform more sophisticated matching on attribute values.
tr: Buradaki ``@`` operatörü etiketin özniteliğine karşılık gelir. Öznitelik değerleriyle ilgili daha karmaşık eşleşmeler için `XPath tümleşik fonksiyonlarını`_ kullanabilirsiniz.

en: Selecting by tag content
tr: Etiket içeriğine göre seçmek

en: Using XPath, you can even select tags based on the text they contain. The best way to do this is to use the power of *regular expressions* via the built-in function :term:`re:test()`::
tr: XPath kullanarak etiketleri içerdikleri metinlere göre seçebilirsiniz. Bunu yapmanın en iyi yolu :term:`re:test()` tümleşik fonksiyonunun *düzenli ifadelerini* kullanmaktır::

en: Here the ``.`` operator refers to the contents of the tag, just as the ``@`` operator referred to its attributes.
tr: Buradaki ``.`` operatörü etiketin içeriğine karşılık gelir, ``@`` operatörünün özniteliklere karşılık gelmesi gibidir.

en: Sample e-book
tr: Örnek e-kitap

en: XPath built-in functions
tr: XPath tümleşik fonksiyonları

en: The name of the current tag.
tr: Mevcut etiketin adı.

en: ``contains(s1, s2)`` returns `true` if s1 contains s2.
tr: ``contains(s1, s2)`` ifadesi eğer s1, s2'yi içerirse `true` döndürür.

en: ``re:test(src, pattern, flags)`` returns `true` if the string `src` matches the regular expression `pattern`. A particularly useful flag is ``i``, it makes matching case insensitive. A good primer on the syntax for regular expressions can be found at `regexp syntax <https://docs.python.org/library/re.html>`_
tr: ``re:test(src, model, flags)``, `src` dizesi `pattern` normal ifadesiyle eşleşiyorsa `true' değerini döndürür. Özellikle kullanışlı bir bayrak ``i``dir, eşleştirmeyi büyük/küçük harfe duyarsız hale getirir. Düzenli ifadelerin sözdizimi hakkında iyi bir başlangıç ​​noktası, 'regexp sözdizimi <https://docs.python.org/library/re.html>'_ adresinde bulunabilir.
