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

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
da: Bogformat

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.
da: En “bog” i <app>Devhelp</app> er API-dokumentationen til et modul eller en pakke (typisk et bibliotek). Siden beskriver det format, som en bog skal følge for at <app>Devhelp</app> kan genkende den.

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:
da: Bogens indhold placeres i en mappe (mappen indeholder kun én bog, den kan ikke indeholdere flere bøger). Mappen består af:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
da: HTML-sider, plus eventuelle CSS-filer, billeder osv.

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.
da: En indeksfil med filendelsen <file>*.devhelp2</file>, se <link xref="index-file-format"/> for mere information.

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.
da: Restriktioner: navnet på den mappe som <file>*.devhelp2</file>-filen er i og navnet på <file>*.devhelp2</file>-filen (minus endelsen) skal passe sammen. Med andre ord, hvis bogmappen hedder <code>$book_name</code>, så skal den absolutte sti til indeksfilen slutte med <code>$book_name/$book_name.devhelp2</code>. På den måde når <app>Devhelp</app> kender mappens navn, så kender den direkte placeringen til indeksfilen.

note: (itstool) path: page/title
en: Index file format
da: Indeks-filformat

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
da: Siden beskriver formålet og formatet af indeksfilerne <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.
da: En bog (se <link xref="book-format"/>) indeholder en indeksfil. Indeksfilen har endelsen <file>.devhelp2</file> og har et 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.
da: “2” i filendelsen <file>*.devhelp2</file> er fordi det er den anden version af filformatet. Den første version af formatet med filendelsen <file>*.devhelp</file> er udgået og dens understøttelse kan blive fjernet fra <app>Devhelp</app> i fremtiden. Ved programopstart når <app>Devhelp</app> skanner filsystemet for at finde bøger, så udsender den en advarselsmeddelelse i terminalen for hver bog som bruger et format som er udgået.

note: (itstool) path: page/p
en: The index file mainly contains:
da: Indeksfilen indeholder primært:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
da: Bogstrukturen (såsom en indholdsfortegnelse).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
da: En liste over symboler (funktioner, typer, makroer, signaler, egenskaber …).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
da: De indeholder links til HTML-filerne til at nå de tilhørende sider og symboler.

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.
da: I <app>Devhelp</app> vises bogens struktur i sidepanelet. Og <link xref="search">søg i sidepanelet</link> viser de resultater som bliver fundet i indeksfilerne.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
da: Specifikationer til <file>*.devhelp2</file> XML-formatet

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.
da: Desværre er XML-filformatet til <file>*.devhelp2</file> ikke dokumenteret godt. Der er stadigvæk håb om at det bliver rettet i nær fremtid. I mellemtiden anbefaler vi dig at kigge på hvad <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link> genererer. For den mest præcise definition af hvad <app>Devhelp</app> understøtter kan du læse fortolkerens kildekode og API-referencen til <app>Devhelp</app>.

[ctx: link:trail]
note: (itstool) path: info/title
en: Devhelp User Documentation
da: Brugerdokumentation til Devhelp

[ctx: text]
note: (itstool) path: info/title
en: Devhelp User Documentation
da: Brugerdokumentation til Devhelp

[ctx: link]
note: (itstool) path: info/title
en: Devhelp User Documentation
da: Brugerdokumentation til Devhelp

note: (itstool) path: info/desc
en: Devhelp User Documentation
da: Brugerdokumentation til Devhelp

note: (itstool) path: page/title
en: <_:media-1/> Devhelp User Documentation
da: <_:media-1/> Brugerdokumentation til Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
da: Devhelp er et udviklerværktøj som bruges til at gennemse og søge i API-dokumentation.

note: (itstool) path: page/title
en: Installing API documentation
da: Installation af API-dokumentation

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
da: Sådan finder <app>Devhelp</app> API-dokumentationen.

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
da: Se <link xref="book-format"/> for information om API-dokumentationsformatet som <app>Devhelp</app> genkender.

note: (itstool) path: section/title
en: Books locations
da: Bøgernes placeringer

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.
da: Når en bog følger det rette format, så skal dens mappe være installeret på en placering hvor <app>Devhelp</app> kan finde den.

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:
da: <app>Devhelp</app> bruger <link href="https://specifications.freedesktop.org/basedir-spec/latest/">XDG Base Directory Specification</link> til at finde bøgerne. Listen over placeringer som søges er:

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.
da: Bemærk, at de to sidste består af lister med mapper, som der skal ledes efter. Miljøvariablerne adskilles af <code>:</code>-tegn. Miljøvariablerne er normalt sat op af skrivebordsmiljøet eller distributionen.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
da: Eksempler på placeringer til indeksfiler med <code>$XDG_DATA_HOME</code> på et typisk system:

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>.
da: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file> hvis <app>Devhelp</app> startes med <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:
da: Eksempel på en placering til en indeksfil med <code>$XDG_DATA_DIRS</code> på et typisk 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.
da: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> er et værktøj til at generere API-dokumentation fra kommentarer, som er tilføjet til C-kode. Det bruges af GLib-, GTK- og GNOME-biblioteker og -programmer.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
da: GTK-Doc installerer API-referencen for et modul i:

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).
da: Den følger bogformatet som understøttes af <app>Devhelp</app>. Så ved at bruge GTK-Doc kan API-referencen automatisk gennemses i <app>Devhelp</app> (altså når den er installeret i den rette placering).

note: (itstool) path: page/title
en: Search in the side panel
da: Søg i sidepanelet

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
da: Sådan virker søgningen i sidepanelet.

note: (itstool) path: section/title
en: Case sensitivity
da: Forskel på store/små bogstaver

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.
da: Søgningen skelner mellem store/små bogstaver når der er et stort bogstav. Hvis alle søgefraserne er med småt, så skelnes der ikke mellem store/små bogstaver. Det er ligesom “smartcase”-funktionen som findes i nogle tekstredigeringer.

note: (itstool) path: section/title
en: Glob-style pattern matching
da: Mønstergenkendelse i 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.
da: En søgefrase kan være et mønster som indeholder jokertegnene “*” og “?”. “*” matcher en vilkårlig, muligvis tom, streng, og “?” matcher et vilkårligt tegn.

note: (itstool) path: section/title
en: Several search terms
da: Flere søgefraser

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).
da: Du kan søge med flere søgefraser (adskilt af mellemrum). Et symbol matcher kun hvis <em>alle</em> søgefraserne individuelt matcher (ikke nødvendigvis i samme rækkefølge som de optræder).

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.
da: Bemærk at det ikke er det samme som at søge med jokertegnet “*”. Med jokertegnet “*” tvinger det nøgleordene til at være i den samme rækkefølge.

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).
da: Når der f.eks. søges efter “<input>gtk window application</input>”, så matcher den både “<code>gtk_window_get_application()</code>” og “<code>GtkApplicationWindow</code>” (blandt andre symboler).

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>”.
da: Modsat vil søgning efter “<input>gtk*window*application</input>” matche “<code>gtk_window_get_application()</code>” men ikke “<code>GtkApplicationWindow</code>”.
