devhelp main - en to hu translation catalogue (47 entries)

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
hu: Könyvformátum

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.
hu: A „könyv” a <app>Devhelp</app> alkalmazásban egy modul vagy csomag (általában egy programkönyvtár) API-dokumentációja. Ez az oldal leírja azt a formátumot, amelyet egy könyvnek követnie kell ahhoz, hogy a <app>Devhelp</app> felismerje azt.

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:
hu: Egy könyv tartalma egy könyvtárba kerül (ez a könyvtár csak egy könyvet tartalmaz, több könyvet nem tartalmazhat). A könyvtár a következőkből áll:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
hu: HTML-oldalak, illetve esetlegesen CSS-fájlok, képek stb.

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.
hu: Egy <file>*.devhelp2</file> fájlkiterjesztéssel rendelkező indexfájl. További információkért nézze meg az <link xref="index-file-format"/> fejezetet.

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.
hu: Korlátozás: a <file>*.devhelp2</file> fájlt tartalmazó könyvtár nevének és a <file>*.devhelp2</file> fájl nevének (a kiterjesztés nélkül) meg kell egyeznie. Más szóval, ha a könyv könyvtárának neve <code>$book_name</code>, akkor az indexfájl abszolút elérési útjának a <code>$book_name/$book_name.devhelp2</code> névvel kell végződnie. Így amikor a <app>Devhelp</app> megismeri a könyvtár nevét, közvetlenül tudja az indexfájl helyét.

note: (itstool) path: page/title
en: Index file format
hu: Az indexfájl formátuma

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
hu: Ez az oldal a <file>*.devhelp2</file> indexfájlok célját és formátumát mutatja be.

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.
hu: Egy könyv (lásd: <link xref="book-format"/>) egy indexfájlt tartalmaz. Az indexfájl <file>.devhelp2</file> kiterjesztéssel rendelkezik és XML-formátumú.

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.
hu: A „2” a <file>*.devhelp2</file> fájlkiterjesztésben azért van, mert ez a fájlformátum második verziója. A formátum első verziója a <file>*.devhelp</file> fájlkiterjesztéssel elavult, és a jövőben a támogatása eltávolításra kerülhet a <app>Devhelp</app> alkalmazásból. Az alkalmazás indításakor, amikor a <app>Devhelp</app> átvizsgálja a fájlrendszert a könyvek kereséséhez, egy figyelmeztető üzenetet ad ki a terminálban minden olyan könyvnél, amely elavult formátumot használ.

note: (itstool) path: page/p
en: The index file mainly contains:
hu: Az indexfájlban főként a következők találhatók:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
hu: A könyv szerkezete (egy tartalomjegyzékhez hasonlóan).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
hu: Szimbólumok listája (függvények, típusok, makrók, szignálok, tulajdonságok, …).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
hu: Ezek tartalmazzák a HTML-fájlokra mutató hivatkozásokat a megfelelő oldalak és szimbólumok eléréséhez.

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.
hu: A <app>Devhelp</app> alkalmazásban a könyv szerkezete az oldalsó panelen látható. A <link xref="search">keresés az oldalsó panelen</link> pedig az indexfájlokban talált eredményeket jeleníti meg.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
hu: A <file>*.devhelp2</file> XML-fájlformátum specifikációja

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.
hu: Sajnos a <file>*.devhelp2</file> XML-fájlformátum nem jól dokumentált. Még van némi remény, hogy a közeljövőben javítani fogják. Addig azt javasoljuk, hogy nézze meg, amit a <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link> előállít. A legpontosabb meghatározásához annak, hogy a <app>Devhelp</app> mit támogat, olvassa el a feldolgozó forráskódját és a <app>Devhelp</app> API-hivatkozását.

[ctx: link:trail]
note: (itstool) path: info/title
en: Devhelp User Documentation
hu: Devhelp felhasználói dokumentáció

[ctx: text]
note: (itstool) path: info/title
en: Devhelp User Documentation
hu: Devhelp felhasználói dokumentáció

[ctx: link]
note: (itstool) path: info/title
en: Devhelp User Documentation
hu: Devhelp felhasználói dokumentáció

note: (itstool) path: info/desc
en: Devhelp User Documentation
hu: Devhelp felhasználói dokumentáció

note: (itstool) path: page/title
en: <_:media-1/> Devhelp User Documentation
hu: <_:media-1/> Devhelp felhasználói dokumentáció

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
hu: A Devhelp egy fejlesztői eszköz az API-dokumentáció böngészéséhez és kereséséhez.

note: (itstool) path: page/title
en: Installing API documentation
hu: Az API-dokumentáció telepítése

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
hu: Hogyan találja meg a <app>Devhelp</app> az API-dokumentációt.

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
hu: A <app>Devhelp</app> által felismert API-dokumentáció formátumról szóló információkért nézze meg a <link xref="book-format"/> fejezetet.

note: (itstool) path: section/title
en: Books locations
hu: Könyvek helyei

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.
hu: Miután a könyv a megfelelő formátumot követi, a könyvtárát olyan helyre kell telepíteni, ahol a <app>Devhelp</app> megtalálja.

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:
hu: A <app>Devhelp</app> az <link href="https://specifications.freedesktop.org/basedir-spec/latest/">XDG alapkönyvtár specifikációját</link> használja a könyvek kereséséhez. A keresett helyek listája:

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.
hu: Vegye észre, hogy a két utóbbi a keresendő könyvtárak listájából áll. A könyvtárak értékeit <code>:</code> karakterek választják el egymástól. Ezeket a környezeti változókat általában az asztali környezet vagy a disztribúció állítja be.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
hu: Példák a <code>$XDG_DATA_HOME</code> útvonallal rendelkező indexfájlok helyeire egy tipikus rendszeren:

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>.
hu: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file>, ha a <app>Devhelp</app> alkalmazást <link href="https://flatpak.org/">Flatpak</link> használatával indították.

note: (itstool) path: section/p
en: Example of a location to an index file with <code>$XDG_DATA_DIRS</code> on a typical system:
hu: Példa egy <code>$XDG_DATA_DIRS</code> útvonallal rendelkező indexfájl helyére egy tipikus rendszeren:

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.
hu: A <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> egy olyan eszköz, amely API-dokumentációt állít elő a C kódhoz hozzáadott megjegyzésekből. A GLib, a GTK és a GNOME programkönyvtárak és alkalmazások használják.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
hu: A GTK-Doc egy modul API-hivatkozását ide telepíti:

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).
hu: A <app>Devhelp</app> által támogatott könyvformátumot követi. Így a GTK-Doc használatával az API-hivatkozás automatikusan böngészhető a <app>Devhelp</app> alkalmazásban (miután a megfelelő helyre lett telepítve).

note: (itstool) path: page/title
en: Search in the side panel
hu: Keresés az oldalpanelen

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
hu: Hogyan működik a keresés az oldalpanelen.

note: (itstool) path: section/title
en: Case sensitivity
hu: Kis- és nagybetű érzékenység

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.
hu: A keresés érzékeny a kis- és nagybetűkre, amikor nagybetű található. Ha a keresési kifejezés teljesen kisbetűs, akkor a keresés nem érzékeny a kis- és nagybetűkre. Ez olyan mint az „okos betűegyezés” funkció, amely megtalálható néhány szövegszerkesztőben.

note: (itstool) path: section/title
en: Glob-style pattern matching
hu: Glob-stílusú mintaillesztés

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.
hu: Egy keresési kifejezés lehet „*” és „?” helyettesítő karaktereket tartalmazó minta is. A „*” egy tetszőleges, akár üres karakterláncra, a „?” egy tetszőleges karakterre illeszkedik.

note: (itstool) path: section/title
en: Several search terms
hu: Több keresési kifejezés

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).
hu: Kereshet több keresési kifejezéssel is (szóközökkel elválasztva). Egy szimbólum csak akkor illeszkedik, ha az <em>összes</em> keresési kifejezés egyénileg illeszkedik (nem szükséges, hogy azonos sorrendű megjelenésük legyen).

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.
hu: Ne feledje, hogy ez eltérő a „*” helyettesítő karakterrel való kereséstől: a „*” helyettesítő karakterrel arra kényszeríti a kulcsszavakat, hogy ugyanolyan sorrendben legyenek.

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).
hu: Például amikor a „<input>gtk window application</input>” kifejezésre keres rá, akkor az illeszkedik mind a „<code>gtk_window_get_application()</code>”, mind a „<code>GtkApplicationWindow</code>” szövegre (egyéb szimbólumok mellett).

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>”.
hu: Másrészről a „<input>gtk*window*application</input>” keresése illeszkedni fog a „<code>gtk_window_get_application()</code>” szövegre, de nem illeszkedik a „<code>GtkApplicationWindow</code>” szövegre.
