devhelp gnome-3-30 - en to fr translation catalogue (47 entries)

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
fr: Format de livre

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.
fr: Dans <app>Devhelp</app>, un « livre » est la documentation d’API pour un module ou un paquet (généralement une bibliothèque). Cette page décrit le format dont le livre a besoin pour que <app>Devhelp</app> le reconnaisse.

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:
fr: Le contenu d’un livre est placé dans un répertoire (ce répertoire ne contient qu’un seul livre, et ne peut en contenir plusieurs). Le répertoire est composé :

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
fr: De pages HTML, plus éventuellement des fichiers CSS, des images, 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.
fr: D’un fichier de sommaire avec l’extension de fichier <file>*.devhelp2</file>. Consultez <link xref="index-file-format"/> pour plus d’informations.

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.
fr: Limitation : le nom du répertoire dans lequel se trouve le fichier <file>*.devhelp2</file> et le nom du fichier <file>*.devhelp2</file> (sans l’extension) doivent correspondre. En d’autres termes, si le répertoire du livre se nomme <code>$book_name</code>, alors le chemin absolu vers le fichier de sommaire doit se terminer par <code>$book_name/$book_name.devhelp2</code>. De cette façon, lorsque <app>Devhelp</app> connaît le nom du répertoire, il peut directement en déduire le nom du fichier sommaire.

note: (itstool) path: page/title
en: Index file format
fr: Format de fichier de sommaire

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
fr: Cette page décrit le but et le format des fichiers de sommaire <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.
fr: Un livre (voir <link xref="book-format"/>) contient un fichier de sommaire. Le fichier de sommaire possède l’extension <file>.devhelp2</file> et est écrit en 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.
fr: Le chiffre « 2 » dans l’extension de fichier <file>*.devhelp2</file> est dû au fait qu’il s’agit de la deuxième version du format de fichier. La première version du format, comportant l’extension de fichier <file>*.devhelp</file>, est obsolète et sa prise en charge dans <app>Devhelp</app> peut être supprimée à l’avenir. Au démarrage de l’application, lorsque <app>Devhelp</app> analyse le système de fichiers pour trouver des livres, il émet un message d’avertissement dans le terminal pour chaque livre qui utilise un format obsolète.

note: (itstool) path: page/p
en: The index file mainly contains:
fr: Le fichier de sommaire contient principalement :

note: (itstool) path: item/p
en: The book structure (like a table of contents).
fr: La structure du livre (comme une table des matières).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
fr: Une liste de symboles (fonctions, types, macros, signaux, propriétés…).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
fr: Ceux-ci contiennent des liens vers les fichiers HTML pour accéder aux pages et symboles correspondants.

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.
fr: Dans <app>Devhelp</app>, la structure du livre est affichée dans le panneau latéral. Quant à la <link xref="search">recherche dans le panneau latéral</link>, elle affiche les résultats trouvés dans les fichiers de sommaire.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
fr: Caractéristiques du format de fichier 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.
fr: Malheureusement, le format de fichier XML <file>*.devhelp2</file> est très peu documenté. Cela sera sans doute corrigé dans un futur proche. En attendant, nous vous recommandons de regarder ce que génère <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link>. Pour obtenir la définition la plus précise de ce que <app>Devhelp</app> prend en charge, lisez le code source de l’analyseur et la référence d’API de <app>Devhelp</app>.

[ctx: link:trail]
note: (itstool) path: info/title
en: Devhelp User Documentation
fr: Documentation utilisateur de Devhelp

[ctx: text]
note: (itstool) path: info/title
en: Devhelp User Documentation
fr: Documentation utilisateur de Devhelp

[ctx: link]
note: (itstool) path: info/title
en: Devhelp User Documentation
fr: Documentation utilisateur de Devhelp

note: (itstool) path: info/desc
en: Devhelp User Documentation
fr: Documentation utilisateur de Devhelp

note: (itstool) path: page/title
en: <_:media-1/> Devhelp User Documentation
fr: <_:media-1/> Documentation utilisateur de Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
fr: Devhelp est un outil de développement pour naviguer et rechercher dans les documentations d’API.

note: (itstool) path: page/title
en: Installing API documentation
fr: Installation des documentations d’API

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
fr: La méthode utilisée par <app>Devhelp</app> pour trouver les documentations 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.
fr: Consultez <link xref="book-format"/> pour obtenir des informations sur le format de documentation des API que <app>Devhelp</app> reconnaît.

note: (itstool) path: section/title
en: Books locations
fr: Emplacements des livres

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.
fr: Dès lors qu’un livre suit le bon format, son répertoire doit être installé à un emplacement dans lequel <app>Devhelp</app> peut le trouver.

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:
fr: <app>Devhelp</app> utilise les <link href="https://specifications.freedesktop.org/basedir-spec/latest/">caractéristiques du répertoire de base de XDG</link> pour trouver les livres. Voici la liste des emplacements recherché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.
fr: Notez que les deux derniers sont constitués de listes de répertoires à rechercher. Les valeurs de répertoire sont séparées par des caractères <code>:</code> (deux-points). Ces variables d’environnement sont normalement configurées par l’environnement de bureau ou la distribution.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
fr: Exemples d’emplacements de fichiers de sommaire avec <code>$XDG_DATA_HOME</code> sur un système typique :

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>.
fr: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file> si <app>Devhelp</app> est lancé avec <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:
fr: Exemple d’emplacement d’un fichier de sommaire avec <code>$XDG_DATA_DIRS</code> sur un système typique :

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.
fr: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> est un outil qui permet de générer une documentation d’API à partir des commentaires ajoutés au code C. Il est utilisé par les bibliothèques et applications GLib, GTK et GNOME.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
fr: GTK-Doc installe les références d’API d’un module dans :

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).
fr: Il suit le format de livre pris en charge par <app>Devhelp</app>. Ainsi, en utilisant GTK-Doc, les références d’API peuvent être parcourues dans <app>Devhelp</app> automatiquement (une fois installée au bon endroit).

note: (itstool) path: page/title
en: Search in the side panel
fr: Recherche dans le panneau latéral

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
fr: Fonctionnement de la recherche dans le panneau latéral.

note: (itstool) path: section/title
en: Case sensitivity
fr: Sensibilité à la casse

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.
fr: La recherche est sensible à la casse lorsqu’il y a une lettre majuscule. Si les termes de recherche sont tous en minuscules, la recherche est insensible à la casse. Ceci est similaire à la fonction « smartcase » (reconnaissance intelligente de la casse) présente dans certains éditeurs de texte.

note: (itstool) path: section/title
en: Glob-style pattern matching
fr: Correspondances de motif de style 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.
fr: Un terme de recherche peut être un motif contenant des caractères génériques tels que « * » et « ? ». « * » correspond à une chaîne arbitraire, éventuellement vide ; « ? » correspond à un caractère arbitraire.

note: (itstool) path: section/title
en: Several search terms
fr: Termes de recherche multiples

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).
fr: Vous pouvez effectuer une recherche avec plusieurs termes de recherche (séparés par des espaces). Un symbole correspondra uniquement si <em>tous</em> les termes de recherche correspondent individuellement (pas nécessairement dans le même ordre d’affichage).

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.
fr: Il est à noter que la recherche est différente avec le caractère générique « * » : en effet, le caractère générique « * » oblige les mots-clés à être placés dans le même 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).
fr: Par exemple, lors de la recherche « <input>gtk window application</input> », cela peut correspondre à « <code>gtk_window_get_application()</code> » et « <code>GtkApplicationWindow</code> » (entre autres symboles).

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>”.
fr: D’autre part, la recherche « <input>gtk*window*application</input> » pourra correspondre à « <code>gtk_window_get_application()</code> » mais pas « <code>GtkApplicationWindow</code> ».
