calibre - en to nl translation catalogue (21 entries)

en: XPath tutorial
nl: XPath handleiding

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.
nl: In deze zelfstudie krijgt u een voorzichtige inleiding tot `XPath <https://en.wikipedia.org/wiki/XPath>` _, een querytaal die kan worden gebruikt om willekeurige delen van `HTML <https://en.wikipedia.org/wiki/HTML>`_documenten in Calibre. XPath is een veel gebruikte standaard, en googelen levert een hoop informatie op. Deze zelfstudie richt zich echter op het gebruik van XPath voor aan e-boeken gerelateerde taken, zoals het vinden van hoofdstukken in een ongestructureerd HTML-document.

en: Contents
nl: Inhoud

en: Selecting by tag name
nl: Selecteren op naam van label

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::
nl: De eenvoudigste vorm van selectie is om labels op naam te selecteren. Bijvoorbeeld, stel dat u wilt alle ``<h2>``-labels in een document wilt selecteren. De XPath query voor dit is::

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::
nl: Het voorvoegsel `//` betekent *zoeken op elk niveau van het document*. Stel nu dat u wilt zoeken naar ``<span>`` -labels die zich binnen de ``<a>``labels bevinden. Dat kan worden bereikt met::

en: If you want to search for tags at a particular level in the document, change the prefix::
nl: Als u naar labels wilt zoeken in een bepaald gebied van het document, verander dan de prefix::

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.
nl: Dit komt overeen met ``<p>een zeer kort e-book om het gebruik van XPath.</p>`` in de :ref:`voorbeeld_ebook` aan te tonen, maar niet een van de andere ``<p>``-labels. Het ``h:`` voorvoegsel in de bovenstaande voorbeelden is nodig om overeen te komen met XHTML-labels. Dit komt omdat intern, Calibre alle inhoud als XHTML vertegenwoordigt. In XHTML-labels hebben een *naamruimte*, en ``h:`` is de naamruimte prefix voor HTML-labels.

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.
nl: Er zijn verschillende nieuwe functies in deze XPath-expressie. De eerste is het gebruik van het jokerteken `` * ``. Het betekent * komt overeen met elke tag *. Kijk nu naar de testuitdrukking `` name ()='h1' of name ()='h2' ''. : term: `name()` is een voorbeeld van een * ingebouwde functie *. Het evalueert eenvoudigweg de naam van de tag. Dus door het te gebruiken, kunnen we tags selecteren waarvan de namen `h1` of` h2` zijn. Merk op dat de functie :term:`name ()` naamruimten negeert, zodat het voorvoegsel `` h: `` niet nodig is. XPath heeft verschillende handige ingebouwde functies. Een paar meer zullen in deze zelfstudie worden geïntroduceerd.

en: Selecting by attributes
nl: Selecteren op eigenschap

en: To select tags based on their attributes, the use of predicates is required::
nl: Om tags te selecteren op basis van hun attributen, is het gebruik van predicaten vereist::

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.
nl: Hier verwijst de operator ``@'' naar de kenmerken van de tag. U kunt enkele van de in 'XPath ingebouwde functies' _ gebruiken om meer geavanceerdere vergelijkingen uit te voeren op kenmerkwaarden.

en: Selecting by tag content
nl: Selecteren op label inhoud

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()`::
nl: Met XPath kunt u zelfs tags selecteren op basis van de tekst die ze bevatten. De beste manier om dit te doen is om de kracht van * reguliere expressies * te gebruiken via de ingebouwde functie :term:`re:test()`::

en: Here the ``.`` operator refers to the contents of the tag, just as the ``@`` operator referred to its attributes.
nl: Hier verwijst de operator ``.`` naar de inhoud van de tag, net zoals de operator ``@'' verwijst naar de kenmerken.

en: Sample e-book
nl: Voorbeeld e-boek

en: XPath built-in functions
nl: XPath ingebouwde functies

en: name()
nl: naam()

en: The name of the current tag.
nl: De naam van het huidige label.

en: contains()
nl: bevat()

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>`_
nl: ``re:test (src, patroon, vlaggen)`` geeft `waar` terug als de string `src` overeenkomt met de reguliere expressie `patroon`. Een bijzonder handige vlag is ``i``, het maakt vergelijken hoofdletter ongevoelig. Een goede inleiding over de syntaxis voor reguliere expressies is te vinden op `regexp syntax <https://docs.python.org/library/re.html>` _
