devhelp master - en to pt_BR translation catalogue (47 entries)

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
pt_BR: Formato de livro

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.
pt_BR: Um “livro” no <app>Devhelp</app> é a documentação da API para um módulo ou pacote (geralmente uma biblioteca). Esta página descreve o formato que um livro precisa seguir para que o <app>Devhelp</app> o reconheça.

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:
pt_BR: O conteúdo de um livro é colocado em um diretório (esse diretório contém apenas um livro, não pode conter vários livros). O diretório é composto por:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
pt_BR: Páginas HTML, além de arquivos CSS, imagens 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.
pt_BR: Um arquivo de índice com a extensão <file>*.devhelp2</file>, consulte <link xref="index-file-format"/> para obter mais informações.

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.
pt_BR: Restrição: o nome do diretório no qual o arquivo <file>*.devhelp2</file> se encontra e o nome do arquivo <file>*.devhelp2</file> (sem a extensão) deve ser o mesmo. Em outras palavras, se o diretório do livro for chamado <code>$book_name</code>, o caminho absoluto para o arquivo de índice deverá terminar com <code>$book_name/$book_name.devhelp2</code>. Dessa forma, quando o <app>Devhelp</app> souber o nome do diretório, ele conhecerá diretamente o local do arquivo de índice.

note: (itstool) path: page/title
en: Index file format
pt_BR: Formato do arquivo de índice

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
pt_BR: Esta página descreve o propósito e o formato de arquivos 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.
pt_BR: Um livro (consulte <link xref="book-format"/>) contém um arquivo de índice. O arquivo de índice tem a extensão <file>.devhelp2</file> e possui um 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.
pt_BR: O “2” na extensão de arquivo <file>*.devhelp2</file> é porque é a segunda versão do formato do arquivo. A primeira versão do formato, com a extensão de arquivo <file>*.devhelp</file>, está obsoleta e seu suporte no <app>Devhelp</app> pode ser removido no futuro. Na inicialização do aplicativo, quando o <app>Devhelp</app> verifica o sistema de arquivos para encontrar livros, ele emite uma mensagem de aviso no terminal para cada livro que usa um formato obsoleto.

note: (itstool) path: page/p
en: The index file mainly contains:
pt_BR: O arquivo de índice contém principalmente:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
pt_BR: A estrutura do livro (como um sumário).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
pt_BR: Uma lista de símbolos (funções, tipos, macros, sinais, propriedades, …).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
pt_BR: Eles contêm links para os arquivos HTML para alcançar as páginas e os 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.
pt_BR: No <app>Devhelp</app>, a estrutura do livro é mostrada no painel lateral. E a <link xref="search">pesquisa no painel lateral</link> mostra os resultados encontrados nos arquivos de índice.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
pt_BR: Especificação do formato do arquivo 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.
pt_BR: Infelizmente, o formato de arquivo XML <file>*.devhelp2</file> não está bem documentado. Ainda há alguma esperança de que isso seja corrigido no futuro próximo. Enquanto isso, recomendamos verificar o que o <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link> gera. Para obter a definição mais precisa do que o <app>Devhelp</app> suporta, leia o código-fonte do analisador e a referência da API do <app>Devhelp</app>.

[ctx: link:trail]
note: (itstool) path: info/title
en: Devhelp User Documentation
pt_BR: Documentação do usuário do Devhelp

[ctx: text]
note: (itstool) path: info/title
en: Devhelp User Documentation
pt_BR: Documentação do usuário do Devhelp

[ctx: link]
note: (itstool) path: info/title
en: Devhelp User Documentation
pt_BR: Documentação do usuário do Devhelp

note: (itstool) path: info/desc
en: Devhelp User Documentation
pt_BR: Documentação do usuário do Devhelp

note: (itstool) path: page/title
en: <_:media-1/> Devhelp User Documentation
pt_BR: <_:media-1/> Documentação do usuário do Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
pt_BR: O Devhelp é uma ferramenta de desenvolvedor para navegar e pesquisar na documentação da API.

note: (itstool) path: page/title
en: Installing API documentation
pt_BR: Instalando a documentação de API

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
pt_BR: Como <app>Devhelp</app> encontra a documentação de API.

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
pt_BR: Veja <link xref="book-format"/> para informações sobre o formato da documentação de API que o <app>Devhelp</app> reconhece.

note: (itstool) path: section/title
en: Books locations
pt_BR: Locais dos livros

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.
pt_BR: Quando um livro segue o formato correto, seu diretório precisa ser instalado em um local onde o <app>Devhelp</app> o encontre.

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:
pt_BR: <app>Devhelp</app> usa a <link href="https://specifications.freedesktop.org/basedir-spec/latest/">XDG Base Directory Specification</link> para encontrar os livros. A lista de locais pesquisados é:

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.
pt_BR: Observe que os dois últimos consistem em listas de diretórios a serem procurados. Os valores de diretórios são separados por caracteres <code>:</code>. Estas variáveis de ambiente são normalmente configuradas pelo ambiente gráfico ou pela distribuição.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
pt_BR: Exemplos de locais para indexar arquivos com <code>$XDG_DATA_HOME</code> em um 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>.
pt_BR: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file> se o <app>Devhelp</app> é iniciado com o <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:
pt_BR: Exemplo de um local para um arquivo de índice com <code>$XDG_DATA_DIRS</code> em um 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.
pt_BR: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> é uma ferramenta para gerar documentação de API a partir de comentários adicionados ao código C. É usado pelas bibliotecas e aplicativos GLib, GTK e GNOME.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
pt_BR: GTK-Doc instala a referência de API de um módulo para:

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).
pt_BR: Ele segue o formato do livro suportado pelo <app>Devhelp</app>. Portanto, usando o GTK-Doc, a referência de API pode ser pesquisada no <app>Devhelp</app> automaticamente (uma vez instalada no local correto).

note: (itstool) path: page/title
en: Search in the side panel
pt_BR: Pesquisando no painel lateral

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
pt_BR: Como a pesquisa no painel lateral funciona.

note: (itstool) path: section/title
en: Case sensitivity
pt_BR: Diferenciando maiúsculas de 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.
pt_BR: A pesquisa diferencia maiúsculas de minúsculas quando há uma letra maiúscula. Se os termos de pesquisa estiverem em letras minúsculas, a pesquisa não é insensível a maiúsculas e minúsculas. É como o recurso “smartcase” presente em alguns editores de texto.

note: (itstool) path: section/title
en: Glob-style pattern matching
pt_BR: Combinação de padrão 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.
pt_BR: Um termo de pesquisa pode ser um padrão contendo curingas “*” e “?”. “*” corresponde a uma string arbitrária, possivelmente vazia; e “?” corresponde a um caractere arbitrário.

note: (itstool) path: section/title
en: Several search terms
pt_BR: Vários termos de pesquisa

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).
pt_BR: Você pode pesquisar com vários termos de pesquisa (separados por espaços). Um símbolo irá coincidir apenas se <em>todos</em> os termos de pesquisa coincidirem individualmente (não necessariamente na mesma ordem de aparência).

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.
pt_BR: Observe que é diferente de pesquisar com o curinga “*”: com o curinga “*”, ele força as palavras-chaves a estarem na mesma ordem.

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).
pt_BR: Por exemplo, ao pesquisar “<input>gtk window application</input>”, ele corresponde a “<code>gtk_window_get_application()</code>” e “<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>”.
pt_BR: Por outro lado, a pesquisa “<input>gtk*window*application</input>” combinará “<code>gtk_window_get_application()</code>”, mas não “<code>GtkApplicationWindow</code>”.
