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

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
cs: Formát knihy

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.
cs: Knihou se v pojetí aplikace <app>Devhelp</app> míní dokumentace k API pro jeden modul nebo balíček (obvykle knihovnu). Tato stránka popisuje formát takovéto knihy, kterého je zapotřebí se držet, aby ji <app>Devhelp</app> rozpoznal.

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:
cs: Obsah knihy je umístěný v jedné složce (tato složka obsahuje právě jednu knihu, nemůže jich obsahovat více). Obsah této složky sestává z:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
cs: stránek HTML, plus soubory CSS, obrázky atd.

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.
cs: indexového souboru s příponou <file>*.devhelp2</file>, více informací viz <link xref="index-file-format"/>

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.
cs: Omezení: název složky se souborem <file>*.devhelp2</file> a název samotného souboru <file>*.devhelp2</file> musí být stejné (myšleno bez přípony). Jinak řečeno, pokus se složka knihy nazývá <code>$nazev_knihy</code>, pak absolutní cesta k indexovému souboru by měla končit <code>$nazev_knihy/$nazev_knihy.devhelp2</code>. Díky tomu, když <app>Devhelp</app> zná název složky, zná i přímo umístění indexového souboru.

note: (itstool) path: page/title
en: Index file format
cs: Formát indexového souboru

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
cs: Tato stránka popisuje účel a formát indexových souborů <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.
cs: Kniha (viz <link xref="book-format"/>) obsahuje jeden indexový soubr. Indexový soubor má příponu <file>.devhelp2</file> a formát  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.
cs: „2“ v příponě souboru <file>*.devhelp2</file> je proto, že se jedná o druhou verzi tohoto souborového formátu. První verze s příponou <file>*.devhelp</file> je označená za zastaralou a její podpora v aplikaci <app>Devhelp</app> může být v budoucnu odstraněna. Při spuštění aplikace, kdy <app>Devhelp</app> prohledává souborový systém na výskyt knih, vysílá do terminálu varovné zprávy pro každou knihu, která používá zastaralý formát.

note: (itstool) path: page/p
en: The index file mainly contains:
cs: Indexový soubor obsahuje zejména:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
cs: Strukturu knihy (obdoba obsahu knihy).

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
cs: Seznam symbolů (funkce, typy, makra, signály, vlastnosti, …).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
cs: Ty pak obsahují odkazy na jednotlivé soubory HTML, díky čemuž se dá dostat na příslušnou stránku a symbol.

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.
cs: Struktura knihy je v aplikaci <app>Devhelp</app> zobrazená v postranním panelu. A <link xref="search">hledání v postranním panelu</link> zobrazuje výsledky nalezené v indexovém souboru.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
cs: Specifikace souborového formátu 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.
cs: Naneštěstí souborový formát XML <file>*.devhelp2</file> není příliš dobře zdokumentován. Je tu ale šance, že se to do budoucna zlepší. Než se tak stane, doporučujeme podívat se, co generuje <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link>. Podrobnější definice, co <app>Devhelp</app> podporuje, pak můžete zjistit čtením jeho zdrojového kódu a referenční příručky k API <app>Devhelp</app>.

[ctx: link:trail]
note: (itstool) path: info/title
en: Devhelp User Documentation
cs: Uživatelská dokumentace k aplikaci Devhelp

[ctx: text]
note: (itstool) path: info/title
en: Devhelp User Documentation
cs: Uživatelská dokumentace k aplikaci Devhelp

[ctx: link]
note: (itstool) path: info/title
en: Devhelp User Documentation
cs: Uživatelská dokumentace k aplikaci Devhelp

note: (itstool) path: info/desc
en: Devhelp User Documentation
cs: Uživatelská dokumentace k aplikaci Devhelp

note: (itstool) path: page/title
en: <_:media-1/> Devhelp User Documentation
cs: <_:media-1/> Uživatelská dokumentace k aplikaci Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
cs: Devhelp je vývojářský nástroj pro procházení a vyhledávání v dokumentaci k API.

note: (itstool) path: page/title
en: Installing API documentation
cs: Instalace dokumentace k API

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
cs: Jak <app>Devhelp</app> hledá v dokumentaci API.

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
cs: Viz <link xref="book-format"/> ohledně informací o formátu dokumentace k API, který <app>Devhelp</app> rozpoznává.

note: (itstool) path: section/title
en: Books locations
cs: Umístění knih

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.
cs: Jakmile má kniha správný formát, musí být její složka nainstalována do umístění, ve kterém ji <app>Devhelp</app> najde.

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:
cs: <app>Devhelp</app> používá k nalezení knih <link href="https://specifications.freedesktop.org/basedir-spec/latest/">Specifikaci základních složek XDG</link> (odkaz je v angličtině). Zde je seznam prohledávaných umístění:

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.
cs: Všimněte si, že dvě poslední jsou ve skutečnosti seznamy složek, ve kterých se hledá. Názvy složek jsou oddělené znakem <code>:</code>. Tyto proměnné prostředí normálně nastaví pracovní prostředí nebo distribuce.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
cs: Příklad umístění pro indexové soubory s <code>$XDG_DATA_HOME</code> na typickém systému:

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>.
cs: Soubor <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file>, pokud je <app>Devhelp</app> spuštěný v izolovaném prostředí <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:
cs: Příklad umístění pro indexové soubory s <code>$XDG_DATA_HOME</code> na typickém systému:

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.
cs: <link href="https://gitlab.gnome.org/GNOME/gtk-doc">GTK-Doc</link> je nástroj pro generování dokumentace k API z komentářů ve zdrojových kódech jazyka C. Používají jej GLib, GTK a knihovny a aplikace GNOME

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
cs: GTK-Doc instaluje referenční příručku k API modulu do:

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).
cs: Řídí se formátem knihy, který podporuje <app>Devhelp</app>. Takže, když použijete GTK-Doc, lze pak automaticky referenční příručku k API procházet pomocí aplikace <app>Devhelp</app> (za předpokladu, že je nainstalována ve správném umístění).

note: (itstool) path: page/title
en: Search in the side panel
cs: Hledání v postranním panelu

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
cs: Jak funguje hledání v postranním panelu.

note: (itstool) path: section/title
en: Case sensitivity
cs: Rozlišování velikosti písmen

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.
cs: Při hledání se bere ohled na velikost písmen, když se ve výrazu objeví velké písmeno. Pokud jsou v hledaném výrazu jen samá malá písmena, nebere se velikost písmen při hledání v úvahu. Je to podobné, jako inteligentní práce s velikostí písmen v textových editorech, tzv. funkce „smartcase“.

note: (itstool) path: section/title
en: Glob-style pattern matching
cs: Porovnávání podle globálního stylu vzorů

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.
cs: Hledaný výraz může být vzor obsahující divoké znaky „*“ a „?“. „*“ vyhovuje cokoliv, včetně prázdného řetězce a „?“ vyhovuje právě jeden libovolný znak.

note: (itstool) path: section/title
en: Several search terms
cs: Hledání několika výrazů

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).
cs: Můžete hledat několik výrazů naráz (oddělených mezerami). Symbol vyhoví hledání jen v případě, že se jednotlivě shodují <em>všechny</em> hledané výrazy (ne nutně ve stejném pořadí, jak byly zadány).

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.
cs: Pamatujte, že se to liší od hledání pomocí divokého znaku „*“: divoký znak „*“ si vynutí, aby byla klíčová slova ve stejném pořadí.

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).
cs: Například, když hledáte „<input>gtk window application</input>“, bude tomu vyhovovat „<code>gtk_window_get_application()</code>“ a „<code>GtkApplicationWindow</code>“ (mimo jiné).

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>”.
cs: Na druhou stranu, hledání „<input>gtk*window*application</input>“ bude vyhovovat „<code>gtk_window_get_application()</code>“, ale „<code>GtkApplicationWindow</code>“ už ne.
