calibre - en to ar translation catalogue (171 entries)

en: API documentation for the database interface
ar: توثيق API لواجهة قاعدة البيانات

en: This API is thread safe (it uses a multiple reader, single writer locking scheme).  You can access this API like this::
ar: هذه الواجهة البرمجية (API) آمنة للخيوط (تستخدم مخطط قفل متعدد القراء، كاتب واحد). يمكنك الوصول إلى هذه الواجهة البرمجية بهذه الطريقة::

en: If you are in a calibre plugin that is part of the main calibre GUI, you get access to it like this instead::
ar: إذا كنت في إضافة calibre وهي جزء من واجهة المستخدم الرسومية الرئيسية لـ calibre، يمكنك الوصول إليها بهذه الطريقة بدلاً من ذلك::

en: An in-memory cache of the metadata.db file from a calibre library. This class also serves as a threadsafe API for accessing the database. The in-memory cache is maintained in normal form for maximum performance.
ar: ذاكرة تخزين مؤقتة في الذاكرة لملف metadata.db من مكتبة calibre. هذه الفئة تعمل أيضًا كواجهة برمجة تطبيقات آمنة للخيوط للوصول إلى قاعدة البيانات. يتم الحفاظ على ذاكرة التخزين المؤقتة في الذاكرة بالشكل الطبيعي لتحقيق أقصى أداء.

en: SQLITE is simply used as a way to read and write from metadata.db robustly. All table reading/sorting/searching/caching logic is re-implemented. This was necessary for maximum performance and flexibility.
ar: يُستخدم SQLITE ببساطة كوسيلة لقراءة وكتابة البيانات من metadata.db بشكل قوي. تمت إعادة تنفيذ جميع منطق قراءة/فرز/بحث/تخزين الجداول مؤقتًا. كان هذا ضروريًا لتحقيق أقصى أداء ومرونة.

en: When a new book record is created in the database, with the book id as the only argument
ar: عند إنشاء سجل كتاب جديد في قاعدة البيانات، مع معرف الكتاب كـ الوسيط الوحيد

en: When a book format is edited, with arguments: (book_id, fmt)
ar: عند تحرير تنسيق كتاب، مع الوسائط: (book_id, fmt)

en: When books are removed from the database with the list of book ids as the only argument
ar: عند إزالة الكتب من قاعدة البيانات مع قائمة معرفات الكتب كـ الوسيط الوحيد

en: When a format is added to a book, with arguments: (book_id, format)
ar: عند إضافة تنسيق إلى كتاب، مع الوسائط: (book_id, format)

en: When formats are removed from a book, with arguments: (mapping of book id to set of formats removed from the book)
ar: عند إزالة التنسيقات من كتاب، مع الوسائط: (تعيين معرف الكتاب إلى مجموعة التنسيقات التي تمت إزالتها من الكتاب).

en: When the indexing progress changes
ar: عندما يتغير تقدم الفهرسة

en: When items such as tags or authors are removed from some books. Arguments: (field_name, affected book ids, ids of removed items)
ar: عند إزالة عناصر مثل العلامات أو المؤلفين من بعض الكتب. الوسائط: (اسم_الحقل، معرفات_الكتب_المتأثرة، معرفات_العناصر_المزالة)

en: When items such as tags or authors are renamed in some or all books. Arguments: (field_name, affected book ids, map of old item id to new item id)
ar: عند إعادة تسمية عناصر مثل العلامات أو المؤلفين في بعض الكتب أو كلها. الوسائط: (اسم_الحقل، معرفات_الكتب_المتأثرة، خريطة_معرف_العنصر_القديم_إلى_معرف_العنصر_الجديد)

en: When the links associated with items(s) are changed, with arguments: (field_name, item_ids)
ar: عند تغيير الروابط المرتبطة بالعناصر، مع الوسائط: (اسم_الحقل، معرفات_العناصر)

en: When some metadata is changed for some books, with arguments: (name of changed field, set of affected book ids)
ar: عند تغيير بعض البيانات الوصفية لبعض الكتب، مع الوسائط: (اسم الحقل الذي تم تغييره، مجموعة معرفات الكتب المتأثرة)

en: When the notes associated with item(s) are changed, with arguments: (field_name, item_ids)
ar: عند تغيير الملاحظات المرتبطة بالعناصر، مع الوسائط: (اسم_الحقل، معرفات_العناصر)

en: Add the specified books to the library. Books should be an iterable of 2-tuples, each 2-tuple of the form :code:`(mi, format_map)` where mi is a Metadata object and format_map is a dictionary of the form :code:`{fmt: path_or_stream}`, for example: :code:`{'EPUB': '/path/to/file.epub'}`.
ar: أضف الكتب المحددة إلى المكتبة. يجب أن تكون الكتب قابلة للتكرار من أزواج (tuples) من عنصرين، كل زوج بالشكل :code:`(mi, format_map)` حيث mi هو كائن Metadata و format_map هو قاموس بالشكل :code:`{fmt: path_or_stream}`، على سبيل المثال: :code:`{'EPUB': '/path/to/file.epub'}`.

en: Returns a pair of lists: :code:`ids, duplicates`. ``ids`` contains the book ids for all newly created books in the database. ``duplicates`` contains the :code:`(mi, format_map)` for all books that already exist in the database as per the simple duplicate detection heuristic used by :meth:`has_book`.
ar: يعيد زوجًا من القوائم: :code:`ids, duplicates`. يحتوي ``ids`` على معرفات الكتب لجميع الكتب التي تم إنشاؤها حديثًا في قاعدة البيانات. يحتوي ``duplicates`` على :code:`(mi, format_map)` لجميع الكتب الموجودة بالفعل في قاعدة البيانات وفقًا لأسلوب الكشف البسيط عن التكرارات المستخدم بواسطة :meth:`has_book`.

en: Add data for name where val_map is a map of book_ids to values. If delete_first is True, all previously stored data for name will be removed.
ar: أضف بيانات للاسم حيث val_map هي خريطة من book_ids إلى القيم. إذا كان delete_first صحيحًا، فسيتم إزالة جميع البيانات المخزنة مسبقًا للاسم.

en: Add extra data files
ar: إضافة ملفات بيانات إضافية

en: Add a format to the specified book. Return True if the format was added successfully.
ar: أضف تنسيقًا إلى الكتاب المحدد. أعد True إذا تمت إضافة التنسيق بنجاح.

en: Parameters
ar: المعلمات

en: If True replace existing format, otherwise if the format already exists, return False.
ar: إذا كان True، استبدل التنسيق الموجود، وإلا إذا كان التنسيق موجودًا بالفعل، أعد False.

en: If True, file type plugins are run on the format before and after being added.
ar: إذا كان True، يتم تشغيل إضافات نوع الملف على التنسيق قبل وبعد إضافته.

en: Internal use only.
ar: للاستخدام الداخلي فقط.

en: Register a callback function that will be called after certain actions are taken on this database. The function must take three arguments: (:class:`EventType`, library_id, event_type_specific_data)
ar: سجل دالة رد اتصال سيتم استدعاؤها بعد اتخاذ إجراءات معينة على قاعدة البيانات هذه. يجب أن تأخذ الدالة ثلاثة وسائط: (:class:`EventType`, library_id, event_type_specific_data)

en: Add the specified resource so it can be referenced by notes and return its content hash
ar: أضف المورد المحدد بحيث يمكن الإشارة إليه بواسطة الملاحظات وأعد تجزئة محتواه

en: Return a tuple of all annotation types in the database.
ar: إرجاع tuple بجميع أنواع التعليقات التوضيحية في قاعدة البيانات.

en: Return a tuple of all (user_type, user name) that have annotations.
ar: إرجاع tuple بجميع (user_type, user name) التي تحتوي على تعليقات توضيحية.

en: Return a tuple of all annotations matching the specified criteria. `ignore_removed` controls whether removed (deleted) annotations are also returned. Removed annotations are just a skeleton used for merging of annotations.
ar: إرجاع tuple بجميع التعليقات التوضيحية التي تطابق المعايير المحددة. يتحكم `ignore_removed` فيما إذا كانت التعليقات التوضيحية التي تمت إزالتها (المحذوفة) تُعاد أيضًا. التعليقات التوضيحية التي تمت إزالتها هي مجرد هيكل عظمي يستخدم لدمج التعليقات التوضيحية.

en: Return a tuple containing all annotations for the specified book_id as a dict with keys: `format`, `user_type`, `user`, `annotation`. Here, annotation is the annotation data.
ar: إرجاع tuple يحتوي على جميع التعليقات التوضيحية لـ book_id المحدد كـ قاموس بمفاتيح: `format`, `user_type`, `user`, `annotation`. هنا، annotation هي بيانات التعليق التوضيحي.

en: Frozen set of all known book ids.
ar: مجموعة مجمدة من جميع معرفات الكتب المعروفة.

en: Same as field_for, except that it operates on multiple books at once
ar: نفس field_for، باستثناء أنه يعمل على كتب متعددة في وقت واحد

en: Frozen set of ids for all values in the field ``name``.
ar: مجموعة مجمدة من المعرفات لجميع القيم في الحقل ``name``.

en: Frozen set of all fields names (should only be used for many-one and many-many fields)
ar: مجموعة مجمدة من جميع أسماء الحقول (يجب استخدامها فقط للحقول متعددة إلى واحد ومتعددة إلى متعدد).

en: Return the number of annotations for the specified book available in the database.
ar: إرجاع عدد التعليقات التوضيحية للكتاب المحدد المتاحة في قاعدة البيانات.

en: Return a map of annotation type -> annotation data for the specified book_id, format, user and user_type.
ar: إرجاع خريطة من نوع التعليق التوضيحي -> بيانات التعليق التوضيحي لـ book_id المحدد، التنسيق، المستخدم ونوع المستخدم.

en: Return author data as a dictionary with keys: name, sort, link
ar: إرجاع بيانات المؤلف كقاموس بمفاتيح: name, sort, link

en: If no authors with the specified ids are found an empty dictionary is returned. If author_ids is None, data for all authors is returned.
ar: إذا لم يتم العثور على مؤلفين بالمعرفات المحددة، يتم إرجاع قاموس فارغ. إذا كان author_ids هو None، يتم إرجاع بيانات جميع المؤلفين.

en: Given a list of authors, return the author_sort string for the authors, preferring the author sort associated with the author over the computed string.
ar: بالنظر إلى قائمة من المؤلفين، أعد سلسلة author_sort للمؤلفين، مع تفضيل ترتيب المؤلف المرتبط بالمؤلف على السلسلة المحسوبة.

en: Return all the books associated with the item identified by ``item_id``, where the item belongs to the field ``name``.
ar: إرجاع جميع الكتب المرتبطة بالعنصر المحدد بواسطة ``item_id``، حيث ينتمي العنصر إلى الحقل ``name``.

en: Returned value is a set of book ids, or the empty set if the item or the field does not exist.
ar: القيمة المعادة هي مجموعة من معرفات الكتب، أو المجموعة الفارغة إذا لم يكن العنصر أو الحقل موجودًا.

en: Return the set of books in the specified virtual library
ar: إرجاع مجموعة الكتب في المكتبة الافتراضية المحددة

en: Compress the cover images for the specified books. A compression quality of 100 will perform lossless compression, otherwise lossy compression.
ar: ضغط صور الغلاف للكتب المحددة. جودة ضغط 100 ستؤدي إلى ضغط بدون فقدان، وإلا ضغط مع فقدان.

en: The progress callback will be called with the book_id and the old and new sizes for each book that has been processed. If an error occurs, the new size will be a string with the error details.
ar: سيتم استدعاء دالة رد الاتصال بالتقدم مع book_id والأحجام القديمة والجديدة لكل كتاب تم معالجته. إذا حدث خطأ، سيكون الحجم الجديد سلسلة تحتوي على تفاصيل الخطأ.

en: Copy the cover to the file like object ``dest``. Returns False if no cover exists or dest is the same file as the current cover. dest can also be a path in which case the cover is copied to it if and only if the path is different from the current path (taking case sensitivity into account).
ar: انسخ الغلاف إلى الكائن الشبيه بالملف ``dest``. يعيد False إذا لم يكن هناك غلاف موجود أو إذا كان dest هو نفس ملف الغلاف الحالي. يمكن أن يكون dest أيضًا مسارًا، وفي هذه الحالة يتم نسخ الغلاف إليه إذا وفقط إذا كان المسار مختلفًا عن المسار الحالي (مع مراعاة حساسية حالة الأحرف).

en: Copy the format ``fmt`` to the file like object ``dest``. If the specified format does not exist, raises :class:`NoSuchFormat` error. dest can also be a path (to a file), in which case the format is copied to it, iff the path is different from the current path (taking case sensitivity into account).
ar: انسخ التنسيق ``fmt`` إلى الكائن الشبيه بالملف ``dest``. إذا لم يكن التنسيق المحدد موجودًا، يطرح خطأ :class:`NoSuchFormat`. يمكن أن يكون dest أيضًا مسارًا (إلى ملف)، وفي هذه الحالة يتم نسخ التنسيق إليه، إذا وفقط إذا كان المسار مختلفًا عن المسار الحالي (مع مراعاة حساسية حالة الأحرف).

en: Return the cover image or None. By default, returns the cover as a bytestring.
ar: إرجاع صورة الغلاف أو None. افتراضيًا، يعيد الغلاف كسلسلة بايتات.

en: WARNING: Using as_path will copy the cover to a temp file and return the path to the temp file. You should delete the temp file when you are done with it.
ar: تحذير: استخدام as_path سينسخ الغلاف إلى ملف مؤقت ويعيد المسار إلى الملف المؤقت. يجب عليك حذف الملف المؤقت عند الانتهاء منه.

en: If True return the image as an open file object (a SpooledTemporaryFile)
ar: إذا كان True، أعد الصورة ككائن ملف مفتوح (SpooledTemporaryFile)

en: If True return the image as a QImage object
ar: إذا كان True، أعد الصورة ككائن QImage

en: If True return the image as a QPixmap object
ar: إذا كان True، أعد الصورة ككائن QPixmap

en: If True return the image as a path pointing to a temporary file
ar: إذا كان True، أعد الصورة كمسار يشير إلى ملف مؤقت

en: Return data that can be used to implement :meth:`find_identical_books` in a worker process without access to the db. See db.utils for an implementation.
ar: إرجاع البيانات التي يمكن استخدامها لتنفيذ :meth:`find_identical_books` في عملية عاملة دون الوصول إلى قاعدة البيانات. راجع db.utils للحصول على تطبيق.

en: Return data suitable for use in :meth:`has_book`. This can be used for an implementation of :meth:`has_book` in a worker process without access to the db.
ar: إرجاع البيانات المناسبة للاستخدام في :meth:`has_book`. يمكن استخدام هذا لـ تطبيق :meth:`has_book` في عملية عاملة دون الوصول إلى قاعدة البيانات.

en: Delete annotations with the specified ids.
ar: حذف التعليقات التوضيحية بالمعرفات المحددة.

en: Delete data for name. By default deletes all data, if you only want to delete data for some book ids, pass in a list of book ids.
ar: حذف البيانات للاسم. افتراضيًا يحذف جميع البيانات، إذا كنت تريد فقط حذف البيانات لبعض معرفات الكتب، فمرر قائمة بمعرفات الكتب.

en: Delete an entry from the trash. Here category is 'b' for books and 'f' for formats.
ar: حذف إدخال من سلة المهملات. هنا الفئة هي 'b' للكتب و 'f' لـ التنسيقات.

en: Update metadata in all formats of the specified book_ids to current metadata in the database.
ar: تحديث البيانات الوصفية في جميع تنسيقات book_ids المحددة إلى البيانات الوصفية الحالية في قاعدة البيانات.

en: Expire entries from the trash that are too old
ar: انتهاء صلاحية الإدخالات من سلة المهملات التي تجاوزت مدتها

en: Export the note as a single HTML document with embedded images as data: URLs
ar: تصدير الملاحظة كوثيقة HTML واحدة مع صور مضمنة كـ data: URLs

en: Same as field_for, except that it avoids the extra lookup to get the field object
ar: نفس field_for، باستثناء أنه يتجنب البحث الإضافي للحصول على كائن الحقل

en: Return the value of the field ``name`` for the book identified by ``book_id``. If no such book exists or it has no defined value for the field ``name`` or no such field exists, then ``default_value`` is returned.
ar: إرجاع قيمة الحقل ``name`` للكتاب المحدد بواسطة ``book_id``. إذا لم يكن هذا الكتاب موجودًا أو لم يكن له قيمة محددة للحقل ``name`` أو لم يكن هذا الحقل موجودًا، فسيتم إرجاع ``default_value``.

en: ``default_value`` is not used for title, title_sort, authors, author_sort and series_index. This is because these always have values in the db. ``default_value`` is used for all custom columns.
ar: لا تُستخدم ``default_value`` لعناوين title, title_sort, authors, author_sort و series_index. وذلك لأن هذه القيم دائمًا ما تكون موجودة في قاعدة البيانات. تُستخدم ``default_value`` لجميع الأعمدة المخصصة.

en: The returned value for is_multiple fields are always tuples, even when no values are found (in other words, default_value is ignored). The exception is identifiers for which the returned value is always a dictionary. The returned tuples are always in link order, that is, the order in which they were created.
ar: القيمة المعادة للحقول is_multiple هي دائمًا tuples، حتى عندما لا يتم العثور على قيم (بمعنى آخر، يتم تجاهل default_value). الاستثناء هو المعرفات التي تكون القيمة المعادة لها دائمًا قاموسًا. تكون الـ tuples المعادة دائمًا بترتيب الارتباط، أي الترتيب الذي تم إنشاؤها به.

en: Return the ids (as a tuple) for the values that the field ``name`` has on the book identified by ``book_id``. If there are no values, or no such book, or no such field, an empty tuple is returned.
ar: إرجاع المعرفات (كـ tuple) للقيم التي يحتوي عليها الحقل ``name`` على الكتاب المحدد بواسطة ``book_id``. إذا لم تكن هناك قيم، أو لم يكن هذا الكتاب موجودًا، أو لم يكن هذا الحقل موجودًا، فسيتم إرجاع tuple فارغ.

en: Return True iff the specified field supports notes. If field is None return frozenset of all fields that support notes.
ar: إرجاع True إذا وفقط إذا كان الحقل المحدد يدعم الملاحظات. إذا كان الحقل None، أعد مجموعة مجمدة من جميع الحقول التي تدعم الملاحظات.

en: Finds books that have a superset of the authors in mi and the same title (title is fuzzy matched). See also :meth:`data_for_find_identical_books`.
ar: يعثر على الكتب التي تحتوي على مجموعة فائقة من المؤلفين في mi ونفس العنوان (يتم مطابقة العنوان بشكل تقريبي). راجع أيضًا :meth:`data_for_find_identical_books`.

en: Return the e-book format as a bytestring or `None` if the format doesn't exist, or we don't have permission to write to the e-book file.
ar: إرجاع تنسيق الكتاب الإلكتروني كسلسلة بايتات أو `None` إذا لم يكن التنسيق موجودًا، أو إذا لم يكن لدينا إذن للكتابة إلى ملف الكتاب الإلكتروني.

en: If True the e-book format is returned as a file object. Note that the file object is a SpooledTemporaryFile, so if what you want to do is copy the format to another file, use :meth:`copy_format_to` instead for performance.
ar: إذا كان True، يتم إرجاع تنسيق الكتاب الإلكتروني ككائن ملف. لاحظ أن كائن الملف هو SpooledTemporaryFile، لذا إذا كنت ترغب في نسخ التنسيق إلى ملف آخر، استخدم :meth:`copy_format_to` بدلاً من ذلك للأداء.

en: Copies the format file to a temp file and returns the path to the temp file
ar: ينسخ ملف التنسيق إلى ملف مؤقت ويعيد المسار إلى الملف المؤقت

en: If True and returning a path the filename is the same as that used in the library. Note that using this means that repeated calls yield the same temp file (which is re-created each time)
ar: إذا كان True وإرجاع مسار، فإن اسم الملف هو نفسه المستخدم في المكتبة. لاحظ أن استخدام هذا يعني أن الاستدعاءات المتكررة تنتج نفس الملف المؤقت (الذي يتم إعادة إنشائه في كل مرة).

en: Return absolute path to the e-book file of format `format`. You should almost never use this, as it breaks the threadsafe promise of this API. Instead use, :meth:`copy_format_to`.
ar: إرجاع المسار المطلق لملف الكتاب الإلكتروني بتنسيق `format`. يجب عليك عدم استخدام هذا أبدًا تقريبًا، لأنه يكسر وعد الأمان للخيوط في واجهة برمجة التطبيقات هذه. بدلاً من ذلك، استخدم :meth:`copy_format_to`.

en: Currently used only in calibredb list, the viewer, edit book, compare_format to original format, open with, bulk metadata edit and the catalogs (via get_data_as_dict()).
ar: يستخدم حاليًا فقط في قائمة calibredb، العارض، تحرير الكتاب، مقارنة التنسيق بالتنسيق الأصلي، الفتح باستخدام، تحرير البيانات الوصفية بالجملة والكتالوجات (عبر get_data_as_dict()).

en: Apart from the viewer, open with and edit book, I don't believe any of the others do any file write I/O with the results of this call.
ar: بصرف النظر عن العارض، والفتح باستخدام، وتحرير الكتاب، لا أعتقد أن أيًا من الآخرين يقوم بأي إدخال/إخراج كتابة ملفات مع نتائج هذا الاستدعاء.

en: Return the hash of the specified format for the specified book. The kind of hash is backend dependent, but is usually SHA-256.
ar: إرجاع تجزئة التنسيق المحدد للكتاب المحدد. نوع التجزئة يعتمد على الواجهة الخلفية، ولكنه عادةً SHA-256.

en: Return the path, size and mtime for the specified format for the specified book. You should not use path unless you absolutely have to, since accessing it directly breaks the threadsafe guarantees of this API. Instead use the :meth:`copy_format_to` method.
ar: إرجاع المسار والحجم وتاريخ التعديل للتنسيق المحدد للكتاب المحدد. يجب ألا تستخدم المسار إلا إذا اضطررت لذلك، لأن الوصول إليه مباشرة يكسر ضمانات الأمان للخيوط في واجهة برمجة التطبيقات هذه. بدلاً من ذلك، استخدم الأسلوب :meth:`copy_format_to`.

en: If ``True`` cached values are used, otherwise a slow filesystem access is done. The cache values could be out of date if access was performed to the filesystem outside of this API.
ar: إذا كان ``True``، يتم استخدام القيم المخزنة مؤقتًا، وإلا يتم إجراء وصول بطيء إلى نظام الملفات. قد تكون قيم ذاكرة التخزين المؤقت قديمة إذا تم الوصول إلى نظام الملفات خارج واجهة برمجة التطبيقات هذه.

en: If ``True`` The max_size field of the database is updated for this book.
ar: إذا كان ``True``، يتم تحديث حقل max_size في قاعدة البيانات لهذا الكتاب.

en: Return tuple of all formats for the specified book. If verify_formats is True, verifies that the files exist on disk.
ar: إرجاع tuple بجميع التنسيقات للكتاب المحدد. إذا كان verify_formats هو True، يتحقق من وجود الملفات على القرص.

en: Return all item_ids for items that have notes in the specified field or all fields if field_name is None
ar: إرجاع جميع item_ids للعناصر التي تحتوي على ملاحظات في الحقل المحدد أو جميع الحقول إذا كان field_name هو None

en: Returns all links for all fields referenced by book identified by book_id. If book_id doesn't exist then the method returns {}.
ar: يعيد جميع الروابط لجميع الحقول المشار إليها بواسطة الكتاب المحدد بواسطة book_id. إذا لم يكن book_id موجودًا، فإن الأسلوب يعيد {}.

en: Example: Assume author A has link X, author B has link Y, tag S has link F, and tag T has link G. If book 1 has author A and tag T, this method returns {'authors':{'A':'X'}, 'tags':{'T', 'G'}}. If book 2's author is neither A nor B and has no tags, this method returns {}.
ar: مثال: افترض أن المؤلف أ لديه رابط X، والمؤلف ب لديه رابط Y، والعلامة S لديها رابط F، والعلامة T لديها رابط G. إذا كان الكتاب 1 لديه المؤلف أ والعلامة T، فإن هذا الأسلوب يعيد {'authors':{'A':'X'}, 'tags':{'T', 'G'}}. إذا لم يكن مؤلف الكتاب 2 لا أ ولا ب وليس لديه علامات، فإن هذا الأسلوب يعيد {}.

en: the book id in question.
ar: معرف الكتاب المعني.

en: Returns
ar: يعيد

en: {field: {field_value, link_value}, ...  for all fields with a field_value having a non-empty link value for that book
ar: {الحقل: {قيمة_الحقل، قيمة_الرابط}، ... لجميع الحقول التي تحتوي على قيمة_الحقل ذات قيمة رابط غير فارغة لذلك الكتاب

en: Used internally to implement the Tag Browser
ar: يستخدم داخليًا لتنفيذ متصفح العلامات

en: Get data for name. By default returns data for all book_ids, pass in a list of book ids if you only want some data. Returns a map of book_id to values. If a particular value could not be decoded, uses default for it.
ar: احصل على بيانات للاسم. افتراضيًا، يعيد البيانات لجميع book_ids، مرر قائمة بمعرفات الكتب إذا كنت تريد بعض البيانات فقط. يعيد خريطة من book_id إلى القيم. إذا تعذر فك ترميز قيمة معينة، فسيستخدم القيمة الافتراضية لها.

en: Return a mapping of id numbers to values for the specified field. The field must be a many-one or many-many field, otherwise a ValueError is raised.
ar: إرجاع تعيين من أرقام المعرفات إلى القيم للحقل المحدد. يجب أن يكون الحقل متعددًا إلى واحد أو متعددًا إلى متعدد، وإلا يتم طرح ValueError.

en: Return the set of book ids for which name has data.
ar: إرجاع مجموعة معرفات الكتب التي تحتوي على بيانات للاسم.

en: Return the item id for item_name or None if not found. This function is very slow if doing lookups for multiple names use either get_item_ids() or get_item_name_map(). Similarly, case sensitive lookups are faster than case insensitive ones.
ar: إرجاع معرف العنصر لـ item_name أو None إذا لم يتم العثور عليه. هذه الدالة بطيئة جدًا إذا كنت تقوم بعمليات بحث عن أسماء متعددة، استخدم إما get_item_ids() أو get_item_name_map(). وبالمثل، فإن عمليات البحث الحساسة لحالة الأحرف أسرع من تلك غير الحساسة لحالة الأحرف.

en: Return a dict mapping item_name to the item id or None
ar: إرجاع قاموس يربط item_name بمعرف العنصر أو None

en: Return the item name for the item specified by item_id in the specified field. See also :meth:`get_id_map`.
ar: إرجاع اسم العنصر للعنصر المحدد بواسطة item_id في الحقل المحدد. راجع أيضًا :meth:`get_id_map`.

en: Return mapping of item values to ids
ar: إرجاع تعيين قيم العناصر إلى معرفاتها

en: Return a dictionary of links for the supplied field.
ar: إرجاع قاموس بالروابط للحقل المقدم.

en: the lookup name of the field for which the link map is desired
ar: اسم البحث للحقل الذي يراد الحصول على خريطة الرابط له

en: {field_value:link_value, ...} for non-empty links
ar: {قيمة_الحقل:قيمة_الرابط، ...} للروابط غير الفارغة

en: Return metadata for the book identified by book_id as a :class:`calibre.ebooks.metadata.book.base.Metadata` object. Note that the list of formats is not verified. If get_cover is True, the cover is returned, either a path to temp file as mi.cover or if cover_as_data is True then as mi.cover_data.
ar: إرجاع البيانات الوصفية للكتاب المحدد بواسطة book_id كـ كائن :class:`calibre.ebooks.metadata.book.base.Metadata`. لاحظ أن قائمة التنسيقات غير متحقق منها. إذا كان get_cover هو True، يتم إرجاع الغلاف، إما مسار إلى ملف مؤقت كـ mi.cover أو إذا كان cover_as_data هو True فحينئذٍ كـ mi.cover_data.

en: Return the next series index for the specified series, taking into account the various preferences that control next series number generation.
ar: إرجاع فهرس السلسلة التالي للسلسلة المحددة، مع الأخذ في الاعتبار التفضيلات المختلفة التي تتحكم في إنشاء رقم السلسلة التالي.

en: The series-like field (defaults to the builtin series column)
ar: الحقل الشبيه بالسلسلة (الافتراضي هو عمود السلسلة المدمج)

en: If True, returns a mapping of book_id to current series_index value instead.
ar: إذا كان True، يعيد تعيينًا من book_id إلى قيمة series_index الحالية بدلاً من ذلك.

en: Return a dict containing the resource data and name or None if no resource with the specified hash is found
ar: إرجاع قاموس يحتوي على بيانات المورد واسمه أو None إذا لم يتم العثور على مورد بالتجزئة المحددة

en: Like :meth:`get_metadata` except that it returns a ProxyMetadata object that only reads values from the database on demand. This is much faster than get_metadata when only a small number of fields need to be accessed from the returned metadata object.
ar: مثل :meth:`get_metadata` باستثناء أنه يعيد كائن ProxyMetadata الذي يقرأ القيم من قاعدة البيانات عند الطلب فقط. هذا أسرع بكثير من get_metadata عندما تحتاج إلى الوصول إلى عدد قليل فقط من الحقول من كائن البيانات الوصفية المعادة.

en: Return a mapping of id to usage count for all values of the specified field, which must be a many-one or many-many field.
ar: إرجاع تعيين من المعرف إلى عدد الاستخدام لجميع قيم الحقل المحدد، والذي يجب أن يكون حقلاً متعددًا إلى واحد أو متعددًا إلى متعدد.

en: Return True iff the database contains an entry with the same title as the passed in Metadata object. The comparison is case-insensitive. See also :meth:`data_for_has_book`.
ar: إرجاع True إذا وفقط إذا كانت قاعدة البيانات تحتوي على إدخال بنفس العنوان مثل كائن Metadata الذي تم تمريره. المقارنة غير حساسة لحالة الأحرف. راجع أيضًا :meth:`data_for_has_book`.

en: Return True iff the format exists on disk
ar: إرجاع True إذا وفقط إذا كان التنسيق موجودًا على القرص

en: Return True iff the specified book_id exists in the db
ar: إرجاع True إذا وفقط إذا كان book_id المحدد موجودًا في قاعدة البيانات

en: Import a previously exported note or an arbitrary HTML file as the note for the specified item
ar: استيراد ملاحظة تم تصديرها مسبقًا أو ملف HTML عشوائي كملاحظة لـ العنصر المحدد

en: Initialize this cache with data from the backend.
ar: تهيئة ذاكرة التخزين المؤقت هذه ببيانات من الواجهة الخلفية.

en: Return a dict of field to items that have associated notes for that field for the specified book
ar: إرجاع قاموس من الحقول إلى العناصر التي تحتوي على ملاحظات مرتبطة بهذا الحقل للكتاب المحدد

en: Return the link, if any, for the specified item or None if no link is found
ar: إرجاع الرابط، إن وجد، للعنصر المحدد أو None إذا لم يتم العثور على رابط

en: Get information about extra files in the book's directory.
ar: الحصول على معلومات حول الملفات الإضافية في دليل الكتاب.

en: the database book id for the book
ar: معرف كتاب قاعدة البيانات للكتاب

en: the pattern of filenames to search for. Empty pattern matches all extra files. Patterns must use / as separator. Use the DATA_FILE_PATTERN constant to match files inside the data directory.
ar: نمط أسماء الملفات للبحث عنها. النمط الفارغ يطابق جميع الملفات الإضافية. يجب أن تستخدم الأنماط / كفاصل. استخدم الثابت DATA_FILE_PATTERN لمطابقة الملفات داخل دليل البيانات.

en: A tuple of all extra files matching the specified pattern. Each element of the tuple is ExtraFile(relpath, file_path, stat_result). Where relpath is the relative path of the file to the book directory using / as a separator. stat_result is the result of calling os.stat() on the file.
ar: زوج (tuple) من جميع الملفات الإضافية التي تطابق النمط المحدد. كل عنصر من الزوج هو ExtraFile(relpath, file_path, stat_result). حيث relpath هو المسار النسبي للملف إلى دليل الكتاب باستخدام / كفاصل. stat_result هو نتيجة استدعاء os.stat() على الملف.

en: Merge the specified annotations into the existing annotations for book_id, fm, user_type, and user.
ar: دمج التعليقات التوضيحية المحددة في التعليقات التوضيحية الموجودة لـ book_id، fm، user_type، والمستخدم.

en: Merge the extra files from src_ids into dest_id. Conflicting files are auto-renamed unless replace=True in which case they are replaced.
ar: دمج الملفات الإضافية من src_ids إلى dest_id. يتم إعادة تسمية الملفات المتعارضة تلقائيًا ما لم يكن replace=True، وفي هذه الحالة يتم استبدالها.

en: Undelete a book from the trash directory
ar: إلغاء حذف كتاب من دليل المهملات

en: Undelete a format from the trash directory
ar: إلغاء حذف تنسيق من دليل المهملات

en: Return a list of sorted book ids. If ids_to_sort is None, all book ids are returned.
ar: إرجاع قائمة بمعرفات الكتب المرتبة. إذا كان ids_to_sort هو None، يتم إرجاع جميع معرفات الكتب.

en: fields must be a list of 2-tuples of the form (field_name, ascending=True or False). The most significant field is the first 2-tuple.
ar: يجب أن تكون الحقول قائمة من أزواج (tuples) من عنصرين بالشكل (field_name, ascending=True أو False). الحقل الأكثر أهمية هو الزوج الأول.

en: Return all notes data as a dict or None if note does not exist
ar: إرجاع جميع بيانات الملاحظات كقاموس أو None إذا لم تكن الملاحظة موجودة

en: Return the notes document or an empty string if not found
ar: إرجاع مستند الملاحظات أو سلسلة فارغة إذا لم يتم العثور عليه

en: Return the set of resource hashes of all resources used by the note for the specified item
ar: إرجاع مجموعة تجزئات الموارد لجميع الموارد المستخدمة بواسطة الملاحظة لـ العنصر المحدد

en: Return the value for the specified preference or the value specified as ``default`` if the preference is not set.
ar: إرجاع القيمة للتفضيل المحدد أو القيمة المحددة كـ ``default`` إذا لم يتم تعيين التفضيل.

en: Return the OPF metadata backup for the book as a bytestring or None if no such backup exists.
ar: إرجاع نسخة احتياطية من بيانات OPF الوصفية للكتاب كسلسلة بايتات أو None إذا لم تكن هناك نسخة احتياطية من هذا القبيل.

en: Remove the books specified by the book_ids from the database and delete their format files. If ``permanent`` is False, then the format files are placed in the per-library trash directory.
ar: إزالة الكتب المحددة بواسطة book_ids من قاعدة البيانات وحذف ملفات تنسيقاتها. إذا كان ``permanent`` هو False، فسيتم وضع ملفات التنسيقات في دليل المهملات الخاص بالمكتبة.

en: Delete the specified extra files, either to Recycle Bin or permanently.
ar: حذف الملفات الإضافية المحددة، إما إلى سلة المحذوفات أو بشكل دائم.

en: Remove the specified formats from the specified books.
ar: إزالة التنسيقات المحددة من الكتب المحددة.

en: A mapping of book_id to a list of formats to be removed from the book.
ar: تعيين من book_id إلى قائمة من التنسيقات المراد إزالتها من الكتاب.

en: If True, only remove the record for the format from the db, do not delete the actual format file from the filesystem.
ar: إذا كان True، فقم فقط بإزالة السجل الخاص بالتنسيق من قاعدة البيانات، ولا تحذف ملف التنسيق الفعلي من نظام الملفات.

en: A map of book id to set of formats actually deleted from the filesystem for that book
ar: خريطة من معرف الكتاب إلى مجموعة التنسيقات التي تم حذفها فعليًا من نظام الملفات لـ هذا الكتاب

en: Delete all items in the specified field with the specified ids. Returns the set of affected book ids. ``restrict_to_book_ids`` is an optional set of books ids. If specified the items will only be removed from those books.
ar: حذف جميع العناصر في الحقل المحدد بالمعرفات المحددة. يعيد مجموعة معرفات الكتب المتأثرة. ``restrict_to_book_ids`` هي مجموعة اختيارية من معرفات الكتب. إذا تم تحديدها، فسيتم إزالة العناصر من تلك الكتب فقط.

en: Rename extra data files
ar: إعادة تسمية ملفات البيانات الإضافية

en: Rename items from a many-one or many-many field such as tags or series.
ar: إعادة تسمية العناصر من حقل متعدد إلى واحد أو متعدد إلى متعدد مثل العلامات أو السلاسل.

en: When renaming in a series-like field also change the series_index values.
ar: عند إعادة التسمية في حقل شبيه بالسلسلة، قم أيضًا بتغيير قيم series_index.

en: An optional set of book ids for which the rename is to be performed, defaults to all books.
ar: مجموعة اختيارية من معرفات الكتب التي سيتم إجراء إعادة التسمية لها، الافتراضي هو جميع الكتب.

en: Restore the book entry in the database for a book that already exists on the filesystem
ar: استعادة إدخال الكتاب في قاعدة البيانات لكتاب موجود بالفعل على نظام الملفات

en: Restore the specified format from the previously saved ORIGINAL_FORMAT, if any. Return True on success. The ORIGINAL_FORMAT is deleted after a successful restore.
ar: استعادة التنسيق المحدد من ORIGINAL_FORMAT المحفوظ سابقًا، إن وجد. أعد True عند النجاح. يتم حذف ORIGINAL_FORMAT بعد استعادة ناجحة.

en: A safe read lock is a lock that does nothing if the thread already has a write lock, otherwise it acquires a read lock. This is necessary to prevent DowngradeLockErrors, which can happen when updating the search cache in the presence of composite columns. Updating the search cache holds an exclusive lock, but searching a composite column involves reading field values via ProxyMetadata which tries to get a shared lock. There may be other scenarios that trigger this as well.
ar: قفل القراءة الآمن هو قفل لا يفعل شيئًا إذا كان الخيط يمتلك بالفعل قفل كتابة، وإلا فإنه يحصل على قفل قراءة. هذا ضروري لمنع أخطاء DowngradeLockErrors، والتي يمكن أن تحدث عند تحديث ذاكرة التخزين المؤقت للبحث في وجود أعمدة مركبة. يحمل تحديث ذاكرة التخزين المؤقت للبحث قفلًا حصريًا، ولكن البحث في عمود مركب يتضمن قراءة قيم الحقل عبر ProxyMetadata الذي يحاول الحصول على قفل مشترك. قد تكون هناك سيناريوهات أخرى تؤدي إلى ذلك أيضًا.

en: This property returns a new lock object on every access. This lock object is not recursive (for performance) and must only be used in a with statement as ``with cache.safe_read_lock:`` otherwise bad things will happen.
ar: تعيد هذه الخاصية كائن قفل جديد عند كل وصول. كائن القفل هذا غير متكرر (لتحسين الأداء) ويجب استخدامه فقط في عبارة with مثل ``with cache.safe_read_lock:`` وإلا ستحدث أشياء سيئة.

en: Save a copy of the specified format as ORIGINAL_FORMAT, overwriting any existing ORIGINAL_FORMAT.
ar: حفظ نسخة من التنسيق المحدد كـ ORIGINAL_FORMAT، مع الكتابة فوق أي ORIGINAL_FORMAT موجود.

en: Search the database for the specified query, returning a set of matched book ids.
ar: البحث في قاعدة البيانات عن الاستعلام المحدد، وإرجاع مجموعة من معرفات الكتب المطابقة.

en: A restriction that is ANDed to the specified query. Note that restrictions are cached, therefore the search for a AND b will be slower than a with restriction b.
ar: قيد يتم ربطه بالاستعلام المحدد بواسطة AND. لاحظ أن القيود يتم تخزينها مؤقتًا، وبالتالي فإن البحث عن a AND b سيكون أبطأ من a مع القيد b.

en: Used internally (virtual fields such as on_device to search over).
ar: يستخدم داخليًا (حقول افتراضية مثل on_device للبحث فيها).

en: If not None, a set of book ids for which books will be searched instead of searching all books.
ar: إذا لم يكن None، فمجموعة من معرفات الكتب التي سيتم البحث عنها بدلاً من البحث في جميع الكتب.

en: Return of a tuple of annotations matching the specified Full-text query.
ar: إرجاع tuple من التعليقات التوضيحية التي تطابق استعلام النص الكامل المحدد.

en: Search the text of notes using an FTS index. If the query is empty return all notes.
ar: البحث في نص الملاحظات باستخدام فهرس FTS. إذا كان الاستعلام فارغًا، أعد جميع الملاحظات.

en: Set all annotations for the specified book_id, fmt, user_type and user.
ar: عيّن جميع التعليقات التوضيحية لـ book_id المحدد، fmt، user_type، والمستخدم.

en: options must be a map of the form {book_id:conversion_options}
ar: يجب أن تكون الخيارات خريطة بالشكل {book_id:conversion_options}

en: Set the cover for this book. The data can be either a QImage, QPixmap, file object or bytestring. It can also be None, in which case any existing cover is removed.
ar: عيّن الغلاف لهذا الكتاب. يمكن أن تكون البيانات إما QImage، QPixmap، كائن ملف أو سلسلة بايتات. يمكن أن تكون أيضًا None، وفي هذه الحالة يتم إزالة أي غلاف موجود.

en: Set the values of the field specified by ``name``. Returns the set of all book ids that were affected by the change.
ar: عيّن قيم الحقل المحدد بواسطة ``name``. يعيد مجموعة جميع معرفات الكتب التي تأثرت بالتغيير.

en: Mapping of book_ids to values that should be applied.
ar: تعيين من book_ids إلى القيم التي يجب تطبيقها.

en: If True, the case of many-one or many-many fields will be changed. For example, if a  book has the tag ``tag1`` and you set the tag for another book to ``Tag1`` then the both books will have the tag ``Tag1`` if allow_case_change is True, otherwise they will both have the tag ``tag1``.
ar: إذا كان True، فسيتم تغيير حالة الحقول متعددة إلى واحد أو متعددة إلى متعدد. على سبيل المثال، إذا كان كتاب يحتوي على العلامة ``tag1`` وقمت بتعيين العلامة لكتاب آخر إلى ``Tag1``، فسيحتوي كلا الكتابين على العلامة ``Tag1`` إذا كان allow_case_change هو True، وإلا فسيحتوي كلاهما على العلامة ``tag1``.

en: Used internally, you should never change it.
ar: يستخدم داخليًا، لا يجب عليك تغييره أبدًا.

en: Sets links for item values in field. Note: this method doesn't change values not in the value_to_link_map
ar: يعيّن الروابط لقيم العناصر في الحقل. ملاحظة: هذا الأسلوب لا يغير القيم غير الموجودة في value_to_link_map

en: the lookup name
ar: اسم البحث

en: dict(field_value:link, ...). Note that these are values, not field ids.
ar: قاموس (قيمة_الحقل:رابط، ...). لاحظ أن هذه قيم، وليست معرفات حقول.

en: books changed by setting the link
ar: الكتب التي تغيرت بتعيين الرابط

en: Set metadata for the book `id` from the `Metadata` object `mi`
ar: عيّن البيانات الوصفية للكتاب `id` من كائن `Metadata` `mi`

en: Setting force_changes=True will force set_metadata to update fields even if mi contains empty values. In this case, 'None' is distinguished from 'empty'. If mi.XXX is None, the XXX is not replaced, otherwise it is. The tags, identifiers, and cover attributes are special cases. Tags and identifiers cannot be set to None so they will always be replaced if force_changes is true. You must ensure that mi contains the values you want the book to have. Covers are always changed if a new cover is provided, but are never deleted. Also note that force_changes has no effect on setting title or authors.
ar: تعيين force_changes=True سيجبر set_metadata على تحديث الحقول حتى لو احتوى mi على قيم فارغة. في هذه الحالة، يتم تمييز 'None' عن 'empty'. إذا كان mi.XXX هو None، فلن يتم استبدال XXX، وإلا فسيتم استبداله. علامات، معرفات، وسمات الغلاف هي حالات خاصة. لا يمكن تعيين العلامات والمعرفات إلى None، لذا سيتم استبدالها دائمًا إذا كان force_changes صحيحًا. يجب عليك التأكد من أن mi يحتوي على القيم التي تريد أن يحتوي عليها الكتاب. تتغير الأغلفة دائمًا إذا تم توفير غلاف جديد، ولكنها لا تُحذف أبدًا. لاحظ أيضًا أن force_changes ليس له تأثير على تعيين العنوان أو المؤلفين.

en: Set the notes document. If the searchable text is different from the document, specify it as searchable_text. If the document references resources their hashes must be present in resource_hashes. Set remove_unused_resources to True to cleanup unused resources, note that updating a note automatically cleans up resources pertaining to that note anyway.
ar: عيّن مستند الملاحظات. إذا كان النص القابل للبحث مختلفًا عن المستند، حدده كـ searchable_text. إذا كان المستند يشير إلى موارد، فيجب أن تكون تجزئاتها موجودة في resource_hashes. عيّن remove_unused_resources إلى True لتنظيف الموارد غير المستخدمة، لاحظ أن تحديث ملاحظة ينظف تلقائيًا الموارد المتعلقة بتلك الملاحظة على أي حال.

en: Set the specified preference to the specified value. See also :meth:`pref`.
ar: عيّن التفضيل المحدد إلى القيمة المحددة. راجع أيضًا :meth:`pref`.

en: If f is a composite column lookup key and the column is is_multiple then split v into unique non-empty values. The comparison is case sensitive. Order is not preserved. Return a list() for compatibility with proxy metadata field getters, for example tags.
ar: إذا كان f مفتاح بحث عمود مركب وكان العمود is_multiple، فقم بتقسيم v إلى قيم فريدة غير فارغة. المقارنة حساسة لحالة الأحرف. الترتيب لا يتم الحفاظ عليه. أعد قائمة () للتوافق مع وظائف الحصول على حقول البيانات الوصفية الوكيلة، على سبيل المثال العلامات.

en: Return the ids of all books having the tag ``tag`` that are older than the specified time. tag comparison is case insensitive.
ar: إرجاع معرفات جميع الكتب التي تحتوي على العلامة ``tag`` والتي هي أقدم من الوقت المحدد. مقارنة العلامة غير حساسة لحالة الأحرف.

en: A timedelta object or None. If None, then all ids with the tag are returned.
ar: كائن timedelta أو None. إذا كان None، فسيتم إرجاع جميع المعرفات التي تحتوي على العلامة.

en: If not None the list of matches will be restricted to books that have this tag
ar: إذا لم يكن None، فسيتم تقييد قائمة التطابقات على الكتب التي تحتوي على هذه العلامة

en: A list of authors. If not None the list of matches will be restricted to books that have these authors (case insensitive).
ar: قائمة من المؤلفين. إذا لم تكن None، فسيتم تقييد قائمة التطابقات على الكتب التي تحتوي على هؤلاء المؤلفين (غير حساسة لحالة الأحرف).

en: Unretire a previously retired note for the specified item. Notes are retired when an item is removed from the database
ar: إلغاء إيقاف ملاحظة سابقة تم إيقافها للعنصر المحدد. يتم إيقاف الملاحظات عند إزالة عنصر من قاعدة البيانات

en: Update annotations.
ar: تحديث التعليقات التوضيحية.

en: Return the user categories for the specified books. proxy_metadata_map is optional and is useful for a performance boost, in contexts where a ProxyMetadata object for the books already exists. It should be a mapping of book_ids to their corresponding ProxyMetadata objects.
ar: إرجاع فئات المستخدم للكتب المحددة. proxy_metadata_map اختياري ومفيد لتعزيز الأداء، في السياقات التي يوجد فيها كائن ProxyMetadata للكتب بالفعل. يجب أن يكون تعيينًا من book_ids إلى كائنات ProxyMetadata المقابلة لها.
