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