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

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
sv: Bokformat

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.
sv: En ”bok” i <app>Devhelp</app> är API-dokumentationen för en modul eller ett paket (vanligen ett bibliotek). Denna sida beskriver formatet som en bok behöver följa för att <app>Devhelp</app> ska kunna känna igen 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:
sv: Innehållet i en bok placeras i en katalog (den katalogen innehåller bara en bok, den kan inte innehålla flera böcker). Katalogen består av:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
sv: HTML-sidor, samt möjligen CSS-filer, bilder o.s.v.;

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.
sv: En indexfil med filändelsen <file>*.devhelp2</file>, se <link xref="index-file-format"/> för mer 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.
sv: Begränsning: namnet på katalogen som <file>*.devhelp2</file>-filen är i och namnet på <file>*.devhelp2</file>-filen (minus filändelsen) måste överensstämma. Med andra ord ska den absoluta sökvägen till indexfilen sluta med <code>$boknamn/$boknamn.devhelp2</code> om bokkatalogen har namnet <code>$boknamn</code>. På det sättet känner <app>Devhelp</app> direkt till platsen för indexfilen om det vet namnet på katalogen.

note: (itstool) path: page/title
en: Index file format
sv: Indexfilformat

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
sv: Denna sida beskriver syftet och formatet för <file>*.devhelp2</file>-indexfiler.

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.
sv: En bok (se <link xref="book-format"/>) innehåller en indexfil. Indexfilen har filändelsen <file>.devhelp2</file> och har ett 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.
sv: Siffran ”2” i filändelsen <file>*.devhelp2</file> beror på att det är den andra versionen av filformatet. Den första versionen av formatet, med filändelsen <file>*.devhelp</file>, är föråldrad och stöd för den kan tas bort från <app>Devhelp</app> i framtiden. När <app>Devhelp</app> läser av filsystemet för att hitta böcker vid programstart så skriver det ett varningsmeddelande i terminalen för varje bok som använder ett föråldrat format.

note: (itstool) path: page/p
en: The index file mainly contains:
sv: Indexfilen innehåller främst:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
sv: Bokstrukturen (som en innehållsförteckning).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
sv: En lista över symboler (funktioner, typer, makron, signaler, egenskaper, …).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
sv: Dessa innehåller länkar till HTML-filerna för att nå motsvarande sidor och 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.
sv: I <app>Devhelp</app> visas bokstrukturen i sidopanelen. <link xref="search">Sökningen i sidopanelen</link> visar resultat som hittats i indexfilerna.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
sv: Specifikation för XML-filformatet för <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.
sv: Tyvärr är inte XML-filformatet för <file>*.devhelp2</file> väldokumenterat. Det finns fortfarande en förhoppning att detta ska lösas i en nära framtid. Under tiden rekommenderar vi att titta på vad <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link> genererar. För den mest precisa definitionen över vad <app>Devhelp</app> stöder kan du läsa källkoden för tolken och API-referensen för <app>Devhelp</app>.

[ctx: link:trail]
note: (itstool) path: info/title
en: Devhelp User Documentation
sv: Användardokumentation för Devhelp

[ctx: text]
note: (itstool) path: info/title
en: Devhelp User Documentation
sv: Användardokumentation för Devhelp

[ctx: link]
note: (itstool) path: info/title
en: Devhelp User Documentation
sv: Användardokumentation för Devhelp

note: (itstool) path: info/desc
en: Devhelp User Documentation
sv: Användardokumentation för Devhelp

note: (itstool) path: page/title
en: <_:media-1/> Devhelp User Documentation
sv: <_:media-1/> Användardokumentation för Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
sv: Devhelp är ett utvecklingsverktyg för att bläddra genom samt söka i API-dokumentation.

note: (itstool) path: page/title
en: Installing API documentation
sv: Installera API-dokumentation

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
sv: Hur <app>Devhelp</app> hittar 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.
sv: Se <link xref="book-format"/> för information om API-dokumentationsformatet som <app>Devhelp</app> känner igen.

note: (itstool) path: section/title
en: Books locations
sv: Bokplatser

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.
sv: När en bok följer rätt format så behöver dess katalog installeras på en plats där <app>Devhelp</app> kommer att hitta 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:
sv: <app>Devhelp</app> använder <link href="https://specifications.freedesktop.org/basedir-spec/latest/">XDG Base Directory-specifikationen</link> för att hitta böckerna. Listan över platser som söks igenom är:

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.
sv: Observera att de två senare består av listor av kataloger att söka efter. Katalogvärden separeras av tecknet <code>:</code>. Dessa miljövariabler ställs vanligen in av skrivbordsmiljön eller distributionen.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
sv: Exempel på platser för indexfiler med <code>$XDG_DATA_HOME</code> på ett typiskt 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>.
sv: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file> om <app>Devhelp</app> startas 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:
sv: Exempel på plats för en indexfil med <code>$XDG_DATA_DIRS</code> på ett typiskt 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.
sv: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> är ett verktyg för att skapa API-dokumentation från kommentarer som lagts till i C-kod. Det används av GLib, GTK samt GNOME-bibliotek och GNOME-program.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
sv: GTK-Doc installerar API-referensen för en modul till:

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).
sv: Det följer bokformatet som stöds av <app>Devhelp</app>. Så genom att använda GTK-Doc kan API-referensen automatiskt visas i <app>Devhelp</app> (så snart den installerats på rätt plats).

note: (itstool) path: page/title
en: Search in the side panel
sv: Sök inuti sidopanelen

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
sv: Hur sökning i sidopanelen fungerar.

note: (itstool) path: section/title
en: Case sensitivity
sv: Skiftlägeskänslighet

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.
sv: Sökningen är skiftlägeskänslig när det finns ett versalt tecken. Om söktermerna endast använder gemener är sökningen skiftlägesokänslig. Det fungerar som funktionen ”smartskiftläge” som finns i vissa textredigerare.

note: (itstool) path: section/title
en: Glob-style pattern matching
sv: Mönstermatchning med jokertecken

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.
sv: En sökterm kan vara ett mönster som innehåller jokertecknen ”*” och ”?”. ”*" matchar en godtycklig, eventuellt tom, sträng; och ”?” matchar ett godtyckligt tecken.

note: (itstool) path: section/title
en: Several search terms
sv: Flera söktermer

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).
sv: Du kan söka med flera söktermer (separerade av blanksteg). En symbol kommer endast att matcha om <em>alla</em> söktermerna matchar individuellt (inte nödvändigtvis i samma ordning som de förekommer).

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.
sv: Notera att detta är annorlunda än att söka med jokertecknet ”*”: med jokertecknet ”*” tvingas nyckelorden att vara i samma ordning.

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).
sv: När du till exempel söker efter ”<input>gtk window application</input>” matchar detta både ”<code>gtk_window_get_application()</code>” och ”<code>GtkApplicationWindow</code>” (bland andra 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>”.
sv: Om du å andra sidan söker efter ”<input>gtk*window*application</input>” kommer ”<code>gtk_window_get_application()</code>” att matcha, men ”<code>GtkApplicationWindow</code>” kommer inte att göra det.
