calibre - en to ja translation catalogue (68 entries)

en: Adding your favorite news website
ja: お気に入りのニュースサイトを追加

en: calibre has a powerful, flexible and easy-to-use framework for downloading news from the Internet and converting it into an e-book. The following will show you, by means of examples, how to get news from various websites.
ja: calibre は、インターネットからニュースをダウンロードして電子書籍に変換するための、柔軟かつ強力で使いやすいフレームワークを備えています。下では例を用いて、さまざまな Web サイトからニュースを取得する方法を説明します。

en: To gain an understanding of how to use the framework, follow the examples in the order listed below:
ja: フレームワークの使い方を理解するには、下に並んでいる順に例を追ってください:

en: Completely automatic fetching
ja: 完全自動の取得

en: If your news source is simple enough, calibre may well be able to fetch it completely automatically, all you need to do is provide the URL. calibre gathers all the information needed to download a news source into a :term:`recipe`. In order to tell calibre about a news source, you have to create a :term:`recipe` for it. Let's see some examples:
ja: もしニュースソースが単純なものなら、calibre は完全に自動で取得することができます。必要なのは URL を与えることだけです。calibre はニュースソースのダウンロードに必要な情報を :term:`レシピ` に集めています。calibre にニュースソースについての情報を与えるためには、:term:`レシピ` を作る必要があります。では、いくつか例を見てみましょう。

en: The calibre blog
ja: calibre ブログ

en: The calibre blog is a blog of posts that describe many useful calibre features in a simple and accessible way for new calibre users. In order to download this blog into an e-book, we rely on the :term:`RSS` feed of the blog::
ja: calibre ブログには、calibre の新規ユーザが簡単に情報を入手できるよう、calibre の多くの便利な機能を説明する記事が置かれています。このブログをダウンロードして電子書籍にするのに、ブログの :term:`RSS` フィードを頼っています。

en: I got the RSS URL by looking under "Subscribe to" at the bottom of the blog page and choosing :guilabel:`Posts->Atom`. To make calibre download the feeds and convert them into an e-book, you should right click the :guilabel:`Fetch news` button and then the :guilabel:`Add a custom news source` menu item and then the :guilabel:`New Recipe` button. A dialog similar to that shown below should open up.
ja: RSS URL はブログページ下部の "Subscribe to" の下にある :guilabel:`Posts->Atom` を選択します。calibre にフィードをダウンロードして電子書籍に変換させるには、:guilabel:`ニュースを取得` を右クリックしてメニュー項目の :guilabel:`カスタムニュースソースを追加` を選択し、:guilabel:`新規レシピ` ボタンを押します。下に示すものと似たようなダイアログが表示されます。

en: First enter ``Calibre Blog`` into the :guilabel:`Recipe title` field. This will be the title of the e-book that will be created from the articles in the above feeds.
ja: まず :guilabel:`レシピのタイトル` フィールドに ``Calibre Blog`` と入力します。これは上記のフィードの記事から作成される電子書籍のタイトルとなります。

en: The next two fields (:guilabel:`Oldest article` and :guilabel:`Max. number of articles`) allow you some control over how many articles should be downloaded from each feed, and they are pretty self explanatory.
ja: 次のふたつのフィールド (:guilabel:`一番古い記事` および :guilabel:`記事の最大数`) を使って、各フィードからどれだけの記事をダウンロードするかを制御できます。意味は名前のとおりです。

en: To add the feeds to the recipe, enter the feed title and the feed URL and click the :guilabel:`Add feed` button. Once you have added the feed, simply click the :guilabel:`Save` button and you're done! Close the dialog.
ja: フィードをレシピに追加するには、フィードのタイトルと URL を入力して :guilabel:`フィードを追加` ボタンをクリックします。フィードを追加したら :guilabel:`保存` ボタンをクリックすれば完了です。ダイアログを閉じてください。

en: To test your new :term:`recipe`, click the :guilabel:`Fetch news` button and in the :guilabel:`Custom news sources` sub-menu click :guilabel:`calibre Blog`. After a couple of minutes, the newly downloaded e-book of blog posts will appear in the main library view (if you have your reader connected, it will be put onto the reader instead of into the library). Select it and hit the :guilabel:`View` button to read!
ja: :term:`レシピ` をテストするには、:guilabel:`ニュースを取得` ボタンをクリックして、サブメニュー :guilabel:`カスタムニュースソース` の中から :guilabel:`calibre Blog` をクリックします。数分後、新しくダウンロードしたブログ記事の電子書籍がメインのライブラリビューに (もしリーダーを接続していれば、ライブラリの代わりにリーダー上に) 現れます。それを選択して :guilabel:`表示` ボタンを押せば、読めます。

en: The reason this worked so well, with so little effort is that the blog provides *full-content* :term:`RSS` feeds, i.e., the article content is embedded in the feed itself. For most news sources that provide news in this fashion, with *full-content* feeds, you don't need any more effort to convert them to e-books. Now we will look at a news source that does not provide full content feeds. In such feeds, the full article is a webpage and the feed only contains a link to the webpage with a short summary of the article.
ja: ほとんど手間をかけることなくこれがうまく機能する理由は、ブログが *フルコンテンツの* :term:`RSS` フィードを提供しているためです。つまり、記事内容がフィード自体に埋めこまれているのです。ニュースをこの形、すなわち *フルコンテンツの* フィードで提供するほとんどのニュースソースでは、電子書籍に変換するのにこれ以上の手間は必要ありません。では、フルコンテンツのフィードを提供していないニュースソースについて見てみましょう。そのようなフィードには、記事の全文は Web ページにあり、フィードには短い要約とともにその Web ページへのリンクのみが含まれています。

en: Let's try the following two feeds from *The BBC*:
ja: 次の *The BBC* からのふたつのフィードを追ってみましょう:

en: News Front Page: https://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml
ja: ニュース一面: https://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml

en: Science/Nature: https://newsrss.bbc.co.uk/rss/newsonline_world_edition/science/nature/rss.xml
ja: 科学/自然: https://newsrss.bbc.co.uk/rss/newsonline_world_edition/science/nature/rss.xml

en: Follow the procedure outlined in :ref:`calibre_blog` above to create a recipe for *The BBC* (using the feeds above). Looking at the downloaded e-book, we see that calibre has done a creditable job of extracting only the content you care about from each article's webpage. However, the extraction process is not perfect. Sometimes it leaves in undesirable content like menus and navigation aids or it removes content that should have been left alone, like article headings. In order, to have perfect content extraction, we will need to customize the fetch process, as described in the next section.
ja: 上記の :ref:`calibre_blog` で概説した手順に沿って *The BBC* 用のレシピを (上のフィードを使って) 作成します。ダウンロードした電子書籍を見ると、calibre はそれぞれの記事の Web ページから読みたい記事だけを抽出する仕事を立派にこなしていることがわかります。しかし、その抽出の処理は完全ではありません。メニューやナビゲーションなどの望ましくないコンテンツがそのまま残っていたり、記事の見出しのような残しておくべきコンテンツを削除してしまっていることがあります。コンテンツの抽出を完璧に行うには、次の章で説明するように取得処理をカスタマイズする必要があります。

en: Customizing the fetch process
ja: 取得処理のカスタマイズ

en: When you want to perfect the download process, or download content from a particularly complex website, you can avail yourself of all the power and flexibility of the :term:`recipe` framework. In order to do that, in the :guilabel:`Add custom news sources` dialog, simply click the :guilabel:`Switch to Advanced mode` button.
ja: ダウンロード処理を完璧にしたいときや、特に複雑な Web サイトからコンテンツをダウンロードしたいときこそ、:term:`レシピ` フレームワークの威力と柔軟性が役立ちます。これには :guilabel:`カスタムニュースソースを追加` ダイアログで :guilabel:`上級者モードに切替え` をクリックします。

en: The easiest and often most productive customization is to use the print version of the online articles. The print version typically has much less cruft and translates much more smoothly to an e-book. Let's try to use the print version of the articles from *The BBC*.
ja: 最も簡単で、かつ多くの場合最も生産的なカスタマイズは、オンライン記事の印刷用バージョンを使うことです。印刷用バージョンは通例、よけいなものがはるかに少なく、電子書籍への変換もスムーズに行えます。*The BBC* の記事の印刷用バージョンを使ってみましょう.

en: Using the print version of bbc.co.uk
ja: bbc.co.uk のプリント用バージョンを使用

en: The first step is to look at the e-book we downloaded previously from :ref:`bbc`. At the end of each article, in the e-book is a little blurb telling you where the article was downloaded from. Copy and paste that URL into a browser. Now on the article webpage look for a link that points to the "Printable version". Click it to see the print version of the article. It looks much neater! Now compare the two URLs. For me they were:
ja: 最初のステップは、以前 :ref:`bbc` からダウンロードした電子書籍を確認することです。各記事の末尾に、電子書籍ではその記事がどこからダウンロードされたものなのかを示す小さな記載があります。その URL をブラウザにコピーして貼り付けてください。では、記事の Web ページ上で "Printable version" へのリンクを探しましょう。それをクリックして記事の印刷用バージョンを見てみます。こちらの方がずっときれいです。さて、ふたつの URL を比較してみましょう。次のように見えます:

en: Article URL
ja: 記事の URL

en: Print version URL
ja: 印刷用バージョンの URL

en: So it looks like to get the print version, we need to prefix every article URL with:
ja: したがって印刷用バージョンを入手するためには、すべての記事の URL に次のプレフィックスをつける必要がありそうです:

en: 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):
ja: これでカスタムニュースソースダイアログの :guilabel:`上級者モード` に入りました。次のように表示されます (上級者モードに切り替える前に、忘れずに *The BBC* レシピを選択してください):

en: You can see that the fields from the :guilabel:`Basic mode` have been translated to Python code in a straightforward manner. We need to add instructions to this recipe to use the print version of the articles. All that's needed is to add the following two lines:
ja: :guilabel:`ベーシックモード` のフィールドが Python コードに簡単な方法で変換されていることがわかります。このレシピに、記事のプリント用バージョンを利用するよう指示を加える必要があります。必要なのは、次の 2 行を追加することです:

en: This is Python, so indentation is important. After you've added the lines, it should look like:
ja: これは Python なので、インデントが重要です。行を追加すると、次のようになります:

en: In the above, ``def print_version(self, url)`` defines a *method* that is called by calibre 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 <https://www.python.org>`_ see the `tutorial <https://docs.python.org/tutorial/>`_.
ja: 上では ``def print_version(self, url)`` は記事ごとに calibre から呼び出される *メソッド* を定義しています。``url`` は元の記事の URL です。``print_version`` は、その URL を記事の印刷用バージョンを指す新しい URL で置き換えます。 `Python <https://www.python.org>`_ について学習するには、 `チュートリアル <https://docs.python.org/tutorial/>`_ を参照してください。

en: Now, click the :guilabel:`Add/update recipe` button and your changes will be saved. Re-download the e-book. You should have a much improved e-book. 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 e-book, but even after the fixing process, the font size of the menus and navigation bar become too large relative to the article text. To fix this, we will do some more customization, in the next section.
ja: 次に、:guilabel:`保存` ボタンを押すと変更が保存されます。電子書籍を再ダウンロードしてください。電子書籍はかなり改善されているはずです。この新しいバージョンの問題点のひとつは、印刷用バージョンの Web ページのフォントは小さすぎることです。これは電子書籍への変換時に自動的に修正されますが、修正処理の後でも、メニューとナビゲーションバーのフォントサイズは記事のテキストと比較して大きくなりすぎます。これを修正するには、次の章で説明するようにさらにカスタマイズが必要です。

en: Replacing article styles
ja: 記事のスタイルを置換

en: In the previous section, we saw that the font size for articles from the print version of *The BBC* was too small. In most websites, *The BBC* included, this font size is set by means of :term:`CSS` stylesheets. We can disable the fetching of such stylesheets by adding the line::
ja: 前の章では、*The BBC* の印刷用バージョンの記事のフォントサイズが小さすぎることを確認しました。*The BBC* を含めほとんどの Web サイトでは、このフォントサイズを :term:`CSS` スタイルシートを使って設定しています。そのようなスタイルシートの取得は、次の行を加えることでやめさせられます:

en: The recipe now looks like:
ja: レシピは次のようになります:

en: The new version looks pretty good. If you're a perfectionist, you'll want to read the next section, which deals with actually modifying the downloaded content.
ja: 新しいバージョンは大変よくなりました。完全主義者であれば、ダウンロードしたコンテンツを実際に変更することを扱う次の章を読むことをお勧めします。

en: Slicing and dicing
ja: スライス&ダイス分析

en: calibre contains very powerful and flexible abilities when it comes to manipulating downloaded content. To show off a couple of these, let's look at our old friend the :ref:`The BBC <bbc1>` recipe again. Looking at the source code (:term:`HTML`) of a couple of articles (print version), we see that they have a footer that contains no useful information, contained in
ja: ダウンロードしたコンテンツの処理にかけては、calibre には非常に強力で柔軟性のある機能を持っています。いくつか紹介するために、もはやお馴染みとなった :ref:`The BBC <bbc1>` レシピをもう一度見てみましょう。いくつかの記事 (印刷用バージョン) のソースコード (:term:`HTML`) を見ると、下で示すフッタ部分には有用な情報が含まれていないことがわかります。

en: This can be removed by adding::
ja: これはレシピに次を追加することで削除できます::

en: 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 e-book::
ja: 最後に、以前無効にした :term:`CSS` の一部を、電子書籍への変換に適した自前の :term:`CSS` に置き換えましょう。

en: With these additions, our recipe has become "production quality".
ja: こうした追加によって、レシピは「製品レベルの品質」になりました。

en: This :term:`recipe` explores only the tip of the iceberg when it comes to the power of calibre. To explore more of the abilities of calibre we'll examine a more complex real life example in the next section.
ja: この :term:`レシピ` は calibre の威力に関する氷山の一角に触れたにすぎません。calibre の能力にさらに触れるため、次の章ではより複雑な実例を取り上げます。

en: Real life example
ja: 実例

en: A reasonably complex real life example that exposes more of the :term:`API` of ``BasicNewsRecipe`` is the :term:`recipe` for *The New York Times*
ja: ``BasicNewsRecipe`` の :term:`API` を体験できる適度に複雑な実例は、*The New York Times* の :term:`レシピ` です。

en: We see several new features in this :term:`recipe`. First, we have::
ja: この :term:`レシピ` にはいくつか新しい機能があります。まず、次のものがあります::

en: This sets the displayed time on the front page of the created e-book to be in the format, ``Day, Day_Number Month, Year``. See :attr:`timefmt <calibre.web.feeds.news.BasicNewsRecipe.timefmt>`.
ja: これは作成する電子書籍のとびらに日付を ``曜日, 日 月, 年`` の形式で表示します。:attr:`timefmt <calibre.web.feeds.news.BasicNewsRecipe.timefmt>` を参照してください。

en: Then we see a group of directives to cleanup the downloaded :term:`HTML`::
ja: そして、ダウンロードした :term:`HTML` をきれいにするための指令のかたまりがあるのがわかります。

en: These remove everything before the first ``<h1>`` tag and everything after the first tag whose id is ``footer``. See :attr:`remove_tags <calibre.web.feeds.news.BasicNewsRecipe.remove_tags>`, :attr:`remove_tags_before <calibre.web.feeds.news.BasicNewsRecipe.remove_tags_before>`, :attr:`remove_tags_after <calibre.web.feeds.news.BasicNewsRecipe.remove_tags_after>`.
ja: これは最初の ``<h1>`` の前にあるすべてと、id が ``footer`` である最初のタグの後ろのすべてを削除します。:attr:`remove_tags <calibre.web.feeds.news.BasicNewsRecipe.remove_tags>`, :attr:`remove_tags_before <calibre.web.feeds.news.BasicNewsRecipe.remove_tags_before>`, :attr:`remove_tags_after <calibre.web.feeds.news.BasicNewsRecipe.remove_tags_after>` を参照してください。

en: The next interesting feature is::
ja: 次の興味深い機能は次のものです::

en: ``needs_subscription = True`` tells calibre that this recipe needs a username and password in order to access the content. This causes, calibre 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, calibre will use the same, logged in, browser instance to fetch all content. See `mechanize <https://mechanize.readthedocs.io/en/latest/>`_ to understand the code in ``get_browser``.
ja: ``needs_subscription = True`` はコンテンツにアクセスするためにユーザ名とパスワードが必要であることを calibre に伝えます。これにより、calibre はこのレシピを使うたびにユーザ名とパスワードを要求します。:meth:`calibre.web.feeds.news.BasicNewsRecipe.get_browser` の中のコードで、実際に NYT の Web サイトにログインしています。ログインすると、同じログイン済みのブラウザインスタンスを使用してすべてのコンテンツを取得します。``get_browser`` のコードを理解するには `mechanize <https://mechanize.readthedocs.io/en/latest/>`_ を参照してください。

en: The next new feature is the :meth:`calibre.web.feeds.news.BasicNewsRecipe.parse_index` method. Its job is to go to https://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 e-book that corresponds very closely to the days paper. ``parse_index`` makes heavy use of `BeautifulSoup <https://www.crummy.com/software/BeautifulSoup/bs4/doc/>`_ to parse the daily paper webpage. You can also use other, more modern parsers if you dislike BeautifulSoup. calibre comes with `lxml <https://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::
ja: 次の新しい機能は :meth:`calibre.web.feeds.news.BasicNewsRecipe.parse_index` メソッドです。こいつの仕事は https://www.nytimes.com/pages/todayspaper/index.html へ行き、 *今日の* 新聞に掲載されている記事のリストを取得することです。:term:`RSS` を使用するだけと比べると複雑ですが、このレシピはその日の新聞に非常に近い電子書籍を作成します。``parse_index`` は日刊紙の Web サイトを解析するのに `BeautifulSoup <https://www.crummy.com/software/BeautifulSoup/bs4/doc/>`_ を多用します。BeautifulSoup が気に入らなければ、もっとモダンな別のパーサを利用することもできます。calibre には推奨パーサである `lxml <https://lxml.de/>`_ と `html5lib <https://github.com/html5lib/html5lib-python>`_ が付属しています。これを使用するには、``index_to_soup()`` の呼び出しを次のもので置き換えてください::

en: The final new feature is the :meth:`calibre.web.feeds.news.BasicNewsRecipe.preprocess_html` method. It can be used to perform arbitrary transformations on every downloaded HTML page. Here it is used to bypass the ads that the nytimes shows you before each article.
ja: 最後の新しい機能は :meth:`calibre.web.feeds.news.BasicNewsRecipe.preprocess_html` メソッドです。ダウンロードした HTML ページごとに任意の変換を行うために利用できます。ここでは記事の前に表示される広告をよけるために使用しています。

en: Tips for developing new recipes
ja: 新しいレシピを開発するコツ

en: 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::
ja: 新しいレシピを開発するのに最適なのは、コマンドラインインタフェースを利用することです。好みの Python エディタを使ってレシピを作成し、たとえば :file:`myrecipe.recipe` のようなファイルに保存します。拡張子は `.recipe` とする必要があります。このレシピを使ってコンテンツをダウンロードするには、次のコマンドを使用します::

en: The command :command:`ebook-convert` will download all the webpages and save them to the EPUB file :file:`myrecipe.epub`. The ``-vv`` option makes ebook-convert spit out a lot of information about what it is doing. The :option:`ebook-convert-recipe-input --test` option 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`` folder, where ``debug`` is the folder you specified in the :option:`ebook-convert --debug-pipeline` option.
ja: :command:`ebook-convert` コマンドは、すべての Web ページをダウンロードして :file:`myrecipe.epub` という EPUB ファイルに保存します。``-vv`` オプションを使うと、最大 2 つのフィードから数記事のみをダウンロードします。さらに、ebook-convert はダウンロードした HTML を ``debug/input`` フォルダに置きます。``debug`` は :option:`ebook-convert --debug-pipeline` オプションで指定したフォルダです。

en: 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 e-books in different formats as shown below::
ja: ダウンロードが完了したら、ブラウザで :file:`debug/input/index.html` ファイルを開いてダウンロードした :term:`HTML` を確認できます。ダウンロードと前処理が正しく行われていることを確認できたら、下に示すようにさまざまな形式の電子書籍を生成できます::

en: 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 <https://www.mobileread.com/forums/forumdisplay.php?f=228>`_ to share it with other calibre users.
ja: 作成したレシピに満足して、calibre のビルトインレシピに含めるに十分なだけの需要があると感じた場合には、 `calibre レシピフォーラム <https://www.mobileread.com/forums/forumdisplay.php?f=228>`_  に投稿して他のユーザと共有してください 。

en: On macOS, the command line tools are inside the calibre bundle, for example, if you installed calibre in :file:`/Applications` the command line tools are in :file:`/Applications/calibre.app/Contents/MacOS/`.
ja: macOS では、コマンドラインツールは calibre バンドルの中にあります。たとえば calibre を :file:`/Applications` にインストールしたのであれば、コマンドラインツールは :file:`/Applications/calibre.app/Contents/console.app/Contents/MacOS/` にあります。

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

en: The command line interface for all e-book conversion.
ja: すべての電子書籍変換用のコマンドラインインタフェース。

en: Further reading
ja: 参考文献

en: To learn more about writing advanced recipes using some of the facilities, available in ``BasicNewsRecipe`` you should consult the following sources:
ja: ``BasicNewsRecipe`` で利用可能な機能を利用して上級レシピを作成する方法をさらに学ぶには、下のソースを参照してください:

en: :ref:`API documentation <news_recipe>`
ja: :ref:`API 取扱説明書 <news_recipe>`

en: Documentation of the ``BasicNewsRecipe`` class and all its important methods and fields.
ja: ``BasicNewsRecipe`` クラスと、すべての重要なメソッドおよびフィールドについての取扱説明書です。

en: The source code of ``BasicNewsRecipe``
ja: ``BasicNewsRecipe`` のソースコード

en: `Built-in recipes <https://github.com/kovidgoyal/calibre/tree/master/recipes>`_
ja: `ビルトインレシピ <https://github.com/kovidgoyal/calibre/tree/master/recipes>`_

en: The source code for the built-in recipes that come with calibre
ja: calibre に付属しているビルトインレシピのソースコード

en: `The calibre recipes forum <https://www.mobileread.com/forums/forumdisplay.php?f=228>`_
ja: `calibre レシピフォーラム <https://www.mobileread.com/forums/forumdisplay.php?f=228>`_

en: Lots of knowledgeable calibre recipe writers hang out here.
ja: 知識豊富なレシピ作者の多くがここにたむろしています。

en: API documentation
ja: API 取扱説明書
