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

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
ca: Format del llibre

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.
ca: Al <app>Devhelp</app>, un «llibre» és la documentació de l'API d'un mòdul o paquet (normalment, una biblioteca). Aquesta pàgina descriu el format que un llibre ha de seguir perquè el <app>Devhelp</app> el reconegui.

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:
ca: El contingut d'un llibre es col·loca en un directori (aquest directori conté un sol llibre, no pot contenir-ne diversos). El directori es compon de:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
ca: pàgines HTML amb possibles fitxers CSS, imatges, etc., i

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.
ca: Un fitxer d'índex amb l'extensió de fitxer <file>*.devhelp2</file>. Vegeu <link xref="index-file-format"/> per a més informació.

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.
ca: Restricció: el nom del directori on és el fitxer <file>*.devhelp2</file> i el nom del fitxer <file>*.devhelp2</file> (sense l'extensió) han de coincidir. En altres paraules, si el directori del llibre s'anomena <code>$book_name</code>, el camí absolut al fitxer d'índex ha d'acabar amb <code>$book_name/$book_name.devhelp2</code>. D'aquesta manera, quan el <app>Devhelp</app> coneix el nom del directori, també coneix directament la ubicació del fitxer d'índex.

note: (itstool) path: page/title
en: Index file format
ca: Format del fitxer d'índex

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
ca: Aquesta pàgina descriu el propòsit i el format dels fitxers d'índex <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.
ca: Un llibre (vegeu <link xref="book-format"/>) conté un fitxer d'índex. El fitxer d'índex té l'extensió <file>.devhelp2</file> i format 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.
ca: El «2» de l'extensió de fitxer <file>*.devhelp2</file> es deu a que és la segona versió del format de fitxers. La primera versió del format, amb l'extensió de fitxer <file>*.devhelp</file>, és obsoleta i pot deixar de tenir compatibilitat al <app>Devhelp</app> en el futur. En iniciar l'aplicació, quan el <app>Devhelp</app> escaneja el sistema de fitxers cercant llibres, emet un missatge d'avís al terminal per cada llibre que utilitza un format obsolet.

note: (itstool) path: page/p
en: The index file mainly contains:
ca: El fitxer d'índex conté principalment:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
ca: L'estructura del llibre (una mena de taula de continguts).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
ca: Una llista de símbols (funcions, tipus, macros, senyals, propietats, etc.).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
ca: Aquests elements contenen enllaços als fitxers HTML per a arribar a les pàgines i símbols corresponents.

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.
ca: Al <app>Devhelp</app>, l'estructura del llibre es mostra al quadre lateral. I la <link xref="search">cerca al quadre lateral</link> mostra resultats trobats als fitxers d'índex.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
ca: Especificació del format de fitxer 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.
ca: Malauradament, el format de fitxer XML <file>*.devhelp2</file> no està ben documentat. Encara hi ha alguna esperança que això s'arregli en un futur pròxim. Mentrestant, recomanem consultar el que genera <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link>. Per a la definició més precisa de què és compatible amb el <app>Devhelp</app>, llegiu el codi font de l'analitzador i la referència API del <app>Devhelp</app>.

note: (itstool) path: page/title
en: Devhelp User Documentation
ca: Documentació d'usuari del Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
ca: El Devhelp és una eina de desenvolupament de navegació i cerca de documentació d'API.

note: (itstool) path: page/title
en: Installing API documentation
ca: Instal·lació de documentació d'API

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
ca: Com troba el <app>Devhelp</app> la documentació d'API.

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
ca: Vegeu <link xref="book-format"/> per a informació sobre el format de documentació d'API que el <app>Devhelp</app> reconeix.

note: (itstool) path: section/title
en: Books locations
ca: Ubicacions dels llibres

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.
ca: Un cop que un llibre té el format correcte, el seu directori s'ha d'instal·lar en una ubicació on el <app>Devhelp</app> pugui trobar-lo.

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:
ca: El <app>Devhelp</app> utilitza l'<link href="https://specifications.freedesktop.org/basedir-spec/latest/">especificació del directori base XDG</link> per a trobar els llibres. La llista d'ubicacions on es cerca és:

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.
ca: Tingueu en compte que les dues darreres consisteixen en llistes de directoris on cercar. Els directoris se separen amb el caràcter <code>:</code>. Aquestes variables d'entorn solen venir configurades per l'entorn d'escriptori o la distribució.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
ca: Exemple d'ubicacions de fitxers d'índex amb <code>$XDG_DATA_HOME</code> en un sistema típic:

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>.
ca: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file> si el <app>Devhelp</app> s'inicia amb el <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:
ca: Exemple d'una ubicació d'un fitxer d'índex amb <code>$XDG_DATA_DIRS</code> en un sistema típic:

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.
ca: El <link href="https://www.gtk.org/gtk-doc/">GTK-Doc</link> és una eina per a generar documentació d'API a partir de comentaris afegits a codi C. L'utilitzen les biblioteques i aplicacions del GLib, el GTK i el GNOME.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
ca: El GTK-Doc instal·la la referència API d'un mòdul a:

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).
ca: Segueix el format de llibre compatible amb el <app>Devhelp</app>. Per tant, mitjançant el GTK-Doc, es pot navegar automàticament per la referència API al <app>Devhelp</app> (un cop instal·lada a la ubicació correcta, és clar).

note: (itstool) path: page/title
en: Search in the side panel
ca: Cerca al quadre lateral

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
ca: Com funciona la cerca al panel lateral.

note: (itstool) path: section/title
en: Case sensitivity
ca: Distinció entre majúscules i minúscules

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.
ca: La cerca distingeix entre majúscules i minúscules quan hi ha una lletra majúscula. Si els termes de cerca són tots en minúscules, la cerca no distingeix entre majúscules i minúscules. És com la característica «smartcase» present en alguns editors de text.

note: (itstool) path: section/title
en: Glob-style pattern matching
ca: Coincidència de patrons a l'estil del 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.
ca: Un terme de cerca pot ser un patró que contingui els comodins «*» i «?». «*» coincideix amb una cadena arbitrària i possiblement buida, i «?» coincideix amb un caràcter arbitrari.

note: (itstool) path: section/title
en: Several search terms
ca: Diversos termes de cerca

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).
ca: Podeu cercar amb diversos termes de cerca (separats per espais). Un símbol només coincidirà si <em>tots</em> els termes de cerca coincideixen individualment (no necessàriament en el mateix ordre d'aparició).

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.
ca: Tingueu en compte que és diferent de la cerca amb el comodí «*»: amb el comodí «*», les paraules clau han d'estar en el mateix ordre.

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).
ca: Per exemple, la cerca de «<input>aplicació finestra gtk</input>» coincideix tant amb «<code>obtenir_aplicació_finestra_gtk()</code>» com amb «<code>FinestraAplicacióGtk</code>» (entre altes símbols).

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>”.
ca: D'altra banda, la cerca de «<input>aplicació*finestra*gtk</input>» coincidirà amb «<code>obtenir_aplicació_finestra_gtk()</code>» però no amb «<code>FinestraAplicacióGtk</code>».
