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

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
de: Buchformat

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.
de: Ein »Buch« in <app>Devhelp</app> ist die API-Dokumentation für ein Modul oder Paket (in der Regel eine Bibliothek). Auf dieser Seite wird das Format beschrieben, dem ein Buch folgen muss, damit <app>Devhelp</app> es erkennt.

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:
de: Der Inhalt eines Buches wird in einem Ordner abgelegt (dieser Ordner enthält nur ein Buch, es kann nicht mehrere Bücher enthalten). Der Ordner besteht aus:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
de: HTML-Seiten, plus möglicherweise CSS-Dateien, Bilder, 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.
de: Eine Indexdatei mit der Dateierweiterung <file>*.devhelp2</file>. Lesen Sie <link xref="index-file-format"/> für weiterführende Informationen.

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.
de: Einschränkung: Der Name des Ordners, in dem sich die Datei <file>*.devhelp2</file> befindet, und der Name der Datei <file>*.devhelp2</file> (abzüglich der Erweiterung) müssen übereinstimmen. Mit anderen Worten, wenn der Buchordner <code>$Buchname</code> heißt, so sollte der absolute Pfad zur Indexdatei mit <code>$Buchname/$Buchname.devhelp2</code> enden. Wenn <app>Devhelp</app> den Ordnernamen kennt, kennt es auf diese Weise direkt den Speicherort der Indexdatei.

note: (itstool) path: page/title
en: Index file format
de: Indexdateiformat

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
de: Diese Seite beschreibt den Zweck und das Format von <file>*.devhelp2</file>-Indexdateien.

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.
de: Ein Buch (siehe <link xref="book-format"/>) enthält eine Indexdatei. Die Indexdatei hat die Erweiterung <file>.devhelp2</file> und ist im XML-Format.

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.
de: Die »2« in der <file>*.devhelp2</file> Dateierweiterung deutet an, dass es die zweite Version des Dateiformats ist. Die erste Version des Formats mit der Dateierweiterung <file>*.devhelp</file> ist veraltet und seine Unterstützung kann in der Zukunft aus <app>Devhelp</app> entfernt werden. Wenn <app>Devhelp</app> beim Anwendungsstart das Dateisystem nach Büchern durchsucht, gibt es im Terminal eine Warnmeldung für jedes Buch aus, das ein veraltetes Format verwendet.

note: (itstool) path: page/p
en: The index file mainly contains:
de: Die Indexdatei enthält hauptsächlich:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
de: Die Buchstruktur (ähnlich einem Inhaltsverzeichnis).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
de: Eine Liste von Symbolen (Funktionen, Typen, Makros, Signale, Eigenschaften …).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
de: Diese enthalten Verweise zu den HTML-Dateien, um die entsprechenden Seiten und Symbole zu erreichen.

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.
de: In <app>Devhelp</app> wird die Buchstruktur im Seitenbereich angezeigt. Und die <link xref="search"> Suche im Seitenbereich</link> zeigt die Ergebnisse in den Indexdateien.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
de: Spezifikation des <file>*.devhelp2</file>-XML-Dateiformats

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.
de: Leider ist das <file>*.devhelp2</file>-XML-Dateiformat nicht gut dokumentiert. Es besteht noch Hoffnung, dass dies in naher Zukunft behoben wird. In der Zwischenzeit empfehlen wir, sich anzusehen, was <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link> erstellt. Lesen Sie den Parser-Quellcode und die <app>Devhelp</app>-API-Referenz, um ziemlich detailliert zu erfahren, was <app>Devhelp</app> unterstützt.

[ctx: link:trail]
note: (itstool) path: info/title
en: Devhelp User Documentation
de: Benutzerhandbuch für Devhelp

[ctx: text]
note: (itstool) path: info/title
en: Devhelp User Documentation
de: Benutzerhandbuch für Devhelp

[ctx: link]
note: (itstool) path: info/title
en: Devhelp User Documentation
de: Benutzerhandbuch für Devhelp

note: (itstool) path: info/desc
en: Devhelp User Documentation
de: Benutzerhandbuch für Devhelp

note: (itstool) path: page/title
en: <_:media-1/> Devhelp User Documentation
de: <_:media-1/> Benutzerhandbuch für Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
de: Devhelp ist ein Entwicklerwerkzeug zum Stöbern und Durchsuchen der API-Dokumentation.

note: (itstool) path: page/title
en: Installing API documentation
de: Installieren der API-Dokumentation

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
de: So findet <app>Devhelp</app> die API-Dokumentation.

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
de: Lesen Sie <link xref="book-format"/> für Informationen zum API-Dokumentationsformat, das <app>Devhelp</app> erkennt.

note: (itstool) path: section/title
en: Books locations
de: Buchorte

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.
de: Sobald ein Buch dem richtigen Format folgt, muss sein Ordner an einem Ort installiert werden, an dem <app>Devhelp</app> es finden wird.

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:
de: <app>Devhelp</app> verwendet die <link href="https://specifications.freedesktop.org/basedir-spec/latest/">XDG-Basisverzeichnisspezifikation</link>, um die Bücher zu finden. Die Liste der durchsuchten Standorte lautet:

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.
de: Beachten Sie, dass die beiden letztgenannten Ordner aus einer Liste von Ordnern bestehen, nach denen gesucht werden soll. Ordnerwerte werden durch <code>:</code>-Zeichen getrennt. Diese Umgebungsvariablen werden normalerweise von der Arbeitsumgebung oder der Distribution eingerichtet.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
de: Beispiele für Speicherorte zum Indexieren von Dateien mir <code>$XDG_DATA_HOME</code> auf einem typischen System sind:

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>.
de: <file>-var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file>, wenn <app>Devhelp</app> mit <link href="https://flatpak.org/">Flatpak</link> gestartetwird.

note: (itstool) path: section/p
en: Example of a location to an index file with <code>$XDG_DATA_DIRS</code> on a typical system:
de: Beispiel für einen Speicherort zu einer Indexdatei mit <code>$XDG_DATA_DIRS</code> auf einem typischen System:

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.
de: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> ist ein Werkzeug zum Erstellen von API-Dokumentation aus Kommentaren, die C-Code hinzugefügt wurden. Es wird von GLib-, GTK- und GNOME-Bibliotheken und -Anwendungen verwendet.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
de: GTK-Doc installiert die API-Referenz eines Moduls nach:

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).
de: Es folgt dem Buchformat, das von <app>Devhelp</app> unterstützt wird. Mit GTK-Doc kann die API-Referenz in <app>Devhelp</app> also automatisch durchsucht werden (sobald sie einmal am richtigen Ort installiert ist).

note: (itstool) path: page/title
en: Search in the side panel
de: Suchen in der Seitenleiste

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
de: So funktioniert die Suche in der Seitenleiste.

note: (itstool) path: section/title
en: Case sensitivity
de: Berücksichtigung von Groß- und Kleinschreibung

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.
de: Bei der Suche werden Groß- oder Kleinschreibung berücksichtigt, wenn ein Großbuchstabe angegeben wird. Besteht der Suchbegriff nur aus Kleinbuchstaben, wird die Groß- oder Kleinschreibung ignoriert. Dies entspricht dem Verhalten des aus einigen Texteditoren bekannten »Smartcase«-Funktionsmerkmals.

note: (itstool) path: section/title
en: Glob-style pattern matching
de: Treffersuche im Glob-Stil

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.
de: Ein Suchbegriff kann ein Muster sein, das die Platzhalter »*« und »?« enthält. Das »*« entspricht einer willkürlichen, auch leeren Zeichenkette, während das »?« für ein einzelnes, willkürliches Zeichen steht.

note: (itstool) path: section/title
en: Several search terms
de: Mehrere Suchbegriffe

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).
de: Sie können nach mehreren Begriffen suchen (durch Leerzeichen getrennt). Ein Symbol wird nur dann angezeigt, wenn <em>alle</em> Suchbegriffe gefunden werden (nicht zwangsläufig in der gleichen Reihenfolge des Auftretens).

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.
de: Beachten Sie den Unterschied bei der Suche mit dem Platzhalter »*«: Dadurch wird erzwungen, dass die Schlüsselwörter in der gleichen Reihenfolge auftreten.

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).
de: Wenn Sie beispielsweise nach <input>gtk window application</input> suchen, werden sowohl <code>gtk_window_get_application()</code> als auch <code>GtkApplicationWindow</code> gefunden (und weitere Symbole).

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>”.
de: Andererseits liefert die Suche nach <input>gtk*window*application</input> auch <code>gtk_window_get_application()</code> als Ergebnis, aber nicht <code>GtkApplicationWindow</code>.
