devhelp main - en to gl translation catalogue (47 entries)

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
gl: 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.
gl: Un «libro» in <app>Devhelp</app> é unha documentación de API para un módulo, ou paquete (normalmente unha biblioteca). Esta páxina describe o formato que un libre precisa para seguir para que <app>Devhelp</app> o recoñeza.

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:
gl: O contido dun libro móstrase nun cartafol (ese cartafol contén só un libro, non pode conter varios libros). O cartafol está composto por:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
gl: As páxinas HTML, así como os ficheiros CSS, imaxes, 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.
gl: Un ficheiro de índice coa extensión de ficheiro <file>*.devhelp2</file>, vexa <link xref="index-file-format"/> para obter máis 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.
gl: Restrición: o nome do cartafol do ficheiro <file>*.devhelp2</file> está no nome do ficheiro e o nome do ficheiro <file>*.devhelp2</file> (salvo a extensión) deben coincidir. Noutras palabras, se o cartafol do libro chámase <code>$nome_libro</code>, entón a ruta absoluta do ficheiro de índice debería rematar con <code>$nome_libro/$nome_libro.devhelp2</code>. Desta forma, cando <app>Devhelp</app> coñece o nome do cartafol, directamente sabe a localización do ficheiro de índice.

note: (itstool) path: page/title
en: Index file format
gl: Formato de ficheiro de índice

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
gl: Esta páxina describe o propósito e o formato dos ficheiros de índice <file>*.devhelp2</file>.

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.
gl: Un libro (vexa <link xref="book-format"/>) contén un ficheiro de índice. O ficheiro de índice ten unha extensión <file>.devhelp2</file> e un 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.
gl: O «2» na extensión de ficheiro <file>*.devhelp2</file> está porque é a segunda versión do formato de ficheiro. A primeira versión do formato, coa extensión de ficheiro <file>*.devhelp</file>, está obsoleto e a compatibilidade en <app>Devhelp</app> podería retirarse no futuro. Ao inicio da aplicación, cando <app>Devhelp</app> analiza o sistema de ficheiros para buscar libros, emite un mensaxe de aviso na terminal para cada libro que use o formato obsoleto.

note: (itstool) path: page/p
en: The index file mainly contains:
gl: Un ficheiro de índice contén principalmente:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
gl: A estrutura dun libro (como unha táboa de contidos).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
gl: Unha lista de símbolos (función, tipos, macros, sinais, propiedades, …).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
gl: Estes conteñen ligazóns a ficheiros HTML para chegar ás páxinas e símbolos correspondentes.

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.
gl: En <app>Devhelp</app> a estrutura dun libro móstrase no panel lateral. E a <link xref="search">busca no panel lateral</link> mostra os resultados atopados nos ficheiros de índice.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
gl: A especificación do formato de ficheiro 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.
gl: Desafortunadamente o formato de ficheiro XML de <file>*.devhelp2</file> non está ben documentado. Aínda hai esperanza que isto se arranxe no futuro cercano. Namentres, recomendámoslle mirar o que xera <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link>. Para unha definición máis precisa do que <app>Devhelp</app> admite, lea o código fonte do analizador e a referencia da API de <app>Devhelp</app>.

[ctx: link:trail]
note: (itstool) path: info/title
en: Devhelp User Documentation
gl: Documentación de usuario de Devhelp

[ctx: text]
note: (itstool) path: info/title
en: Devhelp User Documentation
gl: Documentación de usuario de Devhelp

[ctx: link]
note: (itstool) path: info/title
en: Devhelp User Documentation
gl: Documentación de usuario de Devhelp

note: (itstool) path: info/desc
en: Devhelp User Documentation
gl: Documentación de usuario de Devhelp

note: (itstool) path: page/title
en: <_:media-1/> Devhelp User Documentation
gl: <_:media-1/> Documentación de usuario de Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
gl: Devhelp é unha ferramenta de desenvolvemento para explroar e buscar documentación de APIs.

note: (itstool) path: page/title
en: Installing API documentation
gl: Instalando documentación de API

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
gl: Como atopa a documentación de APIs <app>Devhelp</app>

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
gl: Vexa <link xref="book-format"/> para obter máis información sobre o formato de documentación que recoñece <app>Devhelp</app>.

note: (itstool) path: section/title
en: Books locations
gl: Localizacións de 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.
gl: Se un libro segue o formato correcto, o seu cartafol precisa instalarse nunha localización onde <app>Devhelp</app> o poida atopar.

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:
gl: <app>Devhelp</app> usa a  <link href="https://specifications.freedesktop.org/basedir-spec/latest/">Especificación de cartafol Base de XDG</link> para atopar os libros. A lista de localizacións é:

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.
gl: Teña en conta que os dous últimos consisten en listas de cartafoles onde buscar. Os valores de cartafoles están separados por caracteres. Esas variábeis de ambiente configúranse normalmente polo ambiente de escritorio ou distribución.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
gl: Exemplos de localizacións de ficheiros de índices con <code>$XDG_DATA_HOME</code> nun sistema típico:

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>.
gl: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file> se <app>Devhelp</app> se inicia 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:
gl: Exemplo dunha localización dun ficheiro de índice con <code>$XDG_DATA_DIRS</code> nun sistema típico:

note: (itstool) path: section/p
en: <link href="https://gitlab.gnome.org/GNOME/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.
gl: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> é unha ferramenta para xerar documentación de APIs desde os comentarios engadidos ao código C. Úsano as aplicacións e bibliotecas de GNOME Glib, GTK.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
gl: GTK-Doc instala a referencia de API dun 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).
gl: Segue o formato de libro admitido por <app>Devhelp</app>. Polo que usando GTK-Doc, a referencia de API pode explorarse con <app>Devhelp</app> automaticamente (en canto se instale no lugar correcto).

note: (itstool) path: page/title
en: Search in the side panel
gl: Busca no panel lateral

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
gl: Cómo funciona a busca do panel lateral.

note: (itstool) path: section/title
en: Case sensitivity
gl: Diferenciar capitalización

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.
gl: A busca é sensíbel á capitalización cando hai unha letra en maiúscula. Se os termos de busca están todos en minúsculas, a busca non revisa a capitalización. É como unha característica de «capitalización intelixente» presente en varios editores de texto.

note: (itstool) path: section/title
en: Glob-style pattern matching
gl: Coincidencia de patróns de estilo Glob

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.
gl: Un termo de busca pode conter un patrón con comodíns como «*» e «?». «*» coincidirá con calquera cadea arbitraria, incluso baleira; e «?» coincide con un carácter arbitrario.

note: (itstool) path: section/title
en: Several search terms
gl: Varios termos de busca

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).
gl: Pode buscar por varios termos de busca (separados por espacios). Un símbolo só coincidirá se <em>todos</em> os termos de busca individuais coinciden (non necesariamente na mesma orde 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.
gl: Teña en conta que é diferente buscar con un comodín «*»: co comodín «*» fórzase que as palabras chave estean na mesma orde.

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).
gl: Por exemplo ao buscar “<input>gtk window application</input>”, coincide tanto «<code>gtk_window_get_application()</code>» como «<code>GtkApplicationWindow</code>» (entre outros 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>”.
gl: Por outro lado, se busca «<input>gtk*window*application</input>» coincidirá con «<code>gtk_window_get_application()</code>» pero non con «<code>GtkApplicationWindow</code>».
