devhelp master - en to es_ES translation catalogue (43 entries)

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
es_ES: Formato de libro

note: (itstool) path: synopsis/p
en: A “book” in <app>Devhelp</app> is the API documentation for one module, or package (usually a library). This page describes the format that a book needs to follow in order for <app>Devhelp</app> to recognize it.
es_ES: En <app>Devhelp</app> un «libro» es la documentación de la API de un módulo o paquete (normalmente una biblioteca). Esta página describe el formato que necesita tener un libro para que <app>Devhelp</app> lo reconozca.

note: (itstool) path: page/p
en: The content of a book is placed in one directory (that directory contains only one book, it cannot contain several books). The directory is comprised of:
es_ES: El contenido de un libro se coloca en una carpeta (que contiene sólo un libro, no puede contener varios). La carpeta se compone de:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
es_ES: Páginas HTML además de posibles archivos CSS, imágenes, etc.

note: (itstool) path: item/p
en: An index file with the <file>*.devhelp2</file> file extension, see <link xref="index-file-format"/> for more information.
es_ES: Un archivo índice cuya extensión es <file>*.devhelp2</file>. Consulte la sección <link xref="index-file-format"/> para obtener más información.

note: (itstool) path: note/p
en: Restriction: the name of the directory the <file>*.devhelp2</file> file is in and the name of the <file>*.devhelp2</file> file (minus the extension) must match. In other words, if the book directory is called <code>$book_name</code>, then the absolute path to the index file should end with <code>$book_name/$book_name.devhelp2</code>. That way, when <app>Devhelp</app> knows the directory name, it directly knows the location to the index file.
es_ES: Restricción: el nombre de la carpeta donde está el archivo <file>*.devhelp2</file> y el nombre del archivo <file>*.devhelp2</file> (sin la extensión) deben coincidir. En otras palabras, si la carpeta del libro se llama <code>$nombre_libro</code>, la ruta absoluta al archivo índice debe terminar es <code>$nombre_libro/$nombre_libro.devhelp2</code>. De este modo, cuando <app>Devhelp</app> conoce el nombre de la carpeta sabe directamente la ubicación del archivo índice.

note: (itstool) path: page/title
en: Index file format
es_ES: Formato del archivo índice

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
es_ES: Esta página describe el propósito y el formato de los archivos <file>*.devhelp2</file> índice.

note: (itstool) path: page/p
en: A book (see <link xref="book-format"/>) contains one index file. The index file has the extension <file>.devhelp2</file> and has an XML format.
es_ES: Un libro (consulte la sección <link xref="book-format"/>) sólo contiene un archivo índice. Este archivo tiene la extensión <file>.devhelp2</file> y está en formato XML.

note: (itstool) path: note/p
en: The “2” in the <file>*.devhelp2</file> file extension is because it is the second version of the file format. The first version of the format, with the <file>*.devhelp</file> file extension, is deprecated and its support in <app>Devhelp</app> may be removed in the future. On application startup, when <app>Devhelp</app> scans the filesystem to find books, it emits a warning message in the terminal for each book that uses a deprecated format.
es_ES: El «2» en la extensión <file>*.devhelp2</file> del archivo se debe a que es la segunda versión del formato del archivo. La primera versión del formato, con la extensión <file>*.devhelp</file>, está obsoleta y su soporte en <app>Devhelp</app> se eliminará en un futuro. Al iniciar la aplicación, cuando <app>Devhelp</app> analiza el sistema de archivos para buscar libros, muestra un mensaje de advertencia en la consola por cada libro que usa un formato obsoleto.

note: (itstool) path: page/p
en: The index file mainly contains:
es_ES: El archivo índice contiene:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
es_ES: La estructura del libro (como una tabla de contenidos).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
es_ES: Una lista de símbolos (funciones, tipos, macros, señales, propiedades, etc).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
es_ES: Este contiene enlaces a los archivos HTML para llegar a las páginas y símbolos correspondientes.

note: (itstool) path: page/p
en: In <app>Devhelp</app> the book structure is shown in the side panel. And the <link xref="search">search in the side panel</link> shows results found in the index files.
es_ES: En <app>Devhelp</app> la estructura del libro del libro se muestra en el panel lateral. Y la <link xref="search">búsqueda en el panel lateral</link> muestra lo resultados encontrados en los archivos índice.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
es_ES: Especificación del formato de archivo XML <file>*.devhelp2</file>

note: (itstool) path: section/p
en: Unfortunately the <file>*.devhelp2</file> XML file format is not well documented. There is still some hope that it will be fixed in the near future. In the meantime, we recommend to look at what <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link> generates. For the most precise definition of what <app>Devhelp</app> supports, read the parser source code and the <app>Devhelp</app> API reference.
es_ES: El formato de archivo XML <file>*.devhelp2</file> no estña bien documentado. Todavía se espera que esto se solucione en un futuro cercano, pero mientras tanto se recomienda consultar lo que genera <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link>. Para una definición más precisa de lo que soporta <app>Devhelp</app> lea el código fuente del analizador y la referencia de la API de <app>Devhelp</app>.

note: (itstool) path: page/title
en: Devhelp User Documentation
es_ES: Documentación del usuario de Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
es_ES: Devhelp es una herramienta para desarrolladores para examinar y buscar documentación de las API.

note: (itstool) path: page/title
en: Installing API documentation
es_ES: Instalar documentación de la API

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
es_ES: Cómo encuentra <app>Devhelp</app> la documentación de la API.

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
es_ES: Consulte en <link xref="book-format"/> la información sobre qué formato de la documentación de la API reconoce <app>Devhelp</app>.

note: (itstool) path: section/title
en: Books locations
es_ES: Ubicaciones de los libros

note: (itstool) path: section/p
en: Once a book follows the right format, its directory needs to be installed at a location where <app>Devhelp</app> will find it.
es_ES: Una vez que el libro sigue el formato correcto se debe instalar su carpeta en una ubicación donde <app>Devhelp</app> pueda encontrarlo.

note: (itstool) path: section/p
en: <app>Devhelp</app> uses the <link href="https://specifications.freedesktop.org/basedir-spec/latest/">XDG Base Directory Specification</link> to find the books. The list of locations searched is:
es_ES: <app>Devhelp</app> usa la <link href="https://specifications.freedesktop.org/basedir-spec/latest/">especificación XDG de carpetas base</link> para buscar los libros. La lista de ubicaciones en las que busca es:

note: (itstool) path: section/p
en: Note that the two latter consist of lists of directories to look for. Directory values are separated by <code>:</code> characters. Those environment variables are normally set up by the desktop environment or distribution.
es_ES: Tenga en cuenta que las dos últimas son listas de carpetas separadas por <code>:</code> en las que buscar. Normalmente estas variables de entorno las configura el entorno de escritorio o la distribución.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
es_ES: Ejemplos de ubicaciones para archivos índice con <code>$XDG_DATA_HOME</code> en un sistema habitual:

note: (itstool) path: item/p
en: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file> if <app>Devhelp</app> is launched with <link href="https://flatpak.org/">Flatpak</link>.
es_ES: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file> si se ejecuta <app>Devhelp</app> con <link href="https://flatpak.org/">Flatpak</link>.

note: (itstool) path: section/p
en: Example of a location to an index file with <code>$XDG_DATA_DIRS</code> on a typical system:
es_ES: Ejemplo de ubicación de un archivo de índice con <code>$XDG_DATA_DIRS</code> en un sistema habitual:

note: (itstool) path: section/p
en: <link href="https://www.gtk.org/gtk-doc/">GTK-Doc</link> is a tool to generate API documentation from comments added to C code. It is used by GLib, GTK and GNOME libraries and applications.
es_ES: <link href="https://www.gtk.org/gtk-doc/">GTK-Doc</link> es una herramienta para generar documentación de la API a partir de comentarios al código en C. Se usa en GLib y en bibliotecas y aplicaciones de GNOME.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
es_ES: GTK-Doc instala la referencia de la API de un módulo en:

note: (itstool) path: section/p
en: It follows the book format supported by <app>Devhelp</app>. So by using GTK-Doc, the API reference can be browsed in <app>Devhelp</app> automatically (once installed in the right location, that is).
es_ES: Sigue el formato soportado por <app>Devhelp</app>. Por lo tanto, usando GTK-Doc se puede examinar la referencia de la API en <app>Devhelp</app> automáticamente (una vez instalada en la ubicación correcta).

note: (itstool) path: page/title
en: Search in the side panel
es_ES: Búsqueda en el panel lateral

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
es_ES: Cómo funciona la búsqueda en el panel lateral.

note: (itstool) path: section/title
en: Case sensitivity
es_ES: Distinguir mayúsculas y minúsculas

note: (itstool) path: section/p
en: The search is case sensitive when there is an uppercase letter. If the search terms are all in lowercase, the search is case insensitive. It's like the “smartcase” feature present in some text editors.
es_ES: La búsqueda distingue entre mayúsculas y minúsculas cuando hay una letra mayúscula. Si todos los términos de la búsqueda están en minúsculas la búsqueda no hace esta distinción. Esto es como la característica de «mayúsculas y minúsculas inteligentes» de algunos editores de texto.

note: (itstool) path: section/title
en: Glob-style pattern matching
es_ES: Coincidencia de patrones de tipo global

note: (itstool) path: section/p
en: A search term can be a pattern containing ‘*’ and ‘?’ wildcards. ‘*’ matches an arbitrary, possibly empty, string; and ‘?’ matches an arbitrary character.
es_ES: Un término de búsqueda puede ser un patrón que contenga los comodines «?» y «*». El «*» busca un patrón arbitrario que puede estar vacío en una cadena; «?» busca un único carácter cualquiera.

note: (itstool) path: section/title
en: Several search terms
es_ES: Varios términos de búsqueda

note: (itstool) path: section/p
en: You can search with several search terms (separated by spaces). A symbol will match only if <em>all</em> the search terms individually match (not necessarily in the same order of appearance).
es_ES: Puede buscar varios términos (separados por espacios). Un símbolo coincidirá sólo si <em>todos</em> los términos de la búsqueda coinciden individualmente (no necesariamente en el mismo orden de aparición).

note: (itstool) path: section/p
en: Note that it is different than searching with the ‘*’ wildcard: with the ‘*’ wildcard it forces the keywords to be in the same order.
es_ES: Tenga en cuenta que esto es diferente de buscar con el comodín «*»: con dicho comodín se fuerza a buscar las palabras en el mismo orden.

note: (itstool) path: section/p
en: For example when searching “<input>gtk window application</input>”, it matches both “<code>gtk_window_get_application()</code>” and “<code>GtkApplicationWindow</code>” (among other symbols).
es_ES: Por ejemplo, al buscar «<input>gtk window application</input>», esto coincide con «<code>gtk_window_get_application()</code>» y «<code>GtkApplicationWindow</code>» (entre otros símbolos).

note: (itstool) path: section/p
en: On the other hand, searching “<input>gtk*window*application</input>” will match “<code>gtk_window_get_application()</code>” but not “<code>GtkApplicationWindow</code>”.
es_ES: Por otro lado, buscar «<input>gtk*window*application</input>» coincidirá con «<code>gtk_window_get_application()</code>» pero no con «<code>GtkApplicationWindow</code>».
