calibre - en to pl translation catalogue (19 entries)

en: XPath tutorial
pl: Samouczek XPath

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.
pl: W tym samouczku otrzymasz delikatne wprowadzenie do `XPath <https://en.wikipedia.org/wiki/XPath>`_, języka zapytań, którego można użyć do wybrania dowolnych części `HTML <https:/ /en.wikipedia.org/wiki/HTML>`_ dokumenty w calibre. XPath jest powszechnie używanym standardem, a wyszukiwanie go w Google przyniesie mnóstwo informacji. Ten samouczek koncentruje się jednak na używaniu XPath do zadań związanych z e-bookami, takich jak znajdowanie nagłówków rozdziałów w nieustrukturyzowanym dokumencie HTML.

en: Contents
pl: Spis treści

en: Selecting by tag name
pl: Wybieranie według nazwy tagu

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::
pl: Najprostszą formą wyboru jest wyszukanie znacznika wg nazwy. Na przykład przypuśćmy, że chcesz odnaleźć wszystkie znaczniki ``<h2>`` w dokumencie. Zapytanie jest proste::

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::
pl: Przedrostek `//` oznacza *wyszukaj na każdym poziomie dokumentu*. A teraz przypuśćmy, że chcesz wybrać tylko te znaczniki ``<span>``, które zawierają znacznik ``<a>``. Można to zrobić tak::

en: If you want to search for tags at a particular level in the document, change the prefix::
pl: Jeśli chcesz wyszukać znaczniki na określonym poziomie dokumentu, zmień przedrostek::

en: Now suppose you want to select both ``<h1>`` and ``<h2>`` tags. To do that, we need a XPath construct called *predicate*. A :dfn:`predicate` is simply a test that is used to select tags. Tests can be arbitrarily powerful and as this tutorial progresses, you will see more powerful examples. A predicate is created by enclosing the test expression in square brackets::
pl: Teraz przypuśćmy, że chcesz wybrać znaczniki ``<h1>`` i ``<h2>``. Do tego potrzebna jest konstrukcja XPath nazywana *predykatem*. :dfn:`predicate` jest po prostu testem, używanym do wybierania znaczników. Test te mają ogromne możliwości i w dalszej części samouczka zobaczysz co można dzięki nim uzyskać. Predykat jest tworzony poprzez umieszczenie wyrażenia testowego w nawiasach kwadratowych::

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.
pl: Jest kilka nowych elementów w tym wyrażeniu XPath. Pierwszym jest użycie symbolu ``*``. Oznacza on *dopasuj dowolny znacznik*. Teraz popatrzmy na wyrażenie ``name()='h1' or name()='h2'``. :term:`name()` jest przykładem *wbudowanej funkcji*. Zwraca ona po prostu nazwę znacznika. Używając jej możemy więc wybrać znaczniki, których nazwa to `h1` lub `h2`. Funkcja :term:`name()` nie uwzględnia przestrzeni nazw, nie ma więc konieczności użycia przedrostka ``h:``. XPath ma wbudowanych wiele przydatnych funkcji. Kilka z nich poznasz w tym samouczku.

en: Selecting by attributes
pl: Wybieranie wg atrybutów

en: To select tags based on their attributes, the use of predicates is required::
pl: Aby wybrać znaczniki wg ich atrybutów wymagane jest użycie predykatów::

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.
pl: W tym przypadku operator ``@`` odnosi się do atrybutów znacznika. Można ponadto użyć niektórych `funkcji wbudowanych XPath`_, aby dokładniej dopasować wartości atrybutów.

en: Selecting by tag content
pl: Wybieranie po zawartości znacznika

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()`::
pl: Przy użyciu XPath możesz nawet wybrać znaczniki, bazując na tekście, który zawierają. Najlepszym na to sposobem jest użycie *wyrażeń regularnych* poprzez wbudowaną funkcję "term:`re:test()`::

en: Here the ``.`` operator refers to the contents of the tag, just as the ``@`` operator referred to its attributes.
pl: W tym przypadku operator ``.`` odnosi się do zawartości znacznika, tak jak operator ``@`` odnosił się do atrybutów.

en: Sample e-book
pl: Przykładowy e-book

en: XPath built-in functions
pl: Wbudowane funkcje XPath

en: The name of the current tag.
pl: Nazwa aktualnie wybranego znacznika

en: ``contains(s1, s2)`` returns `true` if s1 contains s2.
pl: ``contains(s1, s2)`` zwraca `true` jeśli s1 zawiera s2.
