calibre - en to ms translation catalogue (60 entries)

en: Adding your favorite news website
ms: Menambah laman sesawang berita kegemaran anda

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.
ms: calibre mempunyai bingkai kerja yang hebat, fleksibel dan mudah digunakan untuk memuat turun berita dari Internet dan menukar ia menjadi e-buku. Yang berikut akan menunjukkan kepada anda, dengan contoh bagaimana hendak dapatkan berita dari pelbagai laman sesawang.

en: To gain an understanding of how to use the framework, follow the examples in the order listed below:
ms: Untuk memahami bagaimana hendak guna bingkai kerja, ikuti contoh yang tersenarai tertib di bawah:

en: Completely automatic fetching
ms: Pemerolehan automatik sepenuhnya

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:
ms: Jika sumber berita anda adalah ringkas, calibre boleh mendapatkannya dengan sepenuhnya secara automatik, apa yang anda perlu sediakan adalah URL. calibre menghimpun semua maklumat yang diperlukan untuk memuat turun sumber berita dalam bentuk :term:`resepi`. Untuk memberitahu calibre berkenaan sumber beritah, anda perlu cipta :term:`resepi` untuknya. Ok, mari kita lihat beberapa contoh yang disediakan:

en: The calibre blog
ms: Blog calibre

en: The calibre blog is a blog of posts that describe many useful calibre features in a simple and accessible way for new calibre users. In order to download this blog into an e-book, we rely on the :term:`RSS` feed of the blog::
ms: Blog calibre adalah blog pos yang menjelaskan banyak fitur calibre yang berguna dalam cara yang mudah dan boleh dicapai untuk pengguna baru calibre. Untuk memuat turun blog ini menjadi e-buku, kami bergantung pada suapan :term:`RSS` blog::

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.
ms: Saya perolehi URL RSS dengan meneliti "Subscribe to" di bahagian bawah laman blog dan pilih :guilabel:`Posts->Atom`. Supaya calibre dapat memuat turun suapan dan menukarkanya menjadi e-buku, anda boleh klik-kanan butang :guilabel:`Dapatkan berita` kemudian item menu :guilabel:`Tambah sumber berita suai` dan kemudian butang :guilabel:`Resepi Baharu`. Satu dialog serupa dengan yang telah ditunjukkan akan dibuka.

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.
ms: Dua medan berikutnya (:guilabel:`Oldest article` dan :guilabel:`Max. number of articles`) membolehkan anda kawal berapa banyak artikel yang patut dimuat turun dari setiap suapan.

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.
ms: Untuk menambah suapan ke dalam resepi, masukkan tajuk suapan dan URL suapan kemudian klik butang :guilabel:`Tambah suapan`. Selepas itu, hanya klik butang :guilabel:`Simpan` dan kerja anda telah selesai! Tutup dialog.

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!
ms: Untuk menguji :term:`resepi` baharu anda, klik butang :guilabel:`Dapatkan berita` dan pada sub-menu :guilabel:`Suai sumber baharu` klik :guilabel:`calibre Blog`. Selepas beberapa minit, e-buku baharu dimuat turun akan muncul dalam paparan pustaka utama (jika anda memiliki pembaca yang telah bersambung, ia akan dimasukkan ke dalam pembaca selain dari ke dalam pustaka). Pilih e-buku tersebut dan tekan butang :guilabel:`Lihat' untuk membaca!

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.
ms: Sebab apa proses ini menghasilkan e-buku yang baik, kerana blog ini menyediakan suapan  :term:`RSS` dengan *kandungan-lengkap* iaitu, kandungan artikel sebenar terbenam dalam suapan itu sendiri. Bagi kebanyakan sumber berita yang menyediakan berita dengan suapan dengan *kandungan-lengkap*, anda tidak perlu buat lebih kerja untuk menukar ia menjadi e-buku. Sekarang kita lihat sumber berita yang tidak menyediakan suapan dengan kandungan-lengkap. Suapan sebegini, artikel lengkap berada dalam laman sesawang dan suapan hanya menyediakan pautan ke laman sesawang dengan ringkasan pendek artikel berkenaan.

en: News Front Page: https://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml
ms: Laman Muka Hadapan Berita: 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
ms: Sains/Alam: 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.
ms: Ikuti prosedur yang digariskan dalam :ref:`calibre_blog` seperti di atas untuk menghasilkan resepi untuk *The BBC* (menggunakan suapan tersebut). Berdasarkan pada e-buku yang dimuat turun, didapati calibre telah melakukan kerja yang bagus hanya mengekstrak kandungan yang dikehendaki bagi setiap artikel dalam laman sesawang. Walaubagaimanapun, proses pengekstrakan ini tidaklah seratus peratus sempurna. Kadangkala ia meninggalkan kandungan yang tidak dikehendaki seperti menu dan bantuan navigasi atau ia telah buang kandungan yang sepatutnya diambil seperti tajuk artikel. Untuk memastikan pengekstrakan kandungan menepati kehendak anda, kita perlu suaikan proses mendapatkan artikel, yang dijelaskan pada seksyen yang berikutnya.

en: Customizing the fetch process
ms: Penyuaian proses mendapatkan artikel

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.
ms: Bila anda mahukan proses muat turun yang sempurna, atau muat turun kandungan dari laman sesawang yang kompleks, anda perlu biasakan dengan bingkai kerja :term:`resepi` yang fleksibel. Untuk membuatnya, pada dialog :guilabel:`Tambah sumber berita suai`, hanya klik butang :guilabel:`Tukar ke mod Lanjutan`.

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*.
ms: Penyuaian termudah dan paling produktif ialah dengan menggunakan versi cetak artikel atas-talian. Versi cetak biasanya kurang kompleks dan mudah diterjemah menjadi e-buku. Cuba guna versi cetak daripada *The BBC*.

en: Using the print version of bbc.co.uk
ms: Menggunakan versi cetak 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:
ms: Langkah pertama adalah melihat e-buku yang telah dimuat turun sebelum ini daripada :ref:`bbc`. Dipenghujung setiap artikel, dalam e-buku terdapat lokasi artikel dimuat turun. Salin dan tampal URL tersebut ke dalam pelayar. Sekarang laman sesawang artikel akan menuju ke "Versi Boleh Cetak". Klik padanya untuk melihat versi cetak artikel. Ia kelihatan lebih kemas! Sekarang bandingkan kedua-dua URL yang mana:

en: Article URL
ms: URL Artikel

en: Print version URL
ms: URL versi cetak

en: So it looks like to get the print version, we need to prefix every article URL with:
ms: Jika mahukan versi cetak, kita perlu tambah setiap URL artikel dengan:

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:
ms: Anda dapati medan dari :guilabel:`Mod asas` telah diterjemah dalam kod bahasa Python. Kita perlu tambah arahan ke dalam resepi ini supaya dapat guna versi cetak artikel. Apa yang diperlukan adalah dengan menambah dua baris berikut:

en: This is Python, so indentation is important. After you've added the lines, it should look like:
ms: Ini adalah bahasa Python, oleh itu penggunaan indentasi adalah penting. Selepas anda menambah baris, ia sepatutnya kelihatan seperti berikut:

en: Replacing article styles
ms: Menggantikan gaya artikel

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::
ms: Dalam seksyen terdahulu, kita dapati saiz fon artikel dalam versi cetak *The BBC* terlalu kecil. Dalam kebanyakan laman sesawang, *The BBC* juga, saiz fon ini ditetapkan melalui lembaran gaya :term:`CSS`. Kita boleh lumpuhkan pengambilan lembaran gaya tersebut dengan menambah baris::

en: The recipe now looks like:
ms: Resepi kini kelihatan seperti:

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.
ms: Versi baharu kelihatan menarik. Jika anda mementingkan kesempurnaan, anda perlu baca seksyen berikutnya yang melibatkan pengubahsuaian sebenar kandungan muat turun.

en: Slicing and dicing
ms: Menghiris dan mencincang

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
ms: calibre memiliki keupayaan yang hebat dan fleksibel bila memanipulasikan kandungan muat turun. Sebagai contoh, kita rujuk kembali :ref:`The BBC <bbc1>` sekali lagi. Berdasarkan pada kod sumber (:term:`HTML`) beberapa artikel (versi cetak), didapati mereka mempunyai pengkaki yang tidak diperlukan, terkandung didalamnya

en: This can be removed by adding::
ms: Ia boleh dibuang dengan menambah::

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::
ms: ke dalam resepi. Akhir sekali, gantikan beberapa :term:`CSS` yang telah dilumpuhkan sebelum ini, dengan :term:`CSS` anda sendiri yang sesuai dengan penukaran sesebuah e-buku::

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.
ms: :term:`Resepi` ini hanya menjelajah sebahagian kecil sahaja bila dibandingkan kelebihan yang ada pada calibre. Untuk menjelajah lebih mendalam keupayaan calibre kita perlu menyelidiki contoh sebenar yang lebih kompleks pada seksyen berikutnya.

en: Real life example
ms: Contoh sebenar

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*
ms: Contoh sebenar yang benar-benar kompleks yang mendedahkan lebih :term:`API`  ``BasicNewsRecipe`` adalah :term:`resepi` untuk *The New York Times*

en: We see several new features in this :term:`recipe`. First, we have::
ms: Kami melihat beberapa fitur baharu dalam :term:`resepi` ini. Mula-mula, kita perlu::

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>`.
ms: Ini tetapkan masa paparan pada muka hadapan e-buku yang dihasilkan dalam format, ``Day, Day_Number Month, Year``. Sila rujuk :attr:`timefmt <calibre.web.feeds.news.BasicNewsRecipe.timefmt>`.

en: Then we see a group of directives to cleanup the downloaded :term:`HTML`::
ms: Kemudian kita lihat sekumpulan arahan untuk membersihkan :term:`HTML` dimuat turun::

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>`.
ms: Ia membuang segalanya sebelum ``<h1>`` tag pertama dan segalanya selepas tag pertama yang mana id ialah ``footer``. Sila rujuk :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::
ms: Fitur menarik berikutnya ialah::

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``.
ms: ``needs_subscription = True`` memberitahui calibre bahawa resepi ini perlukan nama pengguna dan kata laluan supaya ia dapat capai kandungan tersebut. Oleh itu, calibre meminta nama pengguna dan kata laluan bila anda cuba guna resepi ini. Kod di dalam :meth:`calibre.web.feeds.news.BasicNewsRecipe.get_browser` sebenarnya mendaftar masuk ke laman sesawang the NYT. Seusai mendaftar masuk, calibre akan menggunakannya semula untuk dapatkan semua kandungan. Sila rujuk  `mechanize <https://mechanize.readthedocs.io/en/latest/>`_ untuk memahami kod di dalam ``get_browser``.

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.
ms: Fitur baharu terakhir ialah kaedah :meth:`calibre.web.feeds.news.BasicNewsRecipe.preprocess_html`. Ia boleh digunakan untuk melakukan transformasi arbitari pada setiap halaman HTML dimuat turun. Di sini ia digunakan untuk melangkaui iklan yang mana nytimes paparkan sebelum setiap artikel.

en: Tips for developing new recipes
ms: Petua untuk membangunkan resepi baharu

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::
ms: Cara terbaik membangunkan resepi baharu adalah dengan penggunaan antaramuka baris perintah. Cipta resepi mengguna penyunting Python kegemaran anda dan simpan ia ke dalam fail seperti :file:`resepisaya.recipe`. Sambungan `.recipe` diperlukan. Kemudian anda boleh muat turun kandungan menggunakan resepi dengan perintah::

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::
ms: Selepas muat turun selesai, anda boleh lihat :term:`HTML` dimuat turun dengan membuka fail :file:`debug/input/index.html` di dalam pelayar. Jika anda puashati dengan muat turun dan pra-pemprosesan yang berlaku sepertimana yang diharapkan, anda boleh jana e-buku dalam format berlainan seperti di bawah::

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.
ms: Jika anda puashati dengan resepi anda, dan anda dapati masih terdapat ruang untuk ruang penambahbaikan dalam set resepi terbina-dalam, poskan resepi anda ke `forum resepi calibre recipes <https://www.mobileread.com/forums/forumdisplay.php?f=228>`_ untuk berkongsi ia dengan lain-lain pengguna calibre.

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/`.
ms: Pada MacOS, alat baris perintah disediakan dalam berkas calibre, contohnya, jika anda memasang calibre di dalam :file:`/Applications` alat baris perintah berada di dalam :file:`/Applications/calibre.app/Contents/MacOS/`.

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

en: The command line interface for all e-book conversion.
ms: Antaramuka baris perintah untuk semua pertukaran format e-buku.

en: Further reading
ms: Bacaan lanjutan

en: To learn more about writing advanced recipes using some of the facilities, available in ``BasicNewsRecipe`` you should consult the following sources:
ms: Untuk mengetahui lebih lanjut berkenaan penulisan resepi lanjutan dengan menggunakan beberapa fasiliti, yang tersedia dalam ``BasicNewsRecipe`` anda perlu ke beberapa sumber berikut:

en: :ref:`API documentation <news_recipe>`
ms: :ref:`Dokumentasi API<news_recipe>`

en: Documentation of the ``BasicNewsRecipe`` class and all its important methods and fields.
ms: Dokumentasi kelas ``BasicNewsRecipe`` dan semua kaedah dan medan pentingnya.

en: The source code of ``BasicNewsRecipe``
ms: Kod sumber ``BasicNewsRecipe``

en: `Built-in recipes <https://github.com/kovidgoyal/calibre/tree/master/recipes>`_
ms: `Resepi terbina-dalam <https://github.com/kovidgoyal/calibre/tree/master/recipes>`_

en: The source code for the built-in recipes that come with calibre
ms: Kod sumber untuk resepi terbina-dalam yang disertakan dengan calibre

en: `The calibre recipes forum <https://www.mobileread.com/forums/forumdisplay.php?f=228>`_
ms: `Forum resepi calibre <https://www.mobileread.com/forums/forumdisplay.php?f=228>`_

en: Lots of knowledgeable calibre recipe writers hang out here.
ms: Lebih banyak penulis resepi calibre yang berpengetahuan datang ke sini.

en: API documentation
ms: Dokumentasi API
