devhelp-help - en to pl translation catalogue (43 entries)

note: (itstool) path: page/title (itstool) path: section/title
en: Book format
pl: Format książki

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.
pl: „Książka” w programie <app>Devhelp</app> to dokumentacja API dla jednego modułu lub pakietu (zwykle biblioteki). Ta strona opisuje format, jakiego książka musi używać, aby <app>Devhelp</app> ją rozpoznał.

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:
pl: Treść książki mieści się w jednym katalogu (ten katalog zawiera tylko jedną książkę, nie może zawierać kilku). Składa się on z:

note: (itstool) path: item/p
en: HTML pages, plus possibly CSS files, images, etc;
pl: stron HTML plus możliwe pliki CSS, obrazy itp.,

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.
pl: pliku indeksu z rozszerzeniem <file>*.devhelp2</file>. <link xref="index-file-format"/> zawiera więcej informacji.

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.
pl: Ograniczenie: nazwa katalogu, w którym znajduje się plik <file>*.devhelp2</file> i nazwa pliku <file>*.devhelp2</file> (minus rozszerzenie) muszą się zgadzać. Innymi słowy, jeśli katalog z książką ma nazwę <code>$nazwa_książki</code>, to bezwzględna ścieżka do pliku indeksu musi kończyć się <code>$nazwa_książki/$nazwa_książki.devhelp2</code>. W ten sposób jeśli <app>Devhelp</app> zna nazwę katalogu, to bezpośrednio zna także położenie pliku indeksu.

note: (itstool) path: page/title
en: Index file format
pl: Format pliku indeksu

note: (itstool) path: synopsis/p
en: This page describes the purpose and the format of <file>*.devhelp2</file> index files.
pl: Ta strona opisuje przeznaczenie i format plików indeksów <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.
pl: Książka (patrz: <link xref="book-format"/>) zawiera jeden plik indeksu. Ma on rozszerzenie <file>.devhelp2</file> i jest w formacie 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.
pl: „2” jest w rozszerzeniu <file>*.devhelp2</file>, ponieważ to druga wersja tego formatu. Pierwsza wersja, o rozszerzeniu <file>*.devhelp</file>, jest przestarzała i jej obsługa w programie <app>Devhelp</app> może zostać usunięta w przyszłości. Podczas włączania programu, kiedy <app>Devhelp</app> wyszukuje książki w systemie plików, w terminalu emitowany jest komunikat ostrzeżenia dla każdej książki używającej przestarzałego formatu.

note: (itstool) path: page/p
en: The index file mainly contains:
pl: Plik indeksu zawiera głównie:

note: (itstool) path: item/p
en: The book structure (like a table of contents).
pl: strukturę książki (spis treści i podobne),

note: (itstool) path: item/p
en: A list of symbols (functions, types, macros, signals, properties, …).
pl: listę symboli (funkcje, typy, makra, sygnały, właściwości…).

note: (itstool) path: page/p
en: These contain links to the HTML files to reach the corresponding pages and symbols.
pl: Te zawierają odnośniki do plików HTML, aby móc otwierać odpowiednie strony i symbole.

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.
pl: W programie <app>Devhelp</app> struktura książki jest wyświetlana w panelu bocznym. A <link xref="search">wyszukiwanie w panelu bocznym</link> wyświetla wyniki z plików indeksów.

note: (itstool) path: section/title
en: Specification of the <file>*.devhelp2</file> XML file format
pl: Specyfikacja formatu pliku 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.
pl: Niestety format pliku XML <file>*.devhelp2</file> nie ma dobrej dokumentacji. Być może zostanie to naprawione w niedalekiej przyszłości. W międzyczasie zalecamy korzystać z wyników działania <link xref="installing-api-documentation#gtk-doc">GTK-Doc</link>. Kod źródłowy parsera i referencja API programu <app>Devhelp</app> najdokładniej określa, co on obsługuje.

note: (itstool) path: page/title
en: Devhelp User Documentation
pl: Dokumentacja programu Devhelp

note: (itstool) path: synopsis/p
en: Devhelp is a developer tool for browsing and searching API documentation.
pl: Devhelp to narzędzie programistyczne do przeglądania i przeszukiwania dokumentacji API.

note: (itstool) path: page/title
en: Installing API documentation
pl: Instalowanie dokumentacji API

note: (itstool) path: synopsis/p
en: How <app>Devhelp</app> finds the API documentation.
pl: Jak <app>Devhelp</app> znajduje dokumentację API.

note: (itstool) path: section/p
en: See <link xref="book-format"/> for information on the API documentation format that <app>Devhelp</app> recognizes.
pl: <link xref="book-format"/> zawiera informacje o formacie dokumentacji API rozpoznawanym przez program <app>Devhelp</app>.

note: (itstool) path: section/title
en: Books locations
pl: Położenia książek

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.
pl: Kiedy książka używa już właściwego formatu, jej katalog musi zostać zainstalowany w położeniu, w którym <app>Devhelp</app> ją znajdzie.

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:
pl: <app>Devhelp</app> używa <link href="https://specifications.freedesktop.org/basedir-spec/latest/">Specyfikacji podstawowych katalogów XDG</link> do wyszukiwania książek. Lista przeszukiwanych położeń:

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.
pl: Zauważ, że dwa ostatnie składają się z list katalogów do wyszukiwania. Katalogi są rozdzielone znakiem <code>:</code>. Te zmienne środowiskowe są zwykle konfigurowane przez środowisko pulpitu lub dystrybucję.

note: (itstool) path: section/p
en: Examples of locations to index files with <code>$XDG_DATA_HOME</code> on a typical system:
pl: Przykłady położeń plików indeksów ze zmienną <code>$XDG_DATA_HOME</code> w typowym systemie:

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>.
pl: <file>~/.var/app/org.gnome.Devhelp/data/devhelp/books/glib/glib.devhelp2</file>, jeśli <app>Devhelp</app> został uruchomiony za pomocą pakietu <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:
pl: Przykład położenia pliku indeksu ze zmienną <code>$XDG_DATA_HOME</code> w typowym systemie:

note: (itstool) path: section/p
en: <link href="https://www.gtk.org/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.
pl: <link href="https://www.gtk.org/gtk-doc/">GTK-Doc</link> to narzędzie do tworzenia dokumentacji API z komentarzy dodanych do kodu w języki C. Jest używane przez biblioteki GLib, GTK i programy GNOME.

note: (itstool) path: section/p
en: GTK-Doc installs the API reference of a module into:
pl: GTK-Doc instaluje referencje API modułu 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).
pl: Używa formatu książki obsługiwanego przez <app>Devhelp</app>. W ten sposób używając GTK-Doc można automatycznie przeglądać referencje API w programie <app>Devhelp</app> (po zainstalowaniu ich w odpowiednim położeniu).

note: (itstool) path: page/title
en: Search in the side panel
pl: Wyszukiwanie w bocznym panelu

note: (itstool) path: synopsis/p
en: How the search in the side panel works.
pl: Jak działa wyszukiwanie w panelu bocznym.

note: (itstool) path: section/title
en: Case sensitivity
pl: Rozróżnianie wielkości znaków

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.
pl: Wyszukiwanie rozróżnia wielkość znaków, kiedy zawarta jest wielka litera. Jeśli wszystkie terminy wyszukiwania są w małych znakach, to wyszukiwanie nie rozróżnia wielkości znaków. Jest to podobne do funkcji „inteligentna wielkość znaków” obecnej w niektórych edytorach tekstu.

note: (itstool) path: section/title
en: Glob-style pattern matching
pl: Dopasowywanie wzorów

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.
pl: Termin wyszukiwania może być wzorem zawierającym wieloznaczniki „*” i „?”. „*” dopasowuje dowolny, także pusty, ciąg, a  „?” dopasowuje dowolny znak.

note: (itstool) path: section/title
en: Several search terms
pl: Kilka terminów wyszukiwania

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).
pl: Można wyszukiwać kilka terminów (oddzielonych spacjami). Symbol zostanie dopasowany tylko, jeśli <em>wszystkie</em> terminy wyszukiwania pasują indywidualnie (niekoniecznie w tej samej kolejności).

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.
pl: Zauważ, że to co innego niż wyszukiwanie za pomocą wieloznacznika „*”: wieloznacznik wymusza, aby słowa kluczowe były w tej samej kolejności.

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).
pl: Na przykład podczas wyszukiwania „<input>gtk window application</input>” dopasowane zostaną „<code>gtk_window_get_application()</code>” i „<code>GtkApplicationWindow</code>” (oraz inne 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>”.
pl: Z drugiej strony, wyszukiwanie „<input>gtk*window*application</input>” dopasuje „<code>gtk_window_get_application()</code>”, ale nie „<code>GtkApplicationWindow</code>”.
