calibre - en to ar translation catalogue (67 entries)

en: Adding your favorite news website
ar: إضافة موقعك الإخباري المفضل

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.
ar: يحتوي calibre على إطار عمل قوي ومرن وسهل الاستخدام لتنزيل الأخبار من الإنترنت وتحويلها إلى كتاب إلكتروني. سيوضح لك ما يلي، بواسطة الأمثلة، كيفية الحصول على الأخبار من مواقع الويب المختلفة.

en: To gain an understanding of how to use the framework, follow the examples in the order listed below:
ar: لفهم كيفية استخدام الإطار، اتبع الأمثلة بالترتيب المذكور أدناه:

en: Completely automatic fetching
ar: جلب تلقائي بالكامل

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:
ar: إذا كان مصدر أخبارك بسيطًا بما فيه الكفاية، فقد يتمكن calibre من جلبه تلقائيًا بالكامل، كل ما عليك فعله هو توفير عنوان URL. يجمع calibre جميع المعلومات اللازمة لتنزيل مصدر أخبار في :term:`وصفة`. لإخبار calibre بمصدر أخبار، يجب عليك إنشاء :term:`وصفة` له. دعنا نرى بعض الأمثلة:

en: The calibre blog
ar: مدونة 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::
ar: مدونة 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.
ar: حصلت على عنوان URL لـ RSS بالبحث تحت "اشترك في" في أسفل صفحة المدونة واختيار :guilabel:`المنشورات->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.
ar: أولاً، أدخل ``مدونة calibre`` في حقل :guilabel:`عنوان الوصفة`. سيكون هذا هو عنوان الكتاب الإلكتروني الذي سيتم إنشاؤه من المقالات في الخلاصات المذكورة أعلاه.

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.
ar: الحقلان التاليان (: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.
ar: لإضافة الخلاصات إلى الوصفة، أدخل عنوان الخلاصة وعنوان 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!
ar: لاختبار :term:`وصفتك` الجديدة، انقر على زر :guilabel:`جلب الأخبار` وفي القائمة الفرعية :guilabel:`مصادر الأخبار المخصصة`، انقر على :guilabel:`مدونة calibre`. بعد بضع دقائق، سيظهر الكتاب الإلكتروني الذي تم تنزيله حديثًا من منشورات المدونة في عرض المكتبة الرئيسي (إذا كان جهاز القارئ الخاص بك متصلاً، فسيتم وضعه على القارئ بدلاً من المكتبة). حدده واضغط على زر :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.
ar: السبب في نجاح هذا الأمر بهذا الشكل الجيد، وبجهد قليل، هو أن المدونة توفر خلاصات :term:`RSS` *كاملة المحتوى*، أي أن محتوى المقال مضمن في الخلاصة نفسها. بالنسبة لمعظم مصادر الأخبار التي توفر الأخبار بهذه الطريقة، مع خلاصات *كاملة المحتوى*، لا تحتاج إلى مزيد من الجهد لتحويلها إلى كتب إلكترونية. الآن سننظر إلى مصدر أخبار لا يوفر خلاصات كاملة المحتوى. في مثل هذه الخلاصات، يكون المقال الكامل صفحة ويب وتحتوي الخلاصة فقط على رابط لصفحة الويب مع ملخص قصير للمقال.

en: Let's try the following two feeds from *The BBC*:
ar: دعنا نجرب خلاصتي الأخبار التاليتين من *بي بي سي*:

en: News Front Page: https://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml
ar: الصفحة الرئيسية للأخبار: 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
ar: العلوم/الطبيعة: 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.
ar: اتبع الإجراء الموضح في :ref:`calibre_blog` أعلاه لإنشاء وصفة لـ *بي بي سي* (باستخدام الخلاصات أعلاه). بالنظر إلى الكتاب الإلكتروني الذي تم تنزيله، نرى أن calibre قد قام بعمل جيد في استخراج المحتوى الذي تهتم به فقط من صفحة الويب لكل مقال. ومع ذلك، فإن عملية الاستخراج ليست مثالية. أحيانًا تترك محتوى غير مرغوب فيه مثل القوائم وأدوات التنقل أو تزيل محتوى كان يجب تركه، مثل عناوين المقالات. لكي يكون استخراج المحتوى مثاليًا، سنحتاج إلى تخصيص عملية الجلب، كما هو موضح في القسم التالي.

en: Customizing the fetch process
ar: تخصيص عملية الجلب

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.
ar: عندما ترغب في تحسين عملية التنزيل، أو تنزيل المحتوى من موقع ويب معقد بشكل خاص، يمكنك الاستفادة من كل قوة ومرونة إطار عمل :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*.
ar: التخصيص الأسهل والأكثر إنتاجية غالبًا هو استخدام النسخة المطبوعة من المقالات عبر الإنترنت. تحتوي النسخة المطبوعة عادةً على فوضى أقل بكثير وتتحول بسلاسة أكبر إلى كتاب إلكتروني. دعنا نحاول استخدام النسخة المطبوعة من المقالات من *بي بي سي*.

en: Using the print version of bbc.co.uk
ar: استخدام النسخة المطبوعة من 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:
ar: الخطوة الأولى هي النظر إلى الكتاب الإلكتروني الذي قمنا بتنزيله سابقًا من :ref:`bbc`. في نهاية كل مقال، في الكتاب الإلكتروني يوجد وصف قصير يخبرك من أين تم تنزيل المقال. انسخ والصق عنوان URL هذا في متصفح. الآن في صفحة الويب الخاصة بالمقال، ابحث عن رابط يشير إلى "النسخة القابلة للطباعة". انقر عليه لرؤية النسخة المطبوعة من المقال. تبدو أكثر أناقة بكثير! الآن قارن بين عنواني URL. بالنسبة لي كانا:

en: Article URL
ar: عنوان URL للمقال

en: Print version URL
ar: عنوان URL للنسخة المطبوعة

en: So it looks like to get the print version, we need to prefix every article URL with:
ar: لذلك يبدو أنه للحصول على النسخة المطبوعة، نحتاج إلى إضافة بادئة لكل عنوان 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):
ar: الآن في :guilabel:`الوضع المتقدم` لمربع حوار مصادر الأخبار المخصصة، يجب أن ترى شيئًا مثل (تذكر تحديد وصفة *بي بي سي* قبل التبديل إلى الوضع المتقدم):

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:
ar: يمكنك أن ترى أن الحقول من :guilabel:`الوضع الأساسي` قد تم ترجمتها إلى كود بايثون بطريقة مباشرة. نحتاج إلى إضافة تعليمات إلى هذه الوصفة لاستخدام النسخة المطبوعة من المقالات. كل ما هو مطلوب هو إضافة السطرين التاليين:

en: This is Python, so indentation is important. After you've added the lines, it should look like:
ar: هذه لغة بايثون، لذا المسافة البادئة مهمة. بعد إضافة الأسطر، يجب أن تبدو كالتالي:

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/>`_.
ar: فيما سبق، ``def print_version(self, url)`` يُعرّف *دالة* يتم استدعاؤها بواسطة calibre لكل مقال. ``url`` هو عنوان URL للمقال الأصلي. ما تفعله ``print_version`` هو أخذ عنوان URL هذا واستبداله بعنوان URL الجديد الذي يشير إلى النسخة المطبوعة من المقال. لمعرفة المزيد عن `بايثون <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.
ar: الآن، انقر على زر :guilabel:`إضافة/تحديث الوصفة` وسيتم حفظ تغييراتك. أعد تنزيل الكتاب الإلكتروني. يجب أن يكون لديك كتاب إلكتروني محسّن بشكل كبير. إحدى المشكلات في الإصدار الجديد هي أن الخطوط على صفحة الويب للنسخة المطبوعة صغيرة جدًا. يتم إصلاح هذا تلقائيًا عند التحويل إلى كتاب إلكتروني، ولكن حتى بعد عملية الإصلاح، يصبح حجم خط القوائم وشريط التنقل كبيرًا جدًا بالنسبة لنص المقال. لإصلاح ذلك، سنقوم ببعض التخصيصات الإضافية، في القسم التالي.

en: Replacing article styles
ar: استبدال أنماط المقالات

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::
ar: في القسم السابق، رأينا أن حجم الخط للمقالات من النسخة المطبوعة من *بي بي سي* كان صغيرًا جدًا. في معظم مواقع الويب، بما في ذلك *بي بي سي*، يتم تعيين حجم الخط هذا بواسطة أوراق أنماط :term:`CSS`. يمكننا تعطيل جلب هذه الأوراق الأنماط بإضافة السطر::

en: The recipe now looks like:
ar: تبدو الوصفة الآن كالتالي:

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.
ar: النسخة الجديدة تبدو جيدة جداً. إذا كنت من محبي الكمال، فسترغب في قراءة القسم التالي، الذي يتناول تعديل المحتوى الذي تم تنزيله فعلياً.

en: Slicing and dicing
ar: التقطيع والتقسيم

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
ar: يحتوي calibre على قدرات قوية ومرنة للغاية عندما يتعلق الأمر بمعالجة المحتوى الذي تم تنزيله. لإظهار بعض هذه القدرات، دعنا نلقي نظرة على وصفتنا القديمة :ref:`بي بي سي <bbc1>` مرة أخرى. بالنظر إلى الكود المصدري (:term:`HTML`) لبعض المقالات (النسخة المطبوعة)، نرى أن لديهم تذييلًا لا يحتوي على معلومات مفيدة، موجودة في

en: This can be removed by adding::
ar: يمكن إزالة هذا بإضافة::

en: With these additions, our recipe has become "production quality".
ar: مع هذه الإضافات، أصبحت وصفتنا "جودة إنتاج".

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.
ar: هذه :term:`الوصفة` تستكشف فقط قمة الجبل الجليدي عندما يتعلق الأمر بقوة calibre. لاستكشاف المزيد من قدرات calibre، سنفحص مثالًا واقعيًا أكثر تعقيدًا في القسم التالي.

en: Real life example
ar: مثال واقعي

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*
ar: مثال واقعي معقد بشكل معقول يكشف المزيد عن :term:`API` لـ ``BasicNewsRecipe`` هو :term:`وصفة` *صحيفة نيويورك تايمز*

en: We see several new features in this :term:`recipe`. First, we have::
ar: نرى العديد من الميزات الجديدة في هذه :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>`.
ar: يحدد هذا الوقت المعروض على الصفحة الأولى من الكتاب الإلكتروني الذي تم إنشاؤه ليكون بالتنسيق، ``اليوم، رقم_اليوم الشهر، السنة``. انظر :attr:`timefmt <calibre.web.feeds.news.BasicNewsRecipe.timefmt>`.

en: Then we see a group of directives to cleanup the downloaded :term:`HTML`::
ar: ثم نرى مجموعة من التوجيهات لتنظيف :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>`.
ar: تزيل هذه كل شيء قبل أول علامة ``<h1>`` وكل شيء بعد أول علامة معرفها ``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::
ar: الميزة المثيرة التالية هي::

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``.
ar: ``needs_subscription = True`` يخبر calibre أن هذه الوصفة تحتاج إلى اسم مستخدم وكلمة مرور للوصول إلى المحتوى. هذا يتسبب في أن يطلب calibre اسم مستخدم وكلمة مرور كلما حاولت استخدام هذه الوصفة. الكود في :meth:`calibre.web.feeds.news.BasicNewsRecipe.get_browser` يقوم بالفعل بتسجيل الدخول إلى موقع NYT. بمجرد تسجيل الدخول، سيستخدم calibre نفس مثيل المتصفح المسجل الدخول لجلب جميع المحتوى. راجع `mechanize <https://mechanize.readthedocs.io/en/latest/>`_ لفهم الكود في ``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.
ar: الميزة الجديدة الأخيرة هي طريقة :meth:`calibre.web.feeds.news.BasicNewsRecipe.preprocess_html`. يمكن استخدامها لإجراء تحويلات عشوائية على كل صفحة HTML تم تنزيلها. هنا يتم استخدامها لتجاوز الإعلانات التي تعرضها صحيفة نيويورك تايمز لك قبل كل مقال.

en: Tips for developing new recipes
ar: نصائح لتطوير وصفات جديدة

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::
ar: أفضل طريقة لتطوير وصفات جديدة هي استخدام واجهة سطر الأوامر. أنشئ الوصفة باستخدام محرر 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.
ar: سيقوم الأمر :command:`ebook-convert` بتنزيل جميع صفحات الويب وحفظها في ملف EPUB :file:`myrecipe.epub`. خيار ``-vv`` يجعل ebook-convert يعرض الكثير من المعلومات حول ما يفعله. خيار :option:`ebook-convert-recipe-input --test` يجعله ينزل فقط مقالتين من خلاصتين على الأكثر. بالإضافة إلى ذلك، سيضع 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::
ar: بمجرد اكتمال التنزيل، يمكنك الاطلاع على :term:`HTML` الذي تم تنزيله بفتح الملف :file:`debug/input/index.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.
ar: إذا كنت راضيًا عن وصفتك، وتشعر أن هناك طلبًا كافيًا لتبرير إدراجها في مجموعة الوصفات المضمنة، فانشر وصفتك في منتدى وصفات calibre `هنا <https://www.mobileread.com/forums/forumdisplay.php?f=228>`_ لمشاركتها مع مستخدمي 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/`.
ar: على نظام macOS، توجد أدوات سطر الأوامر داخل حزمة calibre، على سبيل المثال، إذا قمت بتثبيت calibre في :file:`/Applications` فإن أدوات سطر الأوامر موجودة في :file:`/Applications/calibre.app/Contents/MacOS/`.

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

en: The command line interface for all e-book conversion.
ar: واجهة سطر الأوامر لجميع تحويلات الكتب الإلكترونية.

en: Further reading
ar: قراءات إضافية

en: To learn more about writing advanced recipes using some of the facilities, available in ``BasicNewsRecipe`` you should consult the following sources:
ar: لمعرفة المزيد حول كتابة وصفات متقدمة باستخدام بعض المرافق، المتوفرة في ``BasicNewsRecipe`` يجب عليك استشارة المصادر التالية:

en: :ref:`API documentation <news_recipe>`
ar: :ref:`توثيق API <news_recipe>`

en: Documentation of the ``BasicNewsRecipe`` class and all its important methods and fields.
ar: توثيق فئة ``BasicNewsRecipe`` وجميع طرقها وحقولها الهامة.

en: `BasicNewsRecipe <https://github.com/kovidgoyal/calibre/blob/master/src/calibre/web/feeds/news.py>`_
ar: `وصفة الأخبار الأساسية <https://github.com/kovidgoyal/calibre/blob/master/src/calibre/web/feeds/news.py>`_

en: The source code of ``BasicNewsRecipe``
ar: الرمز المصدري لـ ``BasicNewsRecipe``

en: `Built-in recipes <https://github.com/kovidgoyal/calibre/tree/master/recipes>`_
ar: `وصفات مدمجة <https://github.com/kovidgoyal/calibre/tree/master/recipes>`_

en: The source code for the built-in recipes that come with calibre
ar: الرمز المصدري للوصفات المضمنة التي تأتي مع calibre

en: `The calibre recipes forum <https://www.mobileread.com/forums/forumdisplay.php?f=228>`_
ar: `منتدى وصفات calibre <https://www.mobileread.com/forums/forumdisplay.php?f=228>`_

en: Lots of knowledgeable calibre recipe writers hang out here.
ar: يتواجد هنا العديد من كتاب وصفات calibre ذوي المعرفة.

en: API documentation
ar: توثيق API
