calibre - en to es translation catalogue (20 entries)

en: XPath tutorial
es: Cursillo de 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.
es: En este cursillo, se presentará una breve introducción a `XPath <https://es.wikipedia.org/wiki/XPath>`_, un lenguaje de consulta que se puede utilizar para seleccionar partes arbitrarias de documentos `HTML <https://es.wikipedia.org/wiki/HTML>`_ en calibre. XPath es un estándar ampliamente utilizado, y una búsqueda a través de Google proporcionará gran cantidad de información. Este cursillo, sin embargo, se centra en el uso de XPath para tareas relacionadas con libros electrónicos, como la búsqueda de títulos de capítulo en un documento HTML sin estructura.

en: Contents
es: Índice

en: Selecting by tag name
es: Seleccionar por nombre de etiqueta

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::
es: La forma más simple de selección es seleccionar las etiquetas por su nombre. Por ejemplo, suponga que desea seleccionar todas las etiquetas ``<h2>`` en un documento. La consulta XPath para esto es simplemente::

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::
es: El prefijo `//` significa *buscar en cualquier nivel del documento*. Supongamos que desea encontarar las etiquetas ``<span>`` que están dentro de etiquetas ``<a>``. Esto se puede lograr con::

en: If you want to search for tags at a particular level in the document, change the prefix::
es: Si quiere buscar etiquetas en un nivel particular del documento, cambie el prefijo::

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.
es: Esto coincidirá sólo con ``<p>A very short ebook to demonstrate the use of XPath.</p>`` en :ref:`sample_ebook`, pero no con ninguna de las otras etiquetas ``<p>``. El prefijo ``h:`` en los ejemplos anteriores se necesita para encontrar las etiquetas XHTML. Esto se debe a que internamente calibre representa todo el contenido como XHTML. En XHTML las etiquetas tienen un *espacio de nombres*, y ``h:`` es el prefijo de espacio de nombrs para las etiquetas HTML.

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.
es: Hay varias características nuevas en esta expresión XPath. La primera es el uso del comodín ``*``. Significa *cualquier etiqueta*. Ahora observe la expresión de comprobación ``name()='h1' or name()='h2'``. :term:`name()` es un ejemplo de *función predefinida*. Simplemente evalúa el nombre de la etiqueta. Por lo tanto, mediante su uso, podemos seleccionar etiquetas cuyo nombre sea `h1` o `h2`. Tenga en cuenta que la función :term:`name()` ignora los espacios de nombres de modo que no hay necesidad del prefijo ``h:``. XPath tiene varias funciones predefinidas. Se presentarán algunas más en este cursillo.

en: Selecting by attributes
es: Seleccionar por atributos

en: To select tags based on their attributes, the use of predicates is required::
es: Para seleccionar etiquetas según sus atributos, es necesario usar predicados::

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.
es: Aquí, el operador ``@`` se refiere a los atributos de la etiqueta. Puede utilizar algunas de las `XPath built-in functions`_  para realizar búsquedas más sofisticadas en los valores de los atributos.

en: Selecting by tag content
es: Seleccionar por contenido de etiqueta

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()`::
es: Utilizando XPath, puede incluso seleccionar etiquetas basadas en el texto que contienen. La mejor manera para para hacer esto es usar el poder de las *expresiones regulares* a través la función predefinida :term:`re:test()`::

en: Here the ``.`` operator refers to the contents of the tag, just as the ``@`` operator referred to its attributes.
es: Aquí el operador ``.`` se refiere a los contenidos de la etiqueta, igual que el operador ``@`` se refiere a sus atributos.

en: Sample e-book
es: Libro de muestra

en: XPath built-in functions
es: Funciones XPath predefinidas

en: The name of the current tag.
es: El nombre de la etiqueta actual.

en: ``contains(s1, s2)`` returns `true` if s1 contains s2.
es: ``contains(s1, s2)`` devuelve `true` si s1 contiene s2.

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>`_
es: ``re:test(fuente, patrón, opciones)`` devuelve `true` si el texto `fuente` coincide con la expresión regular `patrón`. Una opción particularmente útil es ``i``, que hace que no se distinga entre mayúsculas y minúsculas. Una buena introducción a la sintaxis de las expresiones regulares se puede encontrar en `sintaxis de expresiones regulares <https://docs.python.org/es/3/library/re.html>`_
