# SOME DESCRIPTIVE TITLE.
# Copyright (C) Kovid Goyal
# This file is distributed under the same license as the calibre package.
# 
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: calibre\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2014-08-29 09:29+0530\n"
"PO-Revision-Date: 2014-08-29 04:01+0000\n"
"Last-Translator: Kovid Goyal <kovid@kovidgoyal.net>\n"
"Language-Team: Breton (http://www.transifex.com/projects/p/calibre/language/br/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: br\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"

# 08a7183c742c48b6ae5ac49f61a61c6a
#: ../../home/kovid/work/calibre/manual/news.rst:5
msgid "Adding your favorite news website"
msgstr ""

# 923676c26c3a46c9a5b0a1e5093704f0
#: ../../home/kovid/work/calibre/manual/news.rst:7
msgid ""
"|app| has a powerful, flexible and easy-to-use framework for downloading "
"news from the Internet and converting it into an ebook. The following will "
"show you, by means of examples, how to get news from various websites."
msgstr ""

# 2aa7abff2ed5457991c9146e4405b42d
#: ../../home/kovid/work/calibre/manual/news.rst:9
msgid ""
"To gain an understanding of how to use the framework, follow the examples in"
" the order listed below:"
msgstr ""

# 3c17134d9f6d48df9d91d2ddc9d979c3
#: ../../home/kovid/work/calibre/manual/news.rst:16
msgid "Completely automatic fetching"
msgstr ""

# 9bed465ff1c24e22a9ea258ae9486915
#: ../../home/kovid/work/calibre/manual/news.rst:18
msgid ""
"If your news source is simple enough, |app| may well be able to fetch it "
"completely automatically, all you need to do is provide the URL. |app| "
"gathers all the information needed to download a news source into a "
":term:`recipe`. In order to tell |app| about a news source, you have to "
"create a :term:`recipe` for it. Let's see some examples:"
msgstr ""

# e54080cc57eb43f686a6ccc823aee94c
#: ../../home/kovid/work/calibre/manual/news.rst:23
msgid "portfolio.com"
msgstr ""

# a1a51a2c9362455289e0ac095ab21318
#: ../../home/kovid/work/calibre/manual/news.rst:25
msgid ""
"*portfolio.com* is the website for *Condé Nast Portfolio*, a business "
"related magazine. In order to download articles from the magazine and "
"convert them to ebooks, we rely on the :term:`RSS` feeds of portfolio.com. A"
" list of such feeds is available at http://www.portfolio.com/rss/."
msgstr ""

# 1a69c02346ae413181101fdb5a93f77b
#: ../../home/kovid/work/calibre/manual/news.rst:27
msgid "Lets pick a couple of feeds that look interesting:"
msgstr ""

# c1aaa9c816874389926650ffb77e4245
#: ../../home/kovid/work/calibre/manual/news.rst:29
msgid "Business Travel: http://feeds.portfolio.com/portfolio/businesstravel"
msgstr ""

# fa02e41e41024138bd918449f0dc133f
#: ../../home/kovid/work/calibre/manual/news.rst:30
msgid "Tech Observer: http://feeds.portfolio.com/portfolio/thetechobserver"
msgstr ""

# 89adbe15b1e04e4aa16e448c8316261c
#: ../../home/kovid/work/calibre/manual/news.rst:32
msgid ""
"I got the URLs by clicking the little orange RSS icon next to each feed "
"name. To make |app| download the feeds and convert them into an ebook, you "
"should right click the :guilabel:`Fetch news` button and then the "
":guilabel:`Add a custom news source` menu item. A dialog similar to that "
"shown below should open up."
msgstr ""

# 05e15157c9d04b0e8d0380f9bfa45bca
#: ../../home/kovid/work/calibre/manual/news.rst:37
msgid ""
"First enter ``Portfolio`` into the :guilabel:`Recipe title` field. This will"
" be the title of the ebook that will be created from the articles in the "
"above feeds."
msgstr ""

# a6caed95dc674f78a99f279476bee071
#: ../../home/kovid/work/calibre/manual/news.rst:39
msgid ""
"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."
msgstr ""

# 2cac88b925aa4cef8aa44cc7db4dbff1
#: ../../home/kovid/work/calibre/manual/news.rst:41
msgid ""
"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 both feeds, "
"simply click the :guilabel:`Add/update recipe` button and you're done! Close"
" the dialog."
msgstr ""

# d1e7de0d1a384ad1b6a99821af4e5556
#: ../../home/kovid/work/calibre/manual/news.rst:43
msgid ""
"To test your new :term:`recipe`, click the :guilabel:`Fetch news` button and"
" in the :guilabel:`Custom news sources` sub-menu click "
":guilabel:`Portfolio`. After a couple of minutes, the newly downloaded "
"Portfolio ebook 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!"
msgstr ""

# f9a35b1ceb8b421793be92ff26fc6ffd
#: ../../home/kovid/work/calibre/manual/news.rst:45
msgid ""
"The reason this worked so well, with so little effort is that "
"*portfolio.com* 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 ebooks. 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."
msgstr ""

# 8aa64ae366674c1798d3f7319bdd5af1
#: ../../home/kovid/work/calibre/manual/news.rst:50
msgid "bbc.co.uk"
msgstr ""

# 17817b87a7ae4d6b932eb667ea7acf97
#: ../../home/kovid/work/calibre/manual/news.rst:52
msgid "Lets try the following two feeds from *The BBC*:"
msgstr ""

# e85bba940a3f4341970ff94210908fed
#: ../../home/kovid/work/calibre/manual/news.rst:54
msgid ""
"News Front Page: "
"http://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml"
msgstr ""

# 2508b82379c74caf8259256936583ebf
#: ../../home/kovid/work/calibre/manual/news.rst:55
msgid ""
"Science/Nature: "
"http://newsrss.bbc.co.uk/rss/newsonline_world_edition/science/nature/rss.xml"
msgstr ""

# a1e019ec789e46b099e62a3d8e6a0188
#: ../../home/kovid/work/calibre/manual/news.rst:57
msgid ""
"Follow the procedure outlined in :ref:`portfolio` to create a recipe for "
"*The BBC* (using the feeds above). Looking at the downloaded ebook, we see "
"that |app| 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."
msgstr ""

# efe223c96298452087e86aa874d1d4e6
#: ../../home/kovid/work/calibre/manual/news.rst:60
msgid "Customizing the fetch process"
msgstr ""

# 24906f6350484f018482021f079d82ca
#: ../../home/kovid/work/calibre/manual/news.rst:62
msgid ""
"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."
msgstr ""

# f82db363260547748609b014d945c47b
#: ../../home/kovid/work/calibre/manual/news.rst:64
msgid ""
"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 ebook. Let's try to use the "
"print version of the articles from *The BBC*."
msgstr ""

# 0ad068eee2c24d57a318d8f70073fc0a
#: ../../home/kovid/work/calibre/manual/news.rst:67
msgid "Using the print version of bbc.co.uk"
msgstr ""

# 27190b8ee80642c79070a62bb7a54636
#: ../../home/kovid/work/calibre/manual/news.rst:69
msgid ""
"The first step is to look at the ebook we downloaded previously from "
":ref:`bbc`. At the end of each article, in the ebook 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:"
msgstr ""

# cd32aeffe7694c699c4f2fad42ff30e7
#: ../../home/kovid/work/calibre/manual/news.rst:72
msgid "Article URL"
msgstr ""

# a35a051d5e264820a687f51bb482a941
#: ../../home/kovid/work/calibre/manual/news.rst:72
msgid "http://news.bbc.co.uk/2/hi/science/nature/7312016.stm"
msgstr ""

# 591bb2eb11a549718e5838f7c3180dee
#: ../../home/kovid/work/calibre/manual/news.rst:75
msgid "Print version URL"
msgstr ""

# 4fc7579d9ef9482a89bc67a6f5a90544
#: ../../home/kovid/work/calibre/manual/news.rst:75
msgid ""
"http://newsvote.bbc.co.uk/mpapps/pagetools/print/news.bbc.co.uk/2/hi/science/nature/7312016.stm"
msgstr ""

# 0ab8244465b144038db6ac75eaa03020
#: ../../home/kovid/work/calibre/manual/news.rst:77
msgid ""
"So it looks like to get the print version, we need to prefix every article "
"URL with:"
msgstr ""

# 8442ee4c30944bf59a9d33c5fd8e69e6
#: ../../home/kovid/work/calibre/manual/news.rst:79
msgid "newsvote.bbc.co.uk/mpapps/pagetools/print/"
msgstr ""

# 9af7a65e49d140818cf0d13c213945b3
#: ../../home/kovid/work/calibre/manual/news.rst:81
msgid ""
"Now in the :guilabel:`Advanced Mode` of the Custom  news sources dialog, you"
" should see something like (remember to select *The BBC* recipe before "
"switching to advanced mode):"
msgstr ""

# d4d8071abfa94e73832651fff73fe464
#: ../../home/kovid/work/calibre/manual/news.rst:86
msgid ""
"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:"
msgstr ""

# e8375da0210c4240b8472c3ae8d64321
#: ../../home/kovid/work/calibre/manual/news.rst:93
msgid ""
"This is python, so indentation is important. After you've added the lines, "
"it should look like:"
msgstr ""

# 0f4ab6b40a8846a68c94352400d6222c
#: ../../home/kovid/work/calibre/manual/news.rst:98
msgid ""
"In the above, ``def print_version(self, url)`` defines a *method* that is "
"called by |app| for every article. ``url`` is the URL of the original "
"article. What ``print_version`` does is take that url and replace it with "
"the new URL that points to the print version of the article. To learn about "
"`python <http://www.python.org>`_ see the `tutorial "
"<http://docs.python.org/tut/>`_."
msgstr ""

# 284398045c384953be18d9041c09aec8
#: ../../home/kovid/work/calibre/manual/news.rst:100
msgid ""
"Now, click the :guilabel:`Add/update recipe` button and your changes will be"
" saved. Re-download the ebook. You should have a much improved ebook. One of"
" the problems with the new version is that the fonts on the print version "
"webpage are too small. This is automatically fixed when converting to an "
"ebook, but even after the fixing process, the font size of the menus and "
"navigation bar to become too large relative to the article text. To fix "
"this, we will do some more customization, in the next section."
msgstr ""

# 6a5ea8760e144e5fad02167265153851
#: ../../home/kovid/work/calibre/manual/news.rst:103
msgid "Replacing article styles"
msgstr ""

# 403bd01ac7914dddbba6671c9bacee80
#: ../../home/kovid/work/calibre/manual/news.rst:105
msgid ""
"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::"
msgstr ""

# 8c50f6ca40c94e1e93241e8825d0df60
#: ../../home/kovid/work/calibre/manual/news.rst:109
msgid "The recipe now looks like:"
msgstr ""

# 5a850f1a97b84d5e84d3881388f0be41
#: ../../home/kovid/work/calibre/manual/news.rst:116
msgid ""
"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."
msgstr ""

# be3841629eef4564a7679937763e9113
#: ../../home/kovid/work/calibre/manual/news.rst:119
msgid "Slicing and dicing"
msgstr ""

# a7fa0187b4b24fbcbe879f48b5a0b53b
#: ../../home/kovid/work/calibre/manual/news.rst:121
msgid ""
"|app| 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"
msgstr ""

# 384682edf79642d99c06d0cd3d223b05
#: ../../home/kovid/work/calibre/manual/news.rst:129
msgid "This can be removed by adding::"
msgstr ""

# 6382c97569f14812a7d51a677783c0ef
#: ../../home/kovid/work/calibre/manual/news.rst:133
msgid ""
"to the recipe. Finally, lets replace some of the :term:`CSS` that we "
"disabled earlier, with our own :term:`CSS` that is suitable for conversion "
"to an ebook::"
msgstr ""

# c7facd68161347c994d71a45c6014081
#: ../../home/kovid/work/calibre/manual/news.rst:137
msgid ""
"With these additions, our recipe has become \"production quality\", indeed "
"it is very close to the actual recipe used by |app| for the *BBC*, shown "
"below:"
msgstr ""

# 0169f8318e2241ccaa98e69934e41e66
#: ../../home/kovid/work/calibre/manual/news.rst:141
msgid ""
"This :term:`recipe` explores only the tip of the iceberg when it comes to "
"the power of |app|. To explore more of the abilities of |app| we'll examine "
"a more complex real life example in the next section."
msgstr ""

# 929d85dd49574b6caee108e41b329375
#: ../../home/kovid/work/calibre/manual/news.rst:144
msgid "Real life example"
msgstr ""

# 4e95da9d02e74b7895acab67648bbde4
#: ../../home/kovid/work/calibre/manual/news.rst:146
msgid ""
"A reasonably complex real life example that exposes more of the :term:`API` "
"of ``BasicNewsRecipe`` is the :term:`recipe` for *The New York Times*"
msgstr ""

# 4da89c994b5c44df946defa933dc4223
#: ../../home/kovid/work/calibre/manual/news.rst:232
msgid "We see several new features in this :term:`recipe`. First, we have::"
msgstr ""

# ebb55c38ae7e445ba6126ec0a28e56de
#: ../../home/kovid/work/calibre/manual/news.rst:236
msgid ""
"This sets the displayed time on the front page of the created ebook to be in"
" the format, ``Day, Day_Number Month, Year``. See :attr:`timefmt "
"<calibre.web.feeds.news.BasicNewsRecipe.timefmt>`."
msgstr ""

# 093b99523740456facfa3d30d92b5ccc
#: ../../home/kovid/work/calibre/manual/news.rst:239
msgid ""
"Then we see a group of directives to cleanup the downloaded :term:`HTML`::"
msgstr ""

# f7d533b76545414ebdffa9729153603c
#: ../../home/kovid/work/calibre/manual/news.rst:245
msgid ""
"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>`."
msgstr ""

# d1d100d1488f48fcb06c2d8a4eada514
#: ../../home/kovid/work/calibre/manual/news.rst:247
msgid "The next interesting feature is::"
msgstr ""

# 2e74494f824e46408b8c946c0b19f620
#: ../../home/kovid/work/calibre/manual/news.rst:254
msgid ""
"``needs_subscription = True`` tells |app| that this recipe needs a username "
"and password in order to access the content. This causes, |app| to ask for a"
" username and password whenever you try to use this recipe. The code in "
":meth:`calibre.web.feeds.news.BasicNewsRecipe.get_browser` actually does the"
" login into the NYT website. Once logged in, |app| will use the same, logged"
" in, browser instance to fetch all content. See `mechanize "
"<http://wwwsearch.sourceforge.net/mechanize/>`_ to understand the code in "
"``get_browser``."
msgstr ""

# af6a78ae08cf4314b0c6df273b69a94a
#: ../../home/kovid/work/calibre/manual/news.rst:256
msgid ""
"The next new feature is the "
":meth:`calibre.web.feeds.news.BasicNewsRecipe.parse_index` method. Its job "
"is to go to http://www.nytimes.com/pages/todayspaper/index.html and fetch "
"the list of articles that appear in *todays* paper. While more complex than "
"simply using :term:`RSS`, the recipe creates an ebook that corresponds very "
"closely to the days paper. ``parse_index`` makes heavy use of `BeautifulSoup"
" <http://www.crummy.com/software/BeautifulSoup/documentation.html>`_ to "
"parse the daily paper webpage. You can also use other, more modern parsers "
"if you dislike BeatifulSoup. calibre comes with `lxml <http://lxml.de/>`_ "
"and `html5lib <https://github.com/html5lib/html5lib-python>`_, which are the"
" recommended parsers. To use them, replace the call to ``index_to_soup()`` "
"with the following::"
msgstr ""

# ac77198988ba4269b895a7a1ec796b6b
#: ../../home/kovid/work/calibre/manual/news.rst:277
msgid ""
"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."
msgstr ""

# efa84ecda7704b0987ceb69456c292f7
#: ../../home/kovid/work/calibre/manual/news.rst:280
msgid "Tips for developing new recipes"
msgstr ""

# 2cf3308d6bd3438cbf73b358751a50e3
#: ../../home/kovid/work/calibre/manual/news.rst:282
msgid ""
"The best way to develop new recipes is to use the command line interface. "
"Create the recipe using your favorite python editor and save it to a file "
"say :file:`myrecipe.recipe`. The `.recipe` extension is required. You can "
"download content using this recipe with the command::"
msgstr ""

# 311ed39a1f9244149bcd4d4eb1343376
#: ../../home/kovid/work/calibre/manual/news.rst:286
msgid ""
"The command :command:`ebook-convert` will download all the webpages and save"
" them to the EPUB file :file:`myrecipe.epub`. The :option:`-vv` makes ebook-"
"convert spit out a lot of information about what it is doing. The "
":option:`--test` makes it download only a couple of articles from at most "
"two feeds. In addition, ebook-convert will put the downloaded HTML into the "
"``debug/input`` directory, where ``debug`` is the directory you specified in"
" the :option:`--debug-pipeline` option."
msgstr ""

# ac4a80b991a6472c85349afbc3d8eebd
#: ../../home/kovid/work/calibre/manual/news.rst:288
msgid ""
"Once the download is complete, you can look at the downloaded :term:`HTML` "
"by opening the file :file:`debug/input/index.html` in a browser. Once you're"
" satisfied that the download and preprocessing is happening correctly, you "
"can generate ebooks in different formats as shown below::"
msgstr ""

# 21544ab77f814288807004997ed7a78c
#: ../../home/kovid/work/calibre/manual/news.rst:295
msgid ""
"If you're satisfied with your recipe, and you feel there is enough demand to"
" justify its inclusion into the set of built-in recipes, post your recipe in"
" the `calibre recipes forum "
"<http://www.mobileread.com/forums/forumdisplay.php?f=228>`_ to share it with"
" other calibre users."
msgstr ""

# a69063e908934238901c17f3cb5509a5
#: ../../home/kovid/work/calibre/manual/news.rst:298
msgid ""
"On OS X, the command line tools are inside the |app| bundle, for example, if"
" you installed calibre in :file:`/Applications` the command line tools are "
"in :file:`/Applications/calibre.app/Contents/console.app/Contents/MacOS/`."
msgstr ""

# 22434352e8a54e2484917f24f620a77f
#: ../../home/kovid/work/calibre/manual/news.rst:304
msgid ":ref:`ebook-convert`"
msgstr ""

# 0db4c1fe0ab74c0faec9bc9f5b57090d
#: ../../home/kovid/work/calibre/manual/news.rst:305
msgid "The command line interface for all ebook conversion."
msgstr ""

# 0c926f00ec97414d9a49af0f7a97f184
#: ../../home/kovid/work/calibre/manual/news.rst:309
msgid "Further reading"
msgstr ""

# 32f7ec0ba540408f96384c071dbe2b08
#: ../../home/kovid/work/calibre/manual/news.rst:311
msgid ""
"To learn more about writing advanced recipes using some of the facilities, "
"available in ``BasicNewsRecipe`` you should consult the following sources:"
msgstr ""

# 90fd687cf39c4408b57ec47a4e0715e5
#: ../../home/kovid/work/calibre/manual/news.rst:314
msgid ":ref:`API Documentation <news_recipe>`"
msgstr ""

# 5a87cdb6af4d43a18625fb5d939ac445
#: ../../home/kovid/work/calibre/manual/news.rst:314
msgid ""
"Documentation of the ``BasicNewsRecipe`` class and all its important methods"
" and fields."
msgstr ""

# fb68c9c1941e4316a600f4f6f458e748
#: ../../home/kovid/work/calibre/manual/news.rst:317
msgid ""
"`BasicNewsRecipe "
"<http://bazaar.launchpad.net/~kovid/calibre/trunk/annotate/head:/src/calibre/web/feeds/news.py>`_"
msgstr ""

# 94a657ab763944519cacadd1ae6b7c2e
#: ../../home/kovid/work/calibre/manual/news.rst:317
msgid "The source code of ``BasicNewsRecipe``"
msgstr ""

# c3a3f34169a94602a5ea60dd9efe1e7e
#: ../../home/kovid/work/calibre/manual/news.rst:320
msgid ""
"`Built-in recipes "
"<http://bazaar.launchpad.net/~kovid/calibre/trunk/files/head:/recipes/>`_"
msgstr ""

# 46592da4e7d44c42bad0deeb4d4cdd4d
#: ../../home/kovid/work/calibre/manual/news.rst:320
msgid "The source code for the built-in recipes that come with |app|"
msgstr ""

# fb1149f8bb914fdd8f2c87ca91693654
#: ../../home/kovid/work/calibre/manual/news.rst:324
msgid ""
"`The calibre recipes forum "
"<http://www.mobileread.com/forums/forumdisplay.php?f=228>`_"
msgstr ""

# 8e94e0933af6498b9b5b7d341db163ae
#: ../../home/kovid/work/calibre/manual/news.rst:323
msgid "Lots of knowledgeable |app| recipe writers hang out here."
msgstr ""

# a259004e246341e18aa5346d31071458
#: ../../home/kovid/work/calibre/manual/news.rst:327
msgid "API documentation"
msgstr ""
