calibre - en to pl translation catalogue (46 entries)

en: Function mode for Search & replace in the Editor
pl: Tryb funkcji Wyszukaj i zamień w Edytorze

en: Techniques for using function mode and the syntax will be described by means of examples, showing you how to create functions to perform progressively more complex tasks.
pl: Techniki wykorzystania trybu funkcji oraz używana do tego składnia zostaną przedstawione w serii przykładów, pokazując jak tworzyć funkcje, by wykonywać coraz bardziej złożone zadania.

en: Automatically fixing the case of headings in the document
pl: Automatyczne poprawianie wielkości liter w nagłówkach dokumentu

en: Here, we will leverage one of the builtin functions in the editor to automatically change the case of all text inside heading tags to title case::
pl: Tu wykorzystamy jedną z wbudowanych funkcji edytora do automatycznej zmiany wielkości liter we wszystkich znacznikach tytułów tak, by każda pierwsza litera wyrazu była wielka::

en: Your first custom function - smartening hyphens
pl: Twoja pierwsza własna funkcja - poprawianie myślników

en: The real power of function mode comes from being able to create your own functions to process text in arbitrary ways. The Smarten Punctuation tool in the editor leaves individual hyphens alone, so you can use the this function to replace them with em-dashes.
pl: Prawdziwy potencjał trybu funkcji ujawnia się wraz z możliwością pisania własnych funkcji do dowolnego przetwarzania tekstu. Inteligentna Interpunkcja w edytorze pozostawia pojedyncze myślniki, możesz jej więc użyć do zamiany ich na znak pauzy.

en: Use this function with the find regular expression::
pl: Użyj tej funkcji z wyrażeniem regularnym:

en: And it will replace all hyphens with em-dashes, but only in actual text and not inside HTML tag definitions.
pl: Zamieni ona wszystkie myślniki na pauzy, ale tylko we właściwym tekście, nie wewnątrz definicji znaczników.

en: The power of function mode - using a spelling dictionary to fix mis-hyphenated words
pl: Potęga trybu funkcji - użycie słownika do poprawienia błędnie podzielonych słów.

en: Use this function with the same find expression as before, namely::
pl: Użyj tej funkcji z tym samym poszukiwanym wyrażeniem jak poprzednio, mianowicie::

en: And it will magically fix all mis-hyphenated words in the text of the book. The main trick is to use one of the useful extra arguments to the replace function, ``dictionaries``.  This refers to the dictionaries the editor itself uses to spell check text in the book. What this function does is look for words separated by a hyphen, remove the hyphen and check if the dictionary recognizes the composite word, if it does, the original words are replaced by the hyphen free composite word.
pl: W magiczny sposób poprawi to wszystkie błędnie podzielone słowa w tekście. Trik polega na użyciu jednego z argumentów funkcji, ``dictionaries``. Stanowi on odniesienie do słowników, których używa edytor do sprawdzania pisowni. Funkcja odszukuje słowo z myślnikiem w środku, usuwa ów myślnik i sprawdza, czy tak połączony wyraz jest w słowniku. Jeśli tak to oryginalny wyraz jest zastępowany nowym, połączonym.

en: Note that one limitation of this technique is it will only work for mono-lingual books, because, by default, ``dictionaries.recognized()`` uses the main language of the book.
pl: Należy pamiętać, że działanie tej funkcji jest ograniczone do książek w jednym języku, bowiem domyślnie ``dictionaries.recognized()`` używa głównego języka książki.

en: Auto numbering sections
pl: Autonumerowanie rozdziałów

en: Now we will see something a little different. Suppose your HTML file has many sections, each with a heading in an :code:`<h2>` tag that looks like :code:`<h2>Some text</h2>`. You can create a custom function that will automatically number these headings with consecutive section numbers, so that they look like :code:`<h2>1. Some text</h2>`.
pl: Teraz coś innego. Przypuśćmy, że plik HTML ma wiele rozdziałów, każdy rozpoczynający się znacznikiem :code:`<h2>` w postaci :code:`<h2>Jakiś tekst</h2>`. Można napisać funkcję, która ponumeruje te rozdziały kolejnymi numerami, by wyglądały następująco: :code:`<h2>1. Jakiś tekst</h2>`.

en: Use it with the find expression::
pl: Użyj jej, wyszukując wyrażenie::

en: Place the cursor at the top of the file and click :guilabel:`Replace all`.
pl: Ustaw kursor na górze pliku i kliknij :guilabel:`Zamień wszystkie`

en: This function uses another of the useful extra arguments to ``replace()``: the ``number`` argument. When doing a :guilabel:`Replace All` number is automatically incremented for every successive match.
pl: Ta funkcja wykorzystuje inny przydatny argument funkcji ``replace()``: ``number``. Przy operacji :guilabel:`Zamień wszystkie` liczba jest automatycznie inkrementowana przy każdym dopasowaniu.

en: Another new feature is the use of ``replace.file_order`` -- setting that to ``'spine'`` means that if this search is run on multiple HTML files, the files are processed in the order in which they appear in the book. See :ref:`file_order_replace_all` for details.
pl: Kolejną nowością jest użycie ``replace.file_order`` -- ustawienie tej opcji na ``spine`` oznacza, że jeśli przeszukiwanych jest wiele plików to będą one przetwarzane w takiej kolejności, w jakiej występują w książce. Szczegóły znajdziesz w :ref:`file_order_replace_all`.

en: Auto create a Table of Contents
pl: Automatyczne tworzenie spisu treści

en: Finally, lets try something a little more ambitious. Suppose your book has headings in ``h1`` and ``h2`` tags that look like ``<h1 id="someid">Some Text</h1>``. We will auto-generate an HTML Table of Contents based on these headings. Create the custom function below:
pl: Na koniec spróbujmy czegoś bardziej ambitnego. Przypuśćmy, że w książce tytuły są w znacznikach ``h1`` i ``h2``, które wyglądają następująco: ``<h1 id="jakiesid">Jakiś tekst</h1>``. Wygenerujemy automatycznie spis treści w HTML, bazując na tych znacznikach. Stwórz funkcję jak poniżej:

en: And use it with the find expression::
pl: Użyj takiego szukanego wyrażenia::

en: Another new feature is the use of ``call_after_last_match`` -- setting that to ``True`` on the ``replace()`` function means that the editor will call ``replace()`` one extra time after all matches have been found. For this extra call, the match object will be ``None``.
pl: Kolejna rzecz to właściwość ``call_after_last_match`` -- ustawienie jej na ``True`` oznacza, że edytor wywoła funkcję ``replace()`` dodatkowo jeden raz po odnalezieniu wszystkich dopasowań. W tym wywołaniu obiekt dopasowania jest równy ``None``.

en: This was just a demonstration to show you the power of function mode, if you really needed to generate a Table of Contents from headings in your book, you would be better off using the dedicated Table of Contents tool in :guilabel:`Tools->Table of Contents`.
pl: To tylko demonstracja możliwości trybu funkcji, jeśli rzeczywiście chcesz wygenerować spis treści z nagłówków, lepiej będzie posłużyć się dedykowanym temu narzędziem :guilabel:`Narzędzia->Spis treści`.

en: The API for the function mode
pl: API trybu funkcji

en: When a find/replace is run, for every match that is found, the ``replace()`` function will be called, it must return the replacement string for that match. If no replacements are to be done, it should return ``match.group()`` which is the original string. The various arguments to the ``replace()`` function are documented below.
pl: Kiedy uruchamiane jest wyszukiwanie/zamiana, dla każdego odnalezionego dopasowania, dla którego zostanie wywołana funkcja ``replace()``, musi ona zwrócić tekst zastępujący owo dopasowanie. Jeśli zamiana nie zostanie wykonana, powinna zwrócić ``march.group()``, który jest oryginalnym tekstem. Różne argumenty funkcji ``replace()`` zostały opisane poniżej.

en: The ``match`` argument
pl: Argument ``match``

en: The ``number`` argument
pl: Argument ``number``

en: The ``number`` argument is the number of the current match. When you run :guilabel:`Replace All`, every successive match will cause ``replace()`` to be called with an increasing number. The first match has number 1.
pl: Argument ``number`` jest numerem aktualnego dopasowania. Kiedy uruchamiasz :guilabel:`Zamień wszystko`, każde kolejne dopasowanie będzie wywoływać ``replace()`` z następnym numerem. Pierwsze dopasowanie ma numer 1.

en: The ``file_name`` argument
pl: Argument ``file_name``

en: This is the filename of the file in which the current match was found. When searching inside marked text, the ``file_name`` is empty. The ``file_name`` is in canonical form, a path relative to the root of the book, using ``/`` as the path separator.
pl: To jest nazwa pliku, w którym odnaleziono bieżące dopasowanie. Przy wyszukiwaniu w zaznaczeniu ``file_name`` jest puste. ``file_name`` ma postać kanonicznej względnej ścieżki, od katalogu głównego książki, do oddzielania katalogów służy ``/``.

en: The ``metadata`` argument
pl: Argument ``metadata``

en: This represents the metadata of the current book, such as title, authors, language, etc. It is an object of class :class:`calibre.ebooks.metadata.book.base.Metadata`. Useful attributes include, ``title``, ``authors`` (a list of authors) and ``language`` (the language code).
pl: Ten argument reprezentuje metadane aktualnej książki, takie jak tytuł, autor, język itp. Jest to obiekt klasy :class:`calibre.ebooks.metadata.book.base.Metadata`. Najbardziej przydatne właściwości to ``title``, ``authors`` (lista autorów) i ``language`` (kod języka).

en: The ``dictionaries`` argument
pl: Argument ``dictionaries``

en: The ``data`` argument
pl: Argument ``data``

en: The ``functions`` argument
pl: Argument ``functions``

en: The ``functions`` argument gives you access to all other user defined functions. This is useful for code re-use. You can define utility functions in one place and re-use them in all your other functions. For example, suppose you create a function name ``My Function`` like this:
pl: Ten argument daje ci dostęp do wszystkich innych zdefiniowanych przez ciebie funkcji. Przydaje się to do wielokrotnego użycia tego samego kodu. Możesz zdefiniować jakąś funkcję w jednym miejscu i wykorzystać ją w innych twoich funkcjach. Na przykład przypuśćmy, że stworzyłeś taką funkcję o nazwie ``My function``:

en: Then, in another function, you can access the ``utility()`` function like this:
pl: Potem, w innej funkcji, możesz uzyskać dostęp do ``utility()`` w ten sposób:

en: You can also use the functions object to store persistent data, that can be re-used by other functions. For example, you could have one function that when run with :guilabel:`Replace All` collects some data and another function that uses it when it is run afterwards. Consider the following two functions:
pl: Można również użyć funkcji do przechowywania trwałych danych, które mogą być ponownie wykorzystane przez inne funkcje. Na przykład jedna funkcja zbiera dane przy uruchomieniu :guilabel:`Zamień wszystko`, a następna, uruchomiona później, wykorzystuje je. Przyjrzyjmy się dwóm następującym funkcjom:

en: Debugging your functions
pl: Debugowanie twoich funkcji

en: Choose file order when running on multiple HTML files
pl: Wybierz kolejność plików, jeśli przetwarzanych jest wiele plików HTML

en: ``file_order`` accepts two values, ``spine`` and ``spine-reverse`` which cause the search to process multiple files in the order they appear in the book, either forwards or backwards, respectively.
pl: ``file_order`` może przyjąć dwie wartości, ``spine`` i ``spine-reverse``, które powodują przeszukanie plików, odpowiednio, w kolejności w jakiej są wyświetlane lub odwrotnie.

en: Having your function called an extra time after the last match is found
pl: Dodatkowe wywołanie funkcji po znalezieniu ostatniego dopasowania

en: Sometimes, as in the auto generate table of contents example above, it is useful to have your function called an extra time after the last match is found. You can do this by setting the ``call_after_last_match`` attribute on your function, like this:
pl: Czasem, jak w przykładzie ze spisem treści powyżej, przydatne jest wywołanie funkcji dodatkowo, po ostatnim dopasowaniu. Można to zrobić, ustawiając właściwość ``call_after_last_match``, o, tak:

en: Appending the output from the function to marked text
pl: Dołączanie wyniku z funkcji do zaznaczonego tekstu

en: Suppressing the result dialog when performing searches on marked text
pl: Pomija okno dialogowe wyników podczas wyszukiwania zaznaczonego tekstu

en: More examples
pl: Więcej przykładów
