calibre - en to pl translation catalogue (56 entries)

en: Adding your favorite news website
pl: Dodawanie ulubionej strony z wiadomościami

en: calibre has a powerful, flexible and easy-to-use framework for downloading news from the Internet and converting it into an e-book. The following will show you, by means of examples, how to get news from various websites.
pl: calibre zawiera potężne, elastyczne i łatwe w użyciu narzędzie, służące do pobierania wiadomości z internetu i przekształcaniu ich w ebook. Poniżej pokażemy na przykładach, jak pobrać wiadomości z różnych witryn.

en: To gain an understanding of how to use the framework, follow the examples in the order listed below:
pl: Do zrozumienia, w jaki sposób korzystać z tego narzędzia posłużą kolejno następujące przykłady:

en: Completely automatic fetching
pl: Całkowicie automatyczne pobieranie

en: If your news source is simple enough, calibre may well be able to fetch it completely automatically, all you need to do is provide the URL. calibre gathers all the information needed to download a news source into a :term:`recipe`. In order to tell calibre about a news source, you have to create a :term:`recipe` for it. Let's see some examples:
pl: Jeśli pobierane wiadomości mają dostatecznie prostą strukturę, calibre może sobie z nimi poradzić całkowicie automatycznie, a wszystko, co musisz zrobić to podać adres witryny. calibre, zgromadziwszy wszystkie informacje, potrzebne do pobrania wiadomości, umieści je w :term:`źródle`. Aby poinformować calibre o wiadomościach do pobrania, musisz stworzyć dla nich :term:`źródło`. Oto kilka przykładów:

en: The calibre blog
pl: Blog calibre

en: The calibre blog is a blog of posts that describe many useful calibre features in a simple and accessible way for new calibre users. In order to download this blog into an e-book, we rely on the :term:`RSS` feed of the blog::
pl: Blog calibre zawiera wiele przydatnych informacji o funkcjach programu, podanych w przejrzysty i przystępny sposób. Aby pobrać wiadomości z tego bloga można użyć :term:`kanału RSS`::

en: I got the RSS URL by looking under "Subscribe to" at the bottom of the blog page and choosing :guilabel:`Posts->Atom`. To make calibre download the feeds and convert them into an e-book, you should right click the :guilabel:`Fetch news` button and then the :guilabel:`Add a custom news source` menu item and then the :guilabel:`New Recipe` button. A dialog similar to that shown below should open up.
pl: Adres kanału RSS można znaleźć na dole strony poniżej  
    "Subscribe to", należy wybrać :guilabel:`Posts->Atom`. Aby calibre pobrał wiadomości i przekształcił je w ebook, musisz kliknąć prawym klawiszem myszy przycisk :guilabel:`Pobierz wiadomości` i wybrać :guilabel:`Dodaj własne źródło wiadomości`, a następnie przycisk :guilabel:`Nowe źródło`.
    Pojawi się okno podobne do pokazanego poniżej.

en: First enter ``Calibre Blog`` into the :guilabel:`Recipe title` field. This will be the title of the e-book that will be created from the articles in the above feeds.
pl: Najpierw wprowadź "Calibre Blog" w polu: guilabel: "Tytuł przepisu". Będzie to tytuł e-booka, który zostanie utworzony z artykułów w powyższych kanałach.

en: The next two fields (:guilabel:`Oldest article` and :guilabel:`Max. number of articles`) allow you some control over how many articles should be downloaded from each feed, and they are pretty self explanatory.
pl: Następne dwa pola (:guilabel:`Najstarszy artykuł może być sprzed` i :guilabel:`Maksymalna liczba artykułów na strumień`) dają pewną kontrolę na tym jakie artykuły zostaną pobrane i raczej nie wymagają objaśnienia.

en: To add the feeds to the recipe, enter the feed title and the feed URL and click the :guilabel:`Add feed` button. Once you have added the feed, simply click the :guilabel:`Save` button and you're done! Close the dialog.
pl: Aby dodać strumienie (odpowiadające kanałom RSS), podaj nazwę strumienia, kanał RSS, z którego będą pobierane artykuły i kliknij przycisk :guilabel:`Dodaj strumień`. Po dodaniu strumienia po prostu kliknij przycisk :guilabel:`Zapisz` i gotowe! Można zamknąć okno.

en: To test your new :term:`recipe`, click the :guilabel:`Fetch news` button and in the :guilabel:`Custom news sources` sub-menu click :guilabel:`calibre Blog`. After a couple of minutes, the newly downloaded e-book of blog posts will appear in the main library view (if you have your reader connected, it will be put onto the reader instead of into the library). Select it and hit the :guilabel:`View` button to read!
pl: Aby przetestować nowe :term:`źródło`, kliknij przycisk :guilabel:`Pobierz wiadomości`, a następnie w podmenu :guilabel:`Własne` kliknij :guilabel:`Blog calibre`. Po kilku minutach nowy ebook, powstały z artykułów z bloga, pojawi się na liście książek biblioteki (jeśli jest podłączony czytnik to książka pojawi się na czytniku, a nie w bibliotece). Zaznacz go, kliknij przycisk :guilabel:`Wyświetl` i już możesz czytać!

en: The reason this worked so well, with so little effort is that the blog provides *full-content* :term:`RSS` feeds, i.e., the article content is embedded in the feed itself. For most news sources that provide news in this fashion, with *full-content* feeds, you don't need any more effort to convert them to e-books. Now we will look at a news source that does not provide full content feeds. In such feeds, the full article is a webpage and the feed only contains a link to the webpage with a short summary of the article.
pl: Działa to tak dobrze przy tak małym nakładzie pracy, gdyż jest to kanał *full-content*, co oznacza, że cała treść artykułu  jest w nim osadzona. W przypadku większości kanałów tego typu nie potrzeba nic więcej by przekształcić je w książki. Teraz przyjrzyjmy się źródłu wiadomości, które nie zawiera pełnego tekstu artykułów. W takim przypadku artykuł jest stroną w internecie, a źródło dostarcza jedynie odsyłacza do niego z krótkim podsumowaniem.

en: Let's try the following two feeds from *The BBC*:
pl: Wypróbujmy następujące dwa źródła z *The BBC*:

en: News Front Page: https://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml
pl: Strona główna wiadomości: https://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml

en: Science/Nature: https://newsrss.bbc.co.uk/rss/newsonline_world_edition/science/nature/rss.xml
pl: Nauka/Natura: https://newsrss.bbc.co.uk/rss/newsonline_world_edition/science/nature/rss.xml

en: Follow the procedure outlined in :ref:`calibre_blog` above to create a recipe for *The BBC* (using the feeds above). Looking at the downloaded e-book, we see that calibre has done a creditable job of extracting only the content you care about from each article's webpage. However, the extraction process is not perfect. Sometimes it leaves in undesirable content like menus and navigation aids or it removes content that should have been left alone, like article headings. In order, to have perfect content extraction, we will need to customize the fetch process, as described in the next section.
pl: Wykonaj kroki opisane w powyższej procedurze, by zbudować źródło dla *The BBC* (przy użyciu podanych wyżej adresów). Otworzywszy pobraną książkę zobaczysz, że calibre wykonał kawał dobrej roboty, wydobywając zawartość każdego artykułu z witryny. Jednak proces ten nie jest doskonały. Czasem pozostają niepożądane fragmenty, takie jak menu i elementy nawigacji albo są usuwane części, które są potrzebne, np. nagłówki. Aby uzyskać doskonale wyodrębniony tekst artykułów trzeba dopracować proces pobierania, o czym traktuje następna część.

en: Customizing the fetch process
pl: Dostrajanie procesu pobierania

en: When you want to perfect the download process, or download content from a particularly complex website, you can avail yourself of all the power and flexibility of the :term:`recipe` framework. In order to do that, in the :guilabel:`Add custom news sources` dialog, simply click the :guilabel:`Switch to Advanced mode` button.
pl: Jeśli chcesz udoskonalić proces wyodrębniania tekstu albo pobrać artykuły ze szczególnie skomplikowanej witryny, możesz wykorzystać możliwości i elastyczność narzędzi :term:`źródeł`. W tym celu, w oknie :guilabel:`Dodaj własne źródło wiadomości`, kliknij przycisk :guilabel:`Przełącz na tryb zaawansowany`.

en: The easiest and often most productive customization is to use the print version of the online articles. The print version typically has much less cruft and translates much more smoothly to an e-book. Let's try to use the print version of the articles from *The BBC*.
pl: Najprostszym i zwykle najbardziej efektywnym sposobem jest użycie wersji do druku pobieranych artykułów. Taka wersja zawiera zazwyczaj znacznie mniej dodatków i łatwiej ją dostosować do potrzeb e-booka. Użyjmy więc takiej wersji artykułów z *The BBC*.

en: Using the print version of bbc.co.uk
pl: Używanie wersji do druku witryny bbc.co.uk

en: The first step is to look at the e-book we downloaded previously from :ref:`bbc`. At the end of each article, in the e-book is a little blurb telling you where the article was downloaded from. Copy and paste that URL into a browser. Now on the article webpage look for a link that points to the "Printable version". Click it to see the print version of the article. It looks much neater! Now compare the two URLs. For me they were:
pl: Pierwszym krokiem jest sprawdzenie ebooka, pobranego uprzednio z  :ref:`bbc`. Na końcu każdego artykułu jest mała notka, informująca, skąd został pobrany artykuł. Skopiuj ten adres do przeglądarki. Następnie, na stronie z artykułem poszukaj odsyłacza  "Printable version". Kliknij go, by zobaczyć wersję do druku. Jest znacznie bardziej przejrzysta. Teraz porównaj oba adresy. U mnie były następujące:

en: Article URL
pl: Adres artykułu

en: Print version URL
pl: Adres wersji do druku

en: So it looks like to get the print version, we need to prefix every article URL with:
pl: Aby otrzymać wersję do druku, adres każdego artykułu musi zaczynać się od:

en: You can see that the fields from the :guilabel:`Basic mode` have been translated to Python code in a straightforward manner. We need to add instructions to this recipe to use the print version of the articles. All that's needed is to add the following two lines:
pl: Zauważysz, że pola z okna w trybie podstawowym zostały przetłumaczone wprost na kod pythona. Teraz trzeba zmienić ten kod tak, by używał wersji do druku przy pobieraniu artykułów. Wszystko, czego potrzeba to dodać dwie linie:

en: This is Python, so indentation is important. After you've added the lines, it should look like:
pl: To python, więc wcięcia są bardzo ważne. Po dodaniu tych dwóch linii powinno to wyglądać tak:

en: Replacing article styles
pl: Zamiana stylów

en: In the previous section, we saw that the font size for articles from the print version of *The BBC* was too small. In most websites, *The BBC* included, this font size is set by means of :term:`CSS` stylesheets. We can disable the fetching of such stylesheets by adding the line::
pl: W poprzedniej części okazało się, że czcionka w artykułach, pobranych z *The BBC* w wersji do druku. Jak w wielu innych witrynach, tak i w *The BBC* wielkość czcionki jest ustawiana za pomocą arkusza stylów  :term:`CSS`. Można zablokować pobieranie takich arkuszy dodając linię:

en: The recipe now looks like:
pl: Teraz kod wygląda następująco:

en: The new version looks pretty good. If you're a perfectionist, you'll want to read the next section, which deals with actually modifying the downloaded content.
pl: Nowa wersja wygląda nieźle. Jeśli jesteś perfekcjonistą możesz przeczytać kolejną część, która traktuje o modyfikowaniu pobieranej treści.

en: Slicing and dicing
pl: Szatkowanie wiadomości

en: calibre contains very powerful and flexible abilities when it comes to manipulating downloaded content. To show off a couple of these, let's look at our old friend the :ref:`The BBC <bbc1>` recipe again. Looking at the source code (:term:`HTML`) of a couple of articles (print version), we see that they have a footer that contains no useful information, contained in
pl: calibre może na wiele sposobów manipulować pobieraną treścią. Aby pokazać niektóre z nich, przyjrzyjmy się ponownie naszemu, znanemu już źródłu  :ref:`The BBC <bbc1>`. Przyjrzawszy się kodowi źródłowemu (:term:``HTML`) kilku artykułów (w wersji do druku) zauważymy, że mają one stopkę, która nie zawiera żadnych użytecznych informacji

en: This can be removed by adding::
pl: Można ją usunąć, dodając::

en: With these additions, our recipe has become "production quality".
pl: Dzięki tym dodatkom nasza receptura stała się „jakością produkcji”.

en: This :term:`recipe` explores only the tip of the iceberg when it comes to the power of calibre. To explore more of the abilities of calibre we'll examine a more complex real life example in the next section.
pl: to :term:`źródło` dotyka jedynie czubka góry lodowej jeśli chodzi o możliwości calibre. Aby poznać je bliżej, w następnej części przyjrzymy się bliżej bardziej skomplikowanemu, autentycznemu przykładowi.

en: Real life example
pl: Przykład z życia wzięty.

en: A reasonably complex real life example that exposes more of the :term:`API` of ``BasicNewsRecipe`` is the :term:`recipe` for *The New York Times*
pl: Nieco bardziej skomplikowany przykład, wzięty z życia, który pokazuje dokładniej :term:`API` ``BasicNewsRecipe`` to  :term:`źródło` *The new York Times*

en: We see several new features in this :term:`recipe`. First, we have::
pl: Przedstawione tu zostaną nowe funkcje. Po pierwsze::

en: This sets the displayed time on the front page of the created e-book to be in the format, ``Day, Day_Number Month, Year``. See :attr:`timefmt <calibre.web.feeds.news.BasicNewsRecipe.timefmt>`.
pl: Pozwala to ustawić format czasu na okładce tworzonego ebooka na: ``Dzień, Numer_dnia Miesiąc, Rok``. Więcej o :attr:`timefmt <calibre.web.feeds.news.BasicNewsRecipe.timefmt>`.

en: Then we see a group of directives to cleanup the downloaded :term:`HTML`::
pl: Znajduje się tu również grupa poleceń, służących do oczyszczenia pobranego :term:`HTMLa`::

en: These remove everything before the first ``<h1>`` tag and everything after the first tag whose id is ``footer``. See :attr:`remove_tags <calibre.web.feeds.news.BasicNewsRecipe.remove_tags>`, :attr:`remove_tags_before <calibre.web.feeds.news.BasicNewsRecipe.remove_tags_before>`, :attr:`remove_tags_after <calibre.web.feeds.news.BasicNewsRecipe.remove_tags_after>`.
pl: Usuwają one wszystko przez pierwszym znacznikiem ``<h1>`` i wszystko po pierwszym znaczniku, który ma id ``footer``. Więcej informacji na ten temat  :attr:`remove_tags <calibre.web.feeds.news.BasicNewsRecipe.remove_tags>`, :attr:`remove_tags_before <calibre.web.feeds.news.BasicNewsRecipe.remove_tags_before>`, :attr:`remove_tags_after <calibre.web.feeds.news.BasicNewsRecipe.remove_tags_after>`.

en: The next interesting feature is::
pl: Następna ciekawostka::

en: The final new feature is the :meth:`calibre.web.feeds.news.BasicNewsRecipe.preprocess_html` method. It can be used to perform arbitrary transformations on every downloaded HTML page. Here it is used to bypass the ads that the nytimes shows you before each article.
pl: Na koniec jeszcze jedna nowa funkcja - :meth:`calibre.web.feeds.news.BasicNewsRecipe.preprocess_html`. Jest ona używana do wprowadzania zmian w każdej pobranej stronie HTML. Tu została użyta do pominięcia reklam, które witryna wyświetla przed każdym artykułem.

en: Tips for developing new recipes
pl: Wskazówki przydatne przy tworzeniu nowych źródeł

en: On macOS, the command line tools are inside the calibre bundle, for example, if you installed calibre in :file:`/Applications` the command line tools are in :file:`/Applications/calibre.app/Contents/MacOS/`.
pl: W systemie macOS narzędzia wiersza poleceń znajdują się w pakiecie kalibru, na przykład, jeśli zainstalowałeś calibre w :file:`/Applications`, narzędzia wiersza poleceń znajdują się w :file:`/Applications/calibre.app/Contents/MacOS/ ` .

en: :doc:`generated/en/ebook-convert`
pl: :doc:`generated/pl/ebook-convert`

en: The command line interface for all e-book conversion.
pl: Interfejs wiersza poleceń do wszystkich konwersji e-booków.

en: Further reading
pl: Dalsza lektura

en: To learn more about writing advanced recipes using some of the facilities, available in ``BasicNewsRecipe`` you should consult the following sources:
pl: Aby dowiedzieć się więcej o pisaniu zaawansowanych źródeł  przy użyciu narzędzi, dostępnych w ``BasicNewsRecipe``, możesz skorzystać z poniższych źródeł:

en: Documentation of the ``BasicNewsRecipe`` class and all its important methods and fields.
pl: Dokumentacja klasy ``BasicNewsRecipe`` i wszystkich najważniejszych metod i właściwości.

en: The source code of ``BasicNewsRecipe``
pl: Kod źródłowy ``BasicNewsRecipe``

en: `Built-in recipes <https://github.com/kovidgoyal/calibre/tree/master/recipes>`_
pl: `Wbudowane źródła <https://github.com/kovidgoyal/calibre/tree/master/recipes>`_

en: The source code for the built-in recipes that come with calibre
pl: Kod źródeł dostarczanych z calibre

en: Lots of knowledgeable calibre recipe writers hang out here.
pl: Tu znajdziesz wiele osób, które wiedzą bardzo dużo o tworzeniu źródeł.

en: API documentation
pl: Dokumentacja API
