1# SOME DESCRIPTIVE TITLE.
2# Copyright (C) Kovid Goyal
3# This file is distributed under the same license as the calibre package.
4#
5# Translators:
6# Jānis Eisaks <jancs@dv.lv>, 2015
7msgid ""
8msgstr ""
9"Project-Id-Version: calibre\n"
10"Report-Msgid-Bugs-To: \n"
11"POT-Creation-Date: 2021-10-07 03:23+0000\n"
12"PO-Revision-Date: 2021-10-03 08:29+0000\n"
13"Last-Translator: Kovid Goyal <kovid@kovidgoyal.net>\n"
14"Language-Team: Latvian (http://www.transifex.com/calibre/calibre/language/lv/)\n"
15"MIME-Version: 1.0\n"
16"Content-Type: text/plain; charset=UTF-8\n"
17"Content-Transfer-Encoding: 8bit\n"
18"Language: lv\n"
19"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n != 0 ? 1 : 2);\n"
20
21#: ../../__w/calibre/calibre/manual/news_recipe.rst:4
22msgid "API documentation for recipes"
23msgstr ""
24
25#: ../../__w/calibre/calibre/manual/news_recipe.rst:9
26msgid "The API for writing recipes is defined by the :class:`BasicNewsRecipe`"
27msgstr "API recepšu rakstīšanai ir definēts :class:`BasicNewsRecipe`"
28
29#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
30#: calibre.web.feeds.news.BasicNewsRecipe:1
31msgid ""
32"Base class that contains logic needed in all recipes. By overriding "
33"progressively more of the functionality in this class, you can make "
34"progressively more customized/powerful recipes. For a tutorial introduction "
35"to creating recipes, see :doc:`news`."
36msgstr ""
37
38#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
39#: calibre.web.feeds.news.BasicNewsRecipe.abort_article:1
40msgid ""
41"Call this method inside any of the preprocess methods to abort the download "
42"for the current article. Useful to skip articles that contain inappropriate "
43"content, such as pure video articles."
44msgstr ""
45
46#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
47#: calibre.web.feeds.news.BasicNewsRecipe.abort_recipe_processing:1
48msgid ""
49"Causes the recipe download system to abort the download of this recipe, "
50"displaying a simple feedback message to the user."
51msgstr ""
52
53#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
54#: calibre.web.feeds.news.BasicNewsRecipe.add_toc_thumbnail:1
55msgid ""
56"Call this from populate_article_metadata with the src attribute of an <img> "
57"tag from the article that is appropriate for use as the thumbnail "
58"representing the article in the Table of Contents. Whether the thumbnail is "
59"actually used is device dependent (currently only used by the Kindles). Note"
60" that the referenced image must be one that was successfully downloaded, "
61"otherwise it will be ignored."
62msgstr ""
63
64#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
65#: calibre.web.feeds.news.BasicNewsRecipe.adeify_images:1
66msgid ""
67"If your recipe when converted to EPUB has problems with images when viewed "
68"in Adobe Digital Editions, call this method from within "
69":meth:`postprocess_html`."
70msgstr ""
71
72#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
73#: calibre.web.feeds.news.BasicNewsRecipe.canonicalize_internal_url:1
74msgid ""
75"Return a set of canonical representations of ``url``.  The default "
76"implementation uses just the server hostname and path of the URL, ignoring "
77"any query parameters, fragments, etc. The canonical representations must be "
78"unique across all URLs for this news source. If they are not, then internal "
79"links may be resolved incorrectly."
80msgstr ""
81
82#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
83#: calibre.web.feeds.news.BasicNewsRecipe.canonicalize_internal_url:0
84#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
85#: calibre.web.feeds.news.BasicNewsRecipe.is_link_wanted:0
86#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
87#: calibre.web.feeds.news.BasicNewsRecipe.populate_article_metadata:0
88#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
89#: calibre.web.feeds.news.BasicNewsRecipe.postprocess_book:0
90#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
91#: calibre.web.feeds.news.BasicNewsRecipe.postprocess_html:0
92msgid "Parameters"
93msgstr ""
94
95#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
96#: calibre.web.feeds.news.BasicNewsRecipe.canonicalize_internal_url:7
97msgid ""
98"Is True if the URL is coming from an internal link in an HTML file. False if"
99" the URL is the URL used to download an article."
100msgstr ""
101
102#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
103#: calibre.web.feeds.news.BasicNewsRecipe.cleanup:1
104msgid ""
105"Called after all articles have been download. Use it to do any cleanup like "
106"logging out of subscription sites, etc."
107msgstr ""
108
109#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
110#: calibre.web.feeds.news.BasicNewsRecipe.clone_browser:1
111msgid ""
112"Clone the browser br. Cloned browsers are used for multi-threaded downloads,"
113" since mechanize is not thread safe. The default cloning routines should "
114"capture most browser customization, but if you do something exotic in your "
115"recipe, you should override this method in your recipe and clone manually."
116msgstr ""
117
118#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
119#: calibre.web.feeds.news.BasicNewsRecipe.clone_browser:7
120msgid ""
121"Cloned browser instances use the same, thread-safe CookieJar by default, "
122"unless you have customized cookie handling."
123msgstr ""
124
125#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
126#: calibre.web.feeds.news.BasicNewsRecipe.default_cover:1
127msgid "Create a generic cover for recipes that don't have a cover"
128msgstr ""
129
130#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
131#: calibre.web.feeds.news.BasicNewsRecipe.download:1
132msgid ""
133"Download and pre-process all articles from the feeds in this recipe. This "
134"method should be called only once on a particular Recipe instance. Calling "
135"it more than once will lead to undefined behavior. :return: Path to "
136"index.html"
137msgstr ""
138
139#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
140#: calibre.web.feeds.news.BasicNewsRecipe.extract_readable_article:1
141msgid ""
142"Extracts main article content from 'html', cleans up and returns as a "
143"(article_html, extracted_title) tuple. Based on the original readability "
144"algorithm by Arc90."
145msgstr ""
146
147#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
148#: calibre.web.feeds.news.BasicNewsRecipe.get_article_url:1
149msgid ""
150"Override in a subclass to customize extraction of the :term:`URL` that "
151"points to the content for each article. Return the article URL. It is called"
152" with `article`, an object representing a parsed article from a feed. See "
153"`feedparser <https://pythonhosted.org/feedparser/>`_. By default it looks "
154"for the original link (for feeds syndicated via a service like feedburner or"
155" pheedo) and if found, returns that or else returns `article.link "
156"<https://pythonhosted.org/feedparser/reference-entry-link.html>`_."
157msgstr ""
158
159#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
160#: calibre.web.feeds.news.BasicNewsRecipe.get_browser:1
161msgid ""
162"Return a browser instance used to fetch documents from the web. By default "
163"it returns a `mechanize <https://mechanize.readthedocs.io/en/latest/>`_ "
164"browser instance that supports cookies, ignores robots.txt, handles "
165"refreshes and has a mozilla firefox user agent."
166msgstr ""
167
168#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
169#: calibre.web.feeds.news.BasicNewsRecipe.get_browser:6
170msgid ""
171"If your recipe requires that you login first, override this method in your "
172"subclass. For example, the following code is used in the New York Times "
173"recipe to login for full access::"
174msgstr ""
175
176#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
177#: calibre.web.feeds.news.BasicNewsRecipe.get_cover_url:1
178msgid ""
179"Return a :term:`URL` to the cover image for this issue or `None`. By default"
180" it returns the value of the member `self.cover_url` which is normally "
181"`None`. If you want your recipe to download a cover for the e-book override "
182"this method in your subclass, or set the member variable `self.cover_url` "
183"before this method is called."
184msgstr ""
185
186#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
187#: calibre.web.feeds.news.BasicNewsRecipe.get_extra_css:1
188msgid ""
189"By default returns `self.extra_css`. Override if you want to "
190"programmatically generate the extra_css."
191msgstr ""
192
193#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
194#: calibre.web.feeds.news.BasicNewsRecipe.get_feeds:1
195msgid ""
196"Return a list of :term:`RSS` feeds to fetch for this profile. Each element "
197"of the list must be a 2-element tuple of the form (title, url). If title is "
198"None or an empty string, the title from the feed is used. This method is "
199"useful if your recipe needs to do some processing to figure out the list of "
200"feeds to download. If so, override in your subclass."
201msgstr ""
202
203#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
204#: calibre.web.feeds.news.BasicNewsRecipe.get_masthead_title:1
205msgid "Override in subclass to use something other than the recipe title"
206msgstr ""
207
208#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
209#: calibre.web.feeds.news.BasicNewsRecipe.get_masthead_url:1
210msgid ""
211"Return a :term:`URL` to the masthead image for this issue or `None`. By "
212"default it returns the value of the member `self.masthead_url` which is "
213"normally `None`. If you want your recipe to download a masthead for the "
214"e-book override this method in your subclass, or set the member variable "
215"`self.masthead_url` before this method is called. Masthead images are used "
216"in Kindle MOBI files."
217msgstr ""
218
219#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
220#: calibre.web.feeds.news.BasicNewsRecipe.get_obfuscated_article:1
221msgid ""
222"If you set `articles_are_obfuscated` this method is called with every "
223"article URL. It should return the path to a file on the filesystem that "
224"contains the article HTML. That file is processed by the recursive HTML "
225"fetching engine, so it can contain links to pages/images on the web."
226msgstr ""
227
228#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
229#: calibre.web.feeds.news.BasicNewsRecipe.get_obfuscated_article:6
230msgid ""
231"This method is typically useful for sites that try to make it difficult to "
232"access article content automatically."
233msgstr ""
234
235#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
236#: calibre.web.feeds.news.BasicNewsRecipe.image_url_processor:1
237msgid ""
238"Perform some processing on image urls (perhaps removing size restrictions "
239"for dynamically generated images, etc.) and return the precessed URL."
240msgstr ""
241
242#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
243#: calibre.web.feeds.news.BasicNewsRecipe.index_to_soup:1
244msgid ""
245"Convenience method that takes an URL to the index page and returns a "
246"`BeautifulSoup <https://www.crummy.com/software/BeautifulSoup/bs4/doc>`__ of"
247" it."
248msgstr ""
249
250#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
251#: calibre.web.feeds.news.BasicNewsRecipe.index_to_soup:5
252msgid "`url_or_raw`: Either a URL or the downloaded index page as a string"
253msgstr ""
254
255#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
256#: calibre.web.feeds.news.BasicNewsRecipe.is_link_wanted:1
257msgid ""
258"Return True if the link should be followed or False otherwise. By default, "
259"raises NotImplementedError which causes the downloader to ignore it."
260msgstr ""
261
262#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
263#: calibre.web.feeds.news.BasicNewsRecipe.is_link_wanted:5
264msgid "The URL to be followed"
265msgstr ""
266
267#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
268#: calibre.web.feeds.news.BasicNewsRecipe.is_link_wanted:6
269msgid "The tag from which the URL was derived"
270msgstr ""
271
272#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
273#: calibre.web.feeds.news.BasicNewsRecipe.parse_feeds:1
274msgid ""
275"Create a list of articles from the list of feeds returned by "
276":meth:`BasicNewsRecipe.get_feeds`. Return a list of :class:`Feed` objects."
277msgstr ""
278
279#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
280#: calibre.web.feeds.news.BasicNewsRecipe.parse_index:1
281msgid ""
282"This method should be implemented in recipes that parse a website instead of"
283" feeds to generate a list of articles. Typical uses are for news sources "
284"that have a \"Print Edition\" webpage that lists all the articles in the "
285"current print edition. If this function is implemented, it will be used in "
286"preference to :meth:`BasicNewsRecipe.parse_feeds`."
287msgstr ""
288
289#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
290#: calibre.web.feeds.news.BasicNewsRecipe.parse_index:7
291msgid ""
292"It must return a list. Each element of the list must be a 2-element tuple of"
293" the form ``('feed title', list of articles)``."
294msgstr ""
295
296#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
297#: calibre.web.feeds.news.BasicNewsRecipe.parse_index:10
298msgid "Each list of articles must contain dictionaries of the form::"
299msgstr ""
300
301#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
302#: calibre.web.feeds.news.BasicNewsRecipe.parse_index:23
303msgid ""
304"For an example, see the recipe for downloading `The Atlantic`. In addition, "
305"you can add 'author' for the author of the article."
306msgstr ""
307
308#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
309#: calibre.web.feeds.news.BasicNewsRecipe.parse_index:26
310msgid ""
311"If you want to abort processing for some reason and have calibre show the "
312"user a simple message instead of an error, call "
313":meth:`abort_recipe_processing`."
314msgstr ""
315
316#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
317#: calibre.web.feeds.news.BasicNewsRecipe.populate_article_metadata:1
318msgid ""
319"Called when each HTML page belonging to article is downloaded. Intended to "
320"be used to get article metadata like author/summary/etc. from the parsed "
321"HTML (soup)."
322msgstr ""
323
324#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
325#: calibre.web.feeds.news.BasicNewsRecipe.populate_article_metadata:5
326msgid ""
327"A object of class :class:`calibre.web.feeds.Article`. If you change the "
328"summary, remember to also change the text_summary"
329msgstr ""
330
331#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
332#: calibre.web.feeds.news.BasicNewsRecipe.populate_article_metadata:7
333msgid "Parsed HTML belonging to this article"
334msgstr ""
335
336#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
337#: calibre.web.feeds.news.BasicNewsRecipe.populate_article_metadata:8
338msgid "True iff the parsed HTML is the first page of the article."
339msgstr ""
340
341#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
342#: calibre.web.feeds.news.BasicNewsRecipe.postprocess_book:1
343msgid "Run any needed post processing on the parsed downloaded e-book."
344msgstr ""
345
346#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
347#: calibre.web.feeds.news.BasicNewsRecipe.postprocess_book:3
348msgid "An OEBBook object"
349msgstr ""
350
351#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
352#: calibre.web.feeds.news.BasicNewsRecipe.postprocess_book:4
353msgid "Conversion options"
354msgstr ""
355
356#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
357#: calibre.web.feeds.news.BasicNewsRecipe.postprocess_html:1
358msgid ""
359"This method is called with the source of each downloaded :term:`HTML` file, "
360"after it is parsed for links and images. It can be used to do arbitrarily "
361"powerful post-processing on the :term:`HTML`. It should return `soup` after "
362"processing it."
363msgstr ""
364
365#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
366#: calibre.web.feeds.news.BasicNewsRecipe.postprocess_html:6
367msgid ""
368"A `BeautifulSoup <https://www.crummy.com/software/BeautifulSoup/bs4/doc/>`__"
369"  instance containing the downloaded :term:`HTML`."
370msgstr ""
371
372#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
373#: calibre.web.feeds.news.BasicNewsRecipe.postprocess_html:7
374msgid "True if this is the first page of an article."
375msgstr ""
376
377#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
378#: calibre.web.feeds.news.BasicNewsRecipe.preprocess_html:1
379msgid ""
380"This method is called with the source of each downloaded :term:`HTML` file, "
381"before it is parsed for links and images. It is called after the cleanup as "
382"specified by remove_tags etc. It can be used to do arbitrarily powerful pre-"
383"processing on the :term:`HTML`. It should return `soup` after processing it."
384msgstr ""
385
386#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
387#: calibre.web.feeds.news.BasicNewsRecipe.preprocess_html:7
388#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
389#: calibre.web.feeds.news.BasicNewsRecipe.skip_ad_pages:8
390msgid ""
391"`soup`: A `BeautifulSoup "
392"<https://www.crummy.com/software/BeautifulSoup/bs4/doc/>`__ instance "
393"containing the downloaded :term:`HTML`."
394msgstr ""
395
396#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
397#: calibre.web.feeds.news.BasicNewsRecipe.preprocess_image:1
398msgid ""
399"Perform some processing on downloaded image data. This is called on the raw "
400"data before any resizing is done. Must return the processed raw data. Return"
401" None to skip the image."
402msgstr ""
403
404#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
405#: calibre.web.feeds.news.BasicNewsRecipe.preprocess_raw_html:1
406msgid ""
407"This method is called with the source of each downloaded :term:`HTML` file, "
408"before it is parsed into an object tree. raw_html is a unicode string "
409"representing the raw HTML downloaded from the web. url is the URL from which"
410" the HTML was downloaded."
411msgstr ""
412
413#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
414#: calibre.web.feeds.news.BasicNewsRecipe.preprocess_raw_html:6
415msgid "Note that this method acts *before* preprocess_regexps."
416msgstr ""
417
418#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
419#: calibre.web.feeds.news.BasicNewsRecipe.preprocess_raw_html:8
420msgid "This method must return the processed raw_html as a unicode object."
421msgstr ""
422
423#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
424#: calibre.web.feeds.news.BasicNewsRecipe.print_version:1
425msgid ""
426"Take a `url` pointing to the webpage with article content and return the "
427":term:`URL` pointing to the print version of the article. By default does "
428"nothing. For example::"
429msgstr ""
430
431#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
432#: calibre.web.feeds.news.BasicNewsRecipe.skip_ad_pages:1
433msgid ""
434"This method is called with the source of each downloaded :term:`HTML` file, "
435"before any of the cleanup attributes like remove_tags, keep_only_tags are "
436"applied. Note that preprocess_regexps will have already been applied. It is "
437"meant to allow the recipe to skip ad pages. If the soup represents an ad "
438"page, return the HTML of the real page. Otherwise return None."
439msgstr ""
440
441#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
442#: calibre.web.feeds.news.BasicNewsRecipe.sort_index_by:1
443msgid ""
444"Convenience method to sort the titles in `index` according to `weights`. "
445"`index` is sorted in place. Returns `index`."
446msgstr ""
447
448#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
449#: calibre.web.feeds.news.BasicNewsRecipe.sort_index_by:4
450msgid "`index`: A list of titles."
451msgstr ""
452
453#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
454#: calibre.web.feeds.news.BasicNewsRecipe.sort_index_by:6
455msgid ""
456"`weights`: A dictionary that maps weights to titles. If any titles in index "
457"are not in weights, they are assumed to have a weight of 0."
458msgstr ""
459
460#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
461#: calibre.web.feeds.news.BasicNewsRecipe.tag_to_string:1
462msgid ""
463"Convenience method to take a `BeautifulSoup "
464"<https://www.crummy.com/software/BeautifulSoup/bs4/doc/>`_ :code:`Tag` and "
465"extract the text from it recursively, including any CDATA sections and alt "
466"tag attributes. Return a possibly empty Unicode string."
467msgstr ""
468
469#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
470#: calibre.web.feeds.news.BasicNewsRecipe.tag_to_string:6
471msgid ""
472"`use_alt`: If `True` try to use the alt attribute for tags that don't have "
473"any textual content"
474msgstr ""
475
476#: ../../__w/calibre/calibre/src/calibre/web/feeds/news.pydocstring of
477#: calibre.web.feeds.news.BasicNewsRecipe.tag_to_string:9
478msgid ""
479"`tag`: `BeautifulSoup "
480"<https://www.crummy.com/software/BeautifulSoup/bs4/doc/>`_ :code:`Tag`"
481msgstr ""
482
483#: ../../__w/calibre/calibre/manual/docstring of
484#: calibre.web.feeds.news.BasicNewsRecipe.articles_are_obfuscated:1
485msgid ""
486"Set to True and implement :meth:`get_obfuscated_article` to handle websites "
487"that try to make it difficult to scrape content."
488msgstr ""
489
490#: ../../__w/calibre/calibre/manual/docstring of
491#: calibre.web.feeds.news.BasicNewsRecipe.auto_cleanup:1
492msgid ""
493"Automatically extract all the text from downloaded article pages. Uses the "
494"algorithms from the readability project. Setting this to True, means that "
495"you do not have to worry about cleaning up the downloaded HTML manually "
496"(though manual cleanup will always be superior)."
497msgstr ""
498
499#: ../../__w/calibre/calibre/manual/docstring of
500#: calibre.web.feeds.news.BasicNewsRecipe.auto_cleanup_keep:1
501msgid ""
502"Specify elements that the auto cleanup algorithm should never remove. The "
503"syntax is a XPath expression. For example::"
504msgstr ""
505
506#: ../../__w/calibre/calibre/manual/docstring of
507#: calibre.web.feeds.news.BasicNewsRecipe.center_navbar:1
508msgid ""
509"If True the navigation bar is center aligned, otherwise it is left aligned"
510msgstr ""
511
512#: ../../__w/calibre/calibre/manual/docstring of
513#: calibre.web.feeds.news.BasicNewsRecipe.compress_news_images:1
514msgid ""
515"Set this to False to ignore all scaling and compression parameters and pass "
516"images through unmodified. If True and the other compression parameters are "
517"left at their default values, JPEG images will be scaled to fit in the "
518"screen dimensions set by the output profile and compressed to size at most "
519"(w * h)/16 where w x h are the scaled image dimensions."
520msgstr ""
521
522#: ../../__w/calibre/calibre/manual/docstring of
523#: calibre.web.feeds.news.BasicNewsRecipe.compress_news_images_auto_size:1
524msgid ""
525"The factor used when auto compressing JPEG images. If set to None, auto "
526"compression is disabled. Otherwise, the images will be reduced in size to (w"
527" * h)/compress_news_images_auto_size bytes if possible by reducing the "
528"quality level, where w x h are the image dimensions in pixels. The minimum "
529"JPEG quality will be 5/100 so it is possible this constraint will not be "
530"met.  This parameter can be overridden by the parameter "
531"compress_news_images_max_size which provides a fixed maximum size for "
532"images. Note that if you enable scale_news_images_to_device then the image "
533"will first be scaled and then its quality lowered until its size is less "
534"than (w * h)/factor where w and h are now the *scaled* image dimensions. In "
535"other words, this compression happens after scaling."
536msgstr ""
537
538#: ../../__w/calibre/calibre/manual/docstring of
539#: calibre.web.feeds.news.BasicNewsRecipe.compress_news_images_max_size:1
540msgid ""
541"Set JPEG quality so images do not exceed the size given (in KBytes). If set,"
542" this parameter overrides auto compression via "
543"compress_news_images_auto_size. The minimum JPEG quality will be 5/100 so it"
544" is possible this constraint will not be met."
545msgstr ""
546
547#: ../../__w/calibre/calibre/manual/docstring of
548#: calibre.web.feeds.news.BasicNewsRecipe.conversion_options:1
549msgid ""
550"Recipe specific options to control the conversion of the downloaded content "
551"into an e-book. These will override any user or plugin specified values, so "
552"only use if absolutely necessary. For example::"
553msgstr ""
554
555#: ../../__w/calibre/calibre/manual/docstring of
556#: calibre.web.feeds.news.BasicNewsRecipe.cover_margins:1
557msgid ""
558"By default, the cover image returned by get_cover_url() will be used as the "
559"cover for the periodical.  Overriding this in your recipe instructs calibre "
560"to render the downloaded cover into a frame whose width and height are "
561"expressed as a percentage of the downloaded cover. cover_margins = (10, 15, "
562"'#ffffff') pads the cover with a white margin 10px on the left and right, "
563"15px on the top and bottom. Color names are defined `here "
564"<https://www.imagemagick.org/script/color.php>`_. Note that for some reason,"
565" white does not always work in Windows. Use #ffffff instead"
566msgstr ""
567
568#: ../../__w/calibre/calibre/manual/docstring of
569#: calibre.web.feeds.news.BasicNewsRecipe.delay:1
570msgid ""
571"Delay between consecutive downloads in seconds. The argument may be a "
572"floating point number to indicate a more precise time."
573msgstr ""
574
575#: ../../__w/calibre/calibre/manual/docstring of
576#: calibre.web.feeds.news.BasicNewsRecipe.description:1
577msgid ""
578"A couple of lines that describe the content this recipe downloads. This will"
579" be used primarily in a GUI that presents a list of recipes."
580msgstr ""
581
582#: ../../__w/calibre/calibre/manual/docstring of
583#: calibre.web.feeds.news.BasicNewsRecipe.encoding:1
584msgid ""
585"Specify an override encoding for sites that have an incorrect charset "
586"specification. The most common being specifying ``latin1`` and using "
587"``cp1252``. If None, try to detect the encoding. If it is a callable, the "
588"callable is called with two arguments: The recipe object and the source to "
589"be decoded. It must return the decoded source."
590msgstr ""
591
592#: ../../__w/calibre/calibre/manual/docstring of
593#: calibre.web.feeds.news.BasicNewsRecipe.extra_css:1
594msgid ""
595"Specify any extra :term:`CSS` that should be added to downloaded "
596":term:`HTML` files. It will be inserted into `<style>` tags, just before the"
597" closing `</head>` tag thereby overriding all :term:`CSS` except that which "
598"is declared using the style attribute on individual :term:`HTML` tags. Note "
599"that if you want to programmatically generate the extra_css override the "
600":meth:`get_extra_css()` method instead. For example::"
601msgstr ""
602
603#: ../../__w/calibre/calibre/manual/docstring of
604#: calibre.web.feeds.news.BasicNewsRecipe.feeds:1
605msgid ""
606"List of feeds to download. Can be either ``[url1, url2, ...]`` or "
607"``[('title1', url1), ('title2', url2),...]``"
608msgstr ""
609
610#: ../../__w/calibre/calibre/manual/docstring of
611#: calibre.web.feeds.news.BasicNewsRecipe.filter_regexps:1
612msgid ""
613"List of regular expressions that determines which links to ignore. If empty "
614"it is ignored. Used only if is_link_wanted is not implemented. For example::"
615msgstr ""
616
617#: ../../__w/calibre/calibre/manual/docstring of
618#: calibre.web.feeds.news.BasicNewsRecipe.filter_regexps:7
619msgid "will remove all URLs that have `ads.doubleclick.net` in them."
620msgstr ""
621
622#: ../../__w/calibre/calibre/manual/docstring of
623#: calibre.web.feeds.news.BasicNewsRecipe.filter_regexps:9
624#: ../../__w/calibre/calibre/manual/docstring of
625#: calibre.web.feeds.news.BasicNewsRecipe.match_regexps:9
626msgid ""
627"Only one of :attr:`BasicNewsRecipe.match_regexps` or "
628":attr:`BasicNewsRecipe.filter_regexps` should be defined."
629msgstr ""
630
631#: ../../__w/calibre/calibre/manual/docstring of
632#: calibre.web.feeds.news.BasicNewsRecipe.handle_gzip:1
633msgid ""
634"Set to False if you dont want to use gzipped transfers. Note that some old "
635"servers flake out with gzip"
636msgstr ""
637
638#: ../../__w/calibre/calibre/manual/docstring of
639#: calibre.web.feeds.news.BasicNewsRecipe.ignore_duplicate_articles:1
640msgid ""
641"Ignore duplicates of articles that are present in more than one section. A "
642"duplicate article is an article that has the same title and/or URL. To "
643"ignore articles with the same title, set this to::"
644msgstr ""
645
646#: ../../__w/calibre/calibre/manual/docstring of
647#: calibre.web.feeds.news.BasicNewsRecipe.ignore_duplicate_articles:7
648msgid "To use URLs instead, set it to::"
649msgstr ""
650
651#: ../../__w/calibre/calibre/manual/docstring of
652#: calibre.web.feeds.news.BasicNewsRecipe.ignore_duplicate_articles:11
653msgid "To match on title or URL, set it to::"
654msgstr ""
655
656#: ../../__w/calibre/calibre/manual/docstring of
657#: calibre.web.feeds.news.BasicNewsRecipe.keep_only_tags:1
658msgid ""
659"Keep only the specified tags and their children. For the format for "
660"specifying a tag see :attr:`BasicNewsRecipe.remove_tags`. If this list is "
661"not empty, then the `<body>` tag will be emptied and re-filled with the tags"
662" that match the entries in this list. For example::"
663msgstr ""
664
665#: ../../__w/calibre/calibre/manual/docstring of
666#: calibre.web.feeds.news.BasicNewsRecipe.keep_only_tags:8
667msgid ""
668"will keep only tags that have an `id` attribute of `\"content\"` or "
669"`\"heading\"`."
670msgstr ""
671
672#: ../../__w/calibre/calibre/manual/docstring of
673#: calibre.web.feeds.news.BasicNewsRecipe.language:1
674msgid ""
675"The language that the news is in. Must be an ISO-639 code either two or "
676"three characters long"
677msgstr ""
678
679#: ../../__w/calibre/calibre/manual/docstring of
680#: calibre.web.feeds.news.BasicNewsRecipe.masthead_url:1
681msgid ""
682"By default, calibre will use a default image for the masthead (Kindle only)."
683" Override this in your recipe to provide a url to use as a masthead."
684msgstr ""
685
686#: ../../__w/calibre/calibre/manual/docstring of
687#: calibre.web.feeds.news.BasicNewsRecipe.match_regexps:1
688msgid ""
689"List of regular expressions that determines which links to follow. If empty,"
690" it is ignored. Used only if is_link_wanted is not implemented. For "
691"example::"
692msgstr ""
693
694#: ../../__w/calibre/calibre/manual/docstring of
695#: calibre.web.feeds.news.BasicNewsRecipe.match_regexps:7
696msgid "will match all URLs that have `page=some number` in them."
697msgstr ""
698
699#: ../../__w/calibre/calibre/manual/docstring of
700#: calibre.web.feeds.news.BasicNewsRecipe.max_articles_per_feed:1
701msgid ""
702"Maximum number of articles to download from each feed. This is primarily "
703"useful for feeds that don't have article dates. For most feeds, you should "
704"use :attr:`BasicNewsRecipe.oldest_article`"
705msgstr ""
706
707#: ../../__w/calibre/calibre/manual/docstring of
708#: calibre.web.feeds.news.BasicNewsRecipe.needs_subscription:1
709msgid ""
710"If True the GUI will ask the user for a username and password to use while "
711"downloading. If set to \"optional\" the use of a username and password "
712"becomes optional"
713msgstr ""
714
715#: ../../__w/calibre/calibre/manual/docstring of
716#: calibre.web.feeds.news.BasicNewsRecipe.no_stylesheets:1
717msgid ""
718"Convenient flag to disable loading of stylesheets for websites that have "
719"overly complex stylesheets unsuitable for conversion to e-book formats. If "
720"True stylesheets are not downloaded and processed"
721msgstr ""
722
723#: ../../__w/calibre/calibre/manual/docstring of
724#: calibre.web.feeds.news.BasicNewsRecipe.oldest_article:1
725msgid "Oldest article to download from this news source. In days."
726msgstr ""
727
728#: ../../__w/calibre/calibre/manual/docstring of
729#: calibre.web.feeds.news.BasicNewsRecipe.preprocess_regexps:1
730msgid ""
731"List of :term:`regexp` substitution rules to run on the downloaded "
732":term:`HTML`. Each element of the list should be a two element tuple. The "
733"first element of the tuple should be a compiled regular expression and the "
734"second a callable that takes a single match object and returns a string to "
735"replace the match. For example::"
736msgstr ""
737
738#: ../../__w/calibre/calibre/manual/docstring of
739#: calibre.web.feeds.news.BasicNewsRecipe.preprocess_regexps:12
740msgid "will remove everything from `<!--Article ends here-->` to `</body>`."
741msgstr ""
742
743#: ../../__w/calibre/calibre/manual/docstring of
744#: calibre.web.feeds.news.BasicNewsRecipe.publication_type:1
745msgid ""
746"Publication type Set to newspaper, magazine or blog. If set to None, no "
747"publication type metadata will be written to the opf file."
748msgstr ""
749
750#: ../../__w/calibre/calibre/manual/docstring of
751#: calibre.web.feeds.news.BasicNewsRecipe.recipe_disabled:1
752msgid ""
753"Set to a non empty string to disable this recipe. The string will be used as"
754" the disabled message"
755msgstr ""
756
757#: ../../__w/calibre/calibre/manual/docstring of
758#: calibre.web.feeds.news.BasicNewsRecipe.recursions:1
759msgid "Number of levels of links to follow on article webpages"
760msgstr ""
761
762#: ../../__w/calibre/calibre/manual/docstring of
763#: calibre.web.feeds.news.BasicNewsRecipe.remove_attributes:1
764msgid "List of attributes to remove from all tags. For example::"
765msgstr ""
766
767#: ../../__w/calibre/calibre/manual/docstring of
768#: calibre.web.feeds.news.BasicNewsRecipe.remove_empty_feeds:1
769msgid ""
770"If True empty feeds are removed from the output. This option has no effect "
771"if parse_index is overridden in the sub class. It is meant only for recipes "
772"that return a list of feeds using `feeds` or :meth:`get_feeds`. It is also "
773"used if you use the ignore_duplicate_articles option."
774msgstr ""
775
776#: ../../__w/calibre/calibre/manual/docstring of
777#: calibre.web.feeds.news.BasicNewsRecipe.remove_javascript:1
778msgid "Convenient flag to strip all JavaScript tags from the downloaded HTML"
779msgstr ""
780
781#: ../../__w/calibre/calibre/manual/docstring of
782#: calibre.web.feeds.news.BasicNewsRecipe.remove_tags:1
783msgid ""
784"List of tags to be removed. Specified tags are removed from downloaded HTML."
785" A tag is specified as a dictionary of the form::"
786msgstr ""
787
788#: ../../__w/calibre/calibre/manual/docstring of
789#: calibre.web.feeds.news.BasicNewsRecipe.remove_tags:9
790msgid ""
791"All keys are optional. For a full explanation of the search criteria, see "
792"`Beautiful Soup <https://www.crummy.com/software/BeautifulSoup/bs4/doc"
793"/#searching-the-tree>`__ A common example::"
794msgstr ""
795
796#: ../../__w/calibre/calibre/manual/docstring of
797#: calibre.web.feeds.news.BasicNewsRecipe.remove_tags:15
798msgid ""
799"This will remove all `<div class=\"advert\">` tags and all their children "
800"from the downloaded :term:`HTML`."
801msgstr ""
802
803#: ../../__w/calibre/calibre/manual/docstring of
804#: calibre.web.feeds.news.BasicNewsRecipe.remove_tags_after:1
805msgid ""
806"Remove all tags that occur after the specified tag. For the format for "
807"specifying a tag see :attr:`BasicNewsRecipe.remove_tags`. For example::"
808msgstr ""
809
810#: ../../__w/calibre/calibre/manual/docstring of
811#: calibre.web.feeds.news.BasicNewsRecipe.remove_tags_after:7
812msgid "will remove all tags after the first element with `id=\"content\"`."
813msgstr ""
814
815#: ../../__w/calibre/calibre/manual/docstring of
816#: calibre.web.feeds.news.BasicNewsRecipe.remove_tags_before:1
817msgid ""
818"Remove all tags that occur before the specified tag. For the format for "
819"specifying a tag see :attr:`BasicNewsRecipe.remove_tags`. For example::"
820msgstr ""
821
822#: ../../__w/calibre/calibre/manual/docstring of
823#: calibre.web.feeds.news.BasicNewsRecipe.remove_tags_before:7
824msgid "will remove all tags before the first element with `id=\"content\"`."
825msgstr ""
826
827#: ../../__w/calibre/calibre/manual/docstring of
828#: calibre.web.feeds.news.BasicNewsRecipe.requires_version:1
829msgid "Minimum calibre version needed to use this recipe"
830msgstr ""
831
832#: ../../__w/calibre/calibre/manual/docstring of
833#: calibre.web.feeds.news.BasicNewsRecipe.resolve_internal_links:1
834msgid ""
835"If set to True then links in downloaded articles that point to other "
836"downloaded articles are changed to point to the downloaded copy of the "
837"article rather than its original web URL. If you set this to True, you might"
838" also need to implement :meth:`canonicalize_internal_url` to work with the "
839"URL scheme of your particular website."
840msgstr ""
841
842#: ../../__w/calibre/calibre/manual/docstring of
843#: calibre.web.feeds.news.BasicNewsRecipe.reverse_article_order:1
844msgid "Reverse the order of articles in each feed"
845msgstr ""
846
847#: ../../__w/calibre/calibre/manual/docstring of
848#: calibre.web.feeds.news.BasicNewsRecipe.scale_news_images:1
849msgid ""
850"Maximum dimensions (w,h) to scale images to. If scale_news_images_to_device "
851"is True this is set to the device screen dimensions set by the output "
852"profile unless there is no profile set, in which case it is left at whatever"
853" value it has been assigned (default None)."
854msgstr ""
855
856#: ../../__w/calibre/calibre/manual/docstring of
857#: calibre.web.feeds.news.BasicNewsRecipe.scale_news_images_to_device:1
858msgid ""
859"Rescale images to fit in the device screen dimensions set by the output "
860"profile. Ignored if no output profile is set."
861msgstr ""
862
863#: ../../__w/calibre/calibre/manual/docstring of
864#: calibre.web.feeds.news.BasicNewsRecipe.simultaneous_downloads:1
865msgid ""
866"Number of simultaneous downloads. Set to 1 if the server is picky. "
867"Automatically reduced to 1 if :attr:`BasicNewsRecipe.delay` > 0"
868msgstr ""
869
870#: ../../__w/calibre/calibre/manual/docstring of
871#: calibre.web.feeds.news.BasicNewsRecipe.summary_length:1
872msgid "Max number of characters in the short description"
873msgstr ""
874
875#: ../../__w/calibre/calibre/manual/docstring of
876#: calibre.web.feeds.news.BasicNewsRecipe.template_css:1
877msgid ""
878"The CSS that is used to style the templates, i.e., the navigation bars and "
879"the Tables of Contents. Rather than overriding this variable, you should use"
880" `extra_css` in your recipe to customize look and feel."
881msgstr ""
882
883#: ../../__w/calibre/calibre/manual/docstring of
884#: calibre.web.feeds.news.BasicNewsRecipe.timefmt:1
885msgid ""
886"The format string for the date shown on the first page. By default: "
887"Day_Name, Day_Number Month_Name Year"
888msgstr ""
889
890#: ../../__w/calibre/calibre/manual/docstring of
891#: calibre.web.feeds.news.BasicNewsRecipe.timeout:1
892msgid "Timeout for fetching files from server in seconds"
893msgstr ""
894
895#: ../../__w/calibre/calibre/manual/docstring of
896#: calibre.web.feeds.news.BasicNewsRecipe.title:1
897msgid "The title to use for the e-book"
898msgstr ""
899
900#: ../../__w/calibre/calibre/manual/docstring of
901#: calibre.web.feeds.news.BasicNewsRecipe.use_embedded_content:1
902msgid ""
903"Normally we try to guess if a feed has full articles embedded in it based on"
904" the length of the embedded content. If `None`, then the default guessing is"
905" used. If `True` then the we always assume the feeds has embedded content "
906"and if `False` we always assume the feed does not have embedded content."
907msgstr ""
908