calibre - en to pl translation catalogue (35 entries)

en: Snippets
pl: Wstawki

en: The calibre E-book editor supports *snippets*. A snippet is a piece of text that is either re-used often or contains a lot of redundant text. The editor allows you to insert a snippet with only a few key strokes. For example, suppose you often find yourself inserting link tags when editing HTML files, then you can simply type ``<a`` in the editor and press |ct|. The editor will expand it to::
pl: Edytor e-booków Calibre obsługuje *snippets*. Snippet to fragment tekstu, który jest często używany ponownie lub zawiera dużo zbędnego tekstu. Edytor pozwala na wstawienie fragmentu za pomocą kilku naciśnięć klawiszy. Załóżmy na przykład, że często wstawiasz znaczniki linków podczas edytowania plików HTML, wtedy możesz po prostu wpisać ``<a`` w edytorze i nacisnąć |ct|. Edytor rozszerzy go do:

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link.
pl: Mało tego, słowo ``filename`` zostanie zaznaczone, a kursor umieszczony zaraz za nim, pozwalając od razu wpisać właściwą nazwę pliku, używając bardzo wygodnej funkcji :ref:`editor_auto_complete`. Kiedy wpiszesz nazwę pliku, przyciśnij ponownie |ct|, a kursor przeskoczy do miejsca między znacznikami ``<a>``, żebyś mógł wpisać tekst odsyłacza.

en: The snippets system in the editor is very sophisticated, there are a few built-in snippets and you can create your own to suit your editing style.
pl: System wstawek jest bardzo wyrafinowany, istnieje kilka wbudowanych wstawek, możesz również tworzyć własne, dopasowując edytor do twoich potrzeb.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
pl: Poniższe omówienie wbudowanych wstawek powinno pomóc zilustrować możliwości tego systemu.

en: You can also use snippets in the text entry fields in the :guilabel:`Search & replace` panel, however, placeholders (using |ct| to jump around) will not work.
pl: Możesz także użyć fragmentów tekstu w polach wprowadzania tekstu w panelu :guilabel:`Wyszukaj i zamień`, jednak symbole zastępcze (używając |ct| do przeskakiwania) nie będą działać.

en: The built-in snippets
pl: Wbudowane wstawki

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
pl: Wbudowane wstawki zostały opisane poniżej. Możesz je nadpisać własnymi, jeśli ustawisz taki sam wyzwalacz - tekst, który uruchomi wstawkę.

en: Inserting filler text [Lorem]
pl: Wstawianie tekstu wypełniającego [Lorem]

en: The first built-in snippet, and the simplest is used to insert filler text into a document. The filler text is taken from `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ a philosophical work by Cicero (translated to English). To use it simply type ``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of paragraphs of filler.
pl: Pierwszy wbudowany fragment i najprostszy służy do wstawiania tekstu wypełniającego do dokumentu. Tekst wypełniający pochodzi z `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ pracy filozoficznej Cycerona (przetłumaczonej na język angielski). Aby go użyć, po prostu wpisz ``Lorem`` w pliku HTML i naciśnij |ct|. Zostanie zastąpiony kilkoma akapitami wypełniacza.

en: The definition of this snippet is very simple, the trigger text is defined as ``Lorem`` and the template is defined simply as the literal text to be inserted. You can easily customize it to use your favorite form of filler text.
pl: Definicja tej wstawki jest bardzo prosta, wyzwalacz to ``Lorem``, a szablon składa się wyłącznie z tekstu, który ma zostać umieszczony w dokumencie. Można go łatwo zmienić, zastępując tekst własnym.

en: Inserting a self-closing HTML tag [<>]
pl: Wstawianie pojedynczych znaczników HTML [<>]

en: Now let's look at a simple example of the powerful concept of *placeholders*. Say you want to insert the self-closing tag ``<hr/>``. Just type ``<>``, and press |ct|, the editor will expand the snippet to::
pl: Przyjrzyjmy się teraz prostemu przykładowi, który pozwoli zapoznać się z koncepcją ``symboli zastępczych``. Przypuśćmy, że chcesz wstawić pojedynczy znacznik ``<hr/>``. Wpisz po prostu ``<>`` i przyciśnij |ct|, a edytor rozwinie wstawkę do:

en: Here, the ``|`` symbol represents the current cursor position. You can then type ``hr`` and press |ct| to move the cursor to after the end of the tag. This snippet is defined as::
pl: W tym przypadku symbol ``|`` oznacza miejsce, w którym zostanie ustawiony kursor.  Możesz wpisać ``hr`` i wcisnąć ponownie |ct|, by przeskoczyć na koniec znacznika. Ta wstawka jest zdefiniowana następująco:

en: Placeholders are simply the dollar ($) sign followed by a number. When the snippet is expanded by pressing |ct| the cursor is positioned at the first placeholder (the placeholder with the lowest number). When you press |ct| again the cursor jumps to the next placeholder (the placeholder with the next higher number).
pl: Symbole zastępcze to po prostu znak dolara, po którym następuje liczba. Kiedy wstawka jest rozwijana, po wciśnięciu |ct|, kursor jest ustawiany w miejscu pierwszego symbolu (o najmniejszym numerze). Przy kolejnym wciśnięciu |ct| kursor przeskakuje do następnego symbolu (następnego o większym numerze).

en: Inserting an HTML link tag [<a]
pl: Wstawianie znacznika odsyłacza HTML [<a]

en: HTML link tags all share a common structure. They have an ``href`` attribute and some text between the opening and closing tags. A snippet to make typing them more efficient will introduce us to some more features of placeholders. To use this snippet, simply type ``<a`` and press |ct|. The editor will expand this to::
pl: Wszystkie znaczniki odsyłaczy mają tę samą strukturę. Mają atrybut ``href`` i jakiś tekst między otwierającym, a zamykającym znacznikiem. Wstawka umożliwiająca wpisanie znacznika odsyłacza pokaże kolejne możliwości symboli zastępczych. Aby użyć tej wstawki po prostu wpisz ``<a`` i wciśnij |ct|. Edytor rozwinie wstawkę do::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link. After you are done typing the text, press |ct| again to jump to the point after the closing tag.  This snippet is defined as::
pl: Mało tego, słowo ``filename`` zostanie zaznaczone, tak, że możesz łatwo wpisać prawdziwą nazwę pliku, korzystając przy okazji z użytecznej funkcji :ref:`editor_auto_complete`. Kiedy wpiszesz nazwę pliku przyciśnij ponownie |ct|, a kursor przeskoczy do miejsca pomiędzy znacznikami ``<a>``, byś mógł wpisać tekst odsyłacza. Następnie wciśnij |ct| jeszcze raz, by przesunąć kursor zaraz za znacznik zamykający. Wstawka jest zdefiniowana następująco::

en: There are a couple of new features here. First the ``$1`` placeholder has become more complex. It now includes some *default text* (the word ``filename``). If a placeholder contains default text, the default text is substituted for the placeholder when the snippet is expanded. Also when you jump to a placeholder with default text using |ct|, the default text is selected. In this way, you can use default text to act as a reminder to you to fill in important parts of the template. You can specify default text for a placeholder by using the syntax: ``${<number>:default text}``.
pl: Jest tu kilka nowych funkcji. Po pierwsze symbol zastępczy ``$1`` stał się bardziej złożony. Zawiera teraz trochę *domyślnego tekstu* (słowo ``filename``). Jeśli symbol zastępczy zawiera tekst domyślny, tekst domyślny jest zastępowany symbolem zastępczym, gdy fragment kodu jest rozwijany. Również po przejściu do symbolu zastępczego z domyślnym tekstem za pomocą |ct|, domyślny tekst zostanie zaznaczony. W ten sposób możesz użyć domyślnego tekstu jako przypomnienia o wypełnieniu ważnych części szablonu. Możesz określić domyślny tekst dla symbolu zastępczego, używając składni: ``${<number>:tekst domyślny}``.

en: The other new feature is that the second placeholder has an asterisk after it (``${2*}``). This means that any text that was selected before expanding the template is substituted for the placeholder. To see this in action, select some text in the editor, press |ct|, type ``<a`` and press |ct| again, the template will be expanded to::
pl: Kolejna nowość to fakt, że po drugim symbolu jest gwiazdka (``${2*}``). Oznacza to, że jeśli był zaznaczony jakiś tekst przed wywołaniem wstawki to zostanie on umieszczony w miejscu tego symbolu. Aby zobaczyć jak to wygląda, zaznacz jakiś fragment tekstu w edytorze, przyciśnij |ct|, wpisz ``<a`` i przyciśnij |ct| ponownie. Szablon zostanie rozwinięty do::

en: Inserting a HTML image tag [<i]
pl: Wstawianie znacznika obrazu [<i]

en: This is very similar to inserting an HTML link, as we saw above. It allows you to quickly input an ``<img src="filename" alt="description" />`` tag and jump between the ``src`` and ``alt`` attributes::
pl: Wstawka ta jest bardzo podobna do odsyłacza, który pokazano wyżej. Umożliwia szybkie wprowadzenie znacznika ``<img src="filename" alt="description" />`` i przeskakiwanie między atrybutami ``src`` i ``alt``::

en: Insert an arbitrary HTML tag [<<]
pl: Wstawianie znacznika HTML [<<]

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
pl: Wpisz nazwę znacznika, na przykład ``span`` i przyciśnij |ct|, powinieneś w rezultacie otrzymać::

en: You will note that the closing tag has been automatically filled with ``span``. This is achieved with yet another feature of placeholders, *mirroring*. Mirroring simply means that if you specify the sample placeholder more than once in a template, the second and all later positions will be automatically filled in with whatever you type in the first position, when you press |ct|. The definition for this snippet is::
pl: Zauważ, że zamykający znacznik automatycznie uzupełniony o ``span``. Dzieje się tak dzięki kolejnej właściwości symboli zastępczych - *powielaniu*. Powielanie oznacza po prostu, że jeśli umieścisz symbol więcej niż raz w szablonie, drugi i kolejne automatycznie otrzymają tę samą wartość kiedy przyciśniesz |ct|. Oto definicja tej wstawki::

en: As you can see, the first placeholder ($1) has been specified twice, the second time in the closing tag, which will simply copy whatever you type in the opening tag.
pl: Jak widać pierwszy symbol zastępczy ($1) został umieszczony tu dwukrotnie, drugi raz w znaczniku zamykającym i będzie kopią tego, co wpiszesz w znaczniku otwierającym.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
pl: Wstawianie znacznika z atrybutem klasy

en: This is very similar to the insert arbitrary tag example above, except that it assumes that you want to specify a class for the tag::
pl: Przykład jest bardzo podobny do powyższego, tym razem jednak zakładamy, że chcesz podać klasę znacznika::

en: This will allow you to first type the tag name, press |ct|, type the class name, press |ct| type the contents of the tag and press |ct| one last time to jump out of the tag. The closing tag will be auto-filled.
pl: To pozwoli ci na wpisanie nazwy znacznika, po przyciśnięciu |ct| - nazwy klasy, po kolejnym przyciśnięciu |ct| zawartości, ostatnim przyciśnięciem |ct| zaś zakończyć wprowadzanie. Znacznik zamykający zostanie dodany automatycznie.

en: Creating your own snippets
pl: Tworzenie własnych wstawek

en: Snippets really shine because you can create your own to suit your editing style. To create your own snippets go to :guilabel:`Edit->Preferences->Editor settings->Manage snippets` in the editor. This will pop-up an easy to use dialog to help you create your own snippets. Simply click the :guilabel:`Add snippet` button and you will see a dialog that looks like:
pl: Wstawki są naprawdę wspaniałe ponieważ możesz tworzyć swoje własne i dopasować je do twojego sposobu edytowania. Aby stworzyć własne wstawki w oknie edytora wybierz :guilabel:`Edycja->Ustawienia->Ustawienia edytora->Zarządzaj wstawkami`. Pojawi się okno, w którym w prosty sposób możesz tworzyć własne wstawki. Po prostu kliknij przycisk :guilabel:`Dodaj wstawkę`, a pojawi się okno przedstawione poniżej:

en: The create your own snippets tool
pl: Narzędzie do tworzenia własnych fragmentów

en: First give your snippet a name, something descriptive, to help identify the snippet in the future. Then specify the *trigger*. A trigger is simply the text that you have to type in the editor before pressing |ct| in order to expand the snippet.
pl: Najpierw nadaj wstawce nazwę, coś opisowego, co pozwoli zidentyfikować ją w przyszłości. Potem określ *wyzwalacz*. Wyzwalacz jest po prostu tekstem, który musisz wpisać przed przyciśnięciem |ct|, by rozwinąć wstawkę.

en: Then specify the snippet template. You should start with one of the examples above and modify it to suit your needs. Finally, specify which file types you want the snippet to be active for. This way you can have multiple snippets with the same trigger text that work differently in different file types.
pl: Następnie określ szablon skrawka. Powinieneś zacząć od jednego z powyższych przykładów i dostosować go do swoich potrzeb. Na koniec określ typy plików, dla których fragment ma być aktywny. W ten sposób możesz mieć wiele fragmentów kodu z tym samym tekstem wyzwalacza, które działają inaczej w różnych typach plików.

en: The next step is to test your newly created snippet. Use the :guilabel:`Test` box at the bottom. Type in the trigger text and press |ct| to expand the snippet and jump between placeholders.
pl: Teraz jest czas na przetestowanie nowo utworzonej wstawki. Wykorzystaj do tego pole :guilabel:`Test` na dole okna. Wpisz tekst wyzwalacza i użyj |ct|, by rozwinąć wstawkę, a potem skakać między symbolami zastępczymi.
