calibre - en to ar translation catalogue (160 entries)

en: API documentation for the e-book editing tools
ar: توثيق واجهة برمجة التطبيقات لأدوات تحرير الكتب الإلكترونية

en: The e-book editing tools consist of a :class:`calibre.ebooks.oeb.polish.container.Container` object that represents a book as a collection of HTML + resource files, and various tools that can be used to perform operations on the container. All the tools are in the form of module level functions in the various ``calibre.ebooks.oeb.polish.*`` modules.
ar: تتكون أدوات تحرير الكتب الإلكترونية من كائن :class:`calibre.ebooks.oeb.polish.container.Container` الذي يمثل كتابًا كمجموعة من ملفات HTML + ملفات الموارد، وأدوات متنوعة يمكن استخدامها لإجراء عمليات على الحاوية. جميع الأدوات هي على شكل دوال على مستوى الوحدة في وحدات ``calibre.ebooks.oeb.polish.*`` المختلفة.

en: You obtain a container object for a book at a path like this::
ar: يمكنك الحصول على كائن حاوية لكتاب في مسار مثل هذا::

en: If you are writing a plugin for the E-book editor, you get the current container for the book being edited like this::
ar: إذا كنت تكتب إضافة لمحرر الكتب الإلكترونية، يمكنك الحصول على الحاوية الحالية للكتاب الذي يتم تحريره كالتالي::

en: The Container object
ar: كائن الحاوية

en: A container represents an open e-book as a folder full of files and an OPF file. There are two important concepts:
ar: تمثل الحاوية كتابًا إلكترونيًا مفتوحًا كمجلد مليء بالملفات وملف OPF. هناك مفهومان مهمان:

en: The root folder. This is the base of the e-book. All the e-books files are inside this folder or in its sub-folders.
ar: المجلد الجذر. هذا هو أساس الكتاب الإلكتروني. جميع ملفات الكتب الإلكترونية موجودة داخل هذا المجلد أو في مجلداته الفرعية.

en: Names: These are paths to the books' files relative to the root folder. They always contain POSIX separators and are unquoted. They can be thought of as canonical identifiers for files in the book. Most methods on the container object work with names. Names are always in the NFC Unicode normal form.
ar: الأسماء: هذه هي مسارات لملفات الكتب بالنسبة للمجلد الجذر. تحتوي دائمًا على فواصل POSIX وغير مقتبسة. يمكن اعتبارها معرفات قانونية للملفات في الكتاب. معظم الطرق على كائن الحاوية تعمل مع الأسماء. الأسماء دائمًا في شكل NFC Unicode العادي.

en: Clones: the container object supports efficient on-disk cloning, which is used to implement checkpoints in the e-book editor. In order to make this work, you should never access files on the filesystem directly. Instead, use :meth:`raw_data` or :meth:`open` to read/write to component files in the book.
ar: النسخ: يدعم كائن الحاوية النسخ الفعال على القرص، والذي يستخدم لتنفيذ نقاط التفتيش في محرر الكتب الإلكترونية. لكي يعمل هذا، يجب ألا تصل إلى الملفات على نظام الملفات مباشرةً. بدلاً من ذلك، استخدم :meth:`raw_data` أو :meth:`open` للقراءة/الكتابة إلى ملفات المكونات في الكتاب.

en: When converting between hrefs and names use the methods provided by this class, they assume all hrefs are quoted.
ar: عند التحويل بين hrefs والأسماء، استخدم الطرق التي توفرها هذه الفئة، فهي تفترض أن جميع hrefs مقتبسة.

en: Convert an absolute path to a canonical name relative to :attr:`root`
ar: تحويل مسار مطلق إلى اسم قانوني بالنسبة إلى :attr:`root`

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

en: The base folder. By default the root for this container object is used.
ar: المجلد الأساسي. افتراضيًا، يتم استخدام الجذر لكائن الحاوية هذا.

en: Add a file to this container. Entries for the file are automatically created in the OPF manifest and spine (if the file is a text document)
ar: أضف ملفًا إلى هذه الحاوية. يتم إنشاء إدخالات للملف تلقائيًا في بيان OPF والعمود الفقري (إذا كان الملف مستندًا نصيًا)

en: Add an entry to the manifest for a file with the specified name. Returns the manifest id.
ar: أضف إدخالاً إلى البيان لملف بالاسم المحدد. يُرجع معرف البيان.

en: Add the specified properties to the manifest item identified by name.
ar: أضف الخصائص المحددة إلى عنصر البيان المحدد بالاسم.

en: Ensure that the specified properties are set on only the manifest item identified by name. You can pass None as the name to remove the property from all items.
ar: تأكد من تعيين الخصائص المحددة على عنصر البيان المحدد بالاسم فقط. يمكنك تمرير None كاسم لإزالة الخاصية من جميع العناصر.

en: The type of book (epub for EPUB files and azw3 for AZW3 files)
ar: نوع الكتاب (epub لملفات EPUB و azw3 لملفات AZW3)

en: Commit all dirtied parsed objects to the filesystem and write out the e-book file at outpath.
ar: تثبيت جميع الكائنات المحللة المتسخة إلى نظام الملفات وكتابة ملف الكتاب الإلكتروني في outpath.

en: The path to write the saved e-book file to. If None, the path of the original book file is used.
ar: المسار لكتابة ملف الكتاب الإلكتروني المحفوظ إليه. إذا كان None، يتم استخدام مسار ملف الكتاب الأصلي.

en: If True the parsed representations of committed items are kept in the cache.
ar: إذا كان True، يتم الاحتفاظ بالتمثيلات المحللة للعناصر المثبتة في الذاكرة المؤقتة.

en: Commit a parsed object to disk (it is serialized and written to the underlying file). If ``keep_parsed`` is True the parsed representation is retained in the cache. See also: :meth:`parsed`
ar: تثبيت كائن محلل على القرص (يتم تسلسله وكتابته إلى الملف الأساسي). إذا كان ``keep_parsed`` صحيحًا، يتم الاحتفاظ بالتمثيل المحلل في الذاكرة المؤقتة. انظر أيضًا: :meth:`parsed`

en: Mark the parsed object corresponding to name as dirty. See also: :meth:`parsed`.
ar: وضع علامة على الكائن المحلل المقابل للاسم كـ 'متسخ'. انظر أيضاً: :meth:`parsed`.

en: True iff a file/folder corresponding to the canonical name exists. Note that this function suffers from the limitations of the underlying OS filesystem, in particular case (in)sensitivity. So on a case insensitive filesystem this will return True even if the case of name is different from the case of the underlying filesystem file. See also :meth:`has_name`
ar: صحيح إذا كان ملف/مجلد يتوافق مع الاسم القانوني موجودًا. لاحظ أن هذه الدالة تعاني من قيود نظام الملفات الأساسي لنظام التشغيل، خاصة حساسية (عدم حساسية) حالة الأحرف. لذا على نظام ملفات غير حساس لحالة الأحرف ستعيد هذه الدالة True حتى لو كانت حالة الاسم مختلفة عن حالة ملف نظام الملفات الأساسي. انظر أيضًا :meth:`has_name`

en: Return the size in bytes of the file represented by the specified canonical name. Automatically handles dirtied parsed objects. See also: :meth:`parsed`
ar: إرجاع حجم الملف بالبايت الذي يمثله الاسم القانوني المحدد. يتعامل تلقائيًا مع الكائنات المحللة المتسخة. انظر أيضًا: :meth:`parsed`

en: Add an item to the manifest with href derived from the given name. Ensures uniqueness of href and id automatically. Returns generated item.
ar: أضف عنصرًا إلى البيان مع href مشتق من الاسم المعطى. يضمن تفرد href و id تلقائيًا. يُرجع العنصر الذي تم إنشاؤه.

en: Similar to open() except that it returns a file path, instead of an open file object.
ar: مشابه لـ open() باستثناء أنه يعيد مسار ملف، بدلاً من كائن ملف مفتوح.

en: Mapping of guide type to canonical name
ar: تعيين نوع الدليل إلى الاسم القانوني

en: Return True iff a file with the same canonical name as that specified exists. Unlike :meth:`exists` this method is always case-sensitive.
ar: إرجاع صحيح إذا كان ملف بالاسم القانوني المحدد موجودًا. على عكس :meth:`exists`، هذه الطريقة حساسة لحالة الأحرف دائمًا.

en: Convert an href (relative to base) to a name. base must be a name or None, in which case self.root is used.
ar: تحويل href (بالنسبة إلى الأساس) إلى اسم. يجب أن يكون الأساس اسمًا أو None، وفي هذه الحالة يتم استخدام self.root.

en: Insert item into parent (or append if index is None), fixing indentation. Only works with self closing items.
ar: إدراج عنصر في الأصل (أو إلحاق إذا كان الفهرس None)، مع إصلاح المسافة البادئة. يعمل فقط مع العناصر ذاتية الإغلاق.

en: If this container represents an unzipped book (a directory)
ar: إذا كانت هذه الحاوية تمثل كتابًا غير مضغوط (دليل)

en: Iterate over all links in name. If get_line_numbers is True the yields results of the form (link, line_number, offset). Where line_number is the line_number at which the link occurs and offset is the number of characters from the start of the line. Note that offset could actually encompass several lines if not zero.
ar: تكرار جميع الروابط في الاسم. إذا كانت get_line_numbers صحيحة، فإنها تعطي نتائج على شكل (رابط، رقم_السطر، إزاحة). حيث رقم_السطر هو رقم السطر الذي يظهر فيه الرابط والإزاحة هي عدد الأحرف من بداية السطر. لاحظ أن الإزاحة يمكن أن تشمل بالفعل عدة أسطر إذا لم تكن صفرًا.

en: Ensure that `name` does not already exist in this book. If it does, return a modified version that does not exist.
ar: تأكد من أن `name` غير موجود بالفعل في هذا الكتاب. إذا كان موجودًا، فأرجع نسخة معدلة غير موجودة.

en: Return True if the manifest has an entry corresponding to name
ar: إرجاع True إذا كان البيان يحتوي على إدخال يتوافق مع الاسم

en: Mapping of manifest id to canonical names
ar: تعيين معرف البيان إلى الأسماء القانونية

en: The names of all manifest items whose media-type matches predicate. `predicate` can be a set, a list, a string or a function taking a single argument, which will be called with the media-type.
ar: أسماء جميع عناصر البيان التي يتطابق نوع الوسائط فيها مع المسند. يمكن أن يكون `المسند` مجموعة، قائمة، سلسلة، أو دالة تأخذ وسيطة واحدة، والتي سيتم استدعاؤها بنوع الوسائط.

en: All manifest items that have the specified property
ar: جميع عناصر البيان التي تحتوي على الخاصية المحددة

en: Mapping of manifest media-type to list of canonical names of that media-type
ar: تعيين نوع وسائط البيان إلى قائمة الأسماء القانونية لذلك النوع من الوسائط

en: The metadata of this book as a Metadata object. Note that this object is constructed on the fly every time this property is requested, so use it sparingly.
ar: البيانات الوصفية لهذا الكتاب ككائن Metadata. لاحظ أن هذا الكائن يتم إنشاؤه ديناميكيًا في كل مرة يتم طلب هذه الخاصية، لذا استخدمه باعتدال.

en: Convert a canonical name to an absolute OS dependent path
ar: تحويل اسم قانوني إلى مسار مطلق يعتمد على نظام التشغيل

en: Convert a name to a href relative to base, which must be a name or None in which case self.root is used as the base
ar: تحويل اسم إلى href بالنسبة إلى الأساس، والذي يجب أن يكون اسمًا أو None وفي هذه الحالة يتم استخدام self.root كأساس

en: Set of names that must never be renamed. Depends on the e-book file format.
ar: مجموعة من الأسماء التي يجب عدم إعادة تسميتها أبدًا. تعتمد على تنسيق ملف الكتاب الإلكتروني.

en: Set of names that must never be deleted from the container. Depends on the e-book file format.
ar: مجموعة من الأسماء التي يجب عدم حذفها أبدًا من الحاوية. تعتمد على تنسيق ملف الكتاب الإلكتروني.

en: Set of names that are allowed to be missing from the manifest. Depends on the e-book file format.
ar: مجموعة من الأسماء المسموح بغيابها من البيان. تعتمد على تنسيق ملف الكتاب الإلكتروني.

en: Open the file pointed to by name for direct read/write. Note that this will commit the file if it is dirtied and remove it from the parse cache. You must finish with this file before accessing the parsed version of it again, or bad things will happen.
ar: افتح الملف المشار إليه بالاسم للقراءة/الكتابة المباشرة. لاحظ أن هذا سيؤدي إلى تثبيت الملف إذا تم تعديله وإزالته من ذاكرة التخزين المؤقت للتحليل. يجب عليك الانتهاء من هذا الملف قبل الوصول إلى نسخته المحللة مرة أخرى، وإلا ستحدث أشياء سيئة.

en: The parsed OPF file
ar: ملف OPF المحلل

en: Convenience method to either return the first XML element with the specified name or create it under the opf:package element and then return it, if it does not already exist.
ar: طريقة ملائمة لإرجاع أول عنصر XML بالاسم المحدد أو إنشائه تحت عنصر opf:package ثم إرجاعه، إذا لم يكن موجودًا بالفعل.

en: The version set on the OPF's <package> element
ar: الإصدار المحدد على عنصر <package> في OPF

en: The version set on the OPF's <package> element as a tuple of integers
ar: الإصدار المحدد على عنصر <package> في OPF كزوج من الأعداد الصحيحة

en: Convenience method to evaluate an XPath expression on the OPF file, has the opf: and dc: namespace prefixes pre-defined.
ar: طريقة ملائمة لتقييم تعبير XPath على ملف OPF، تحتوي على بادئات مساحة الاسم opf: و dc: معرفة مسبقًا.

en: Return a parsed representation of the file specified by name. For HTML and XML files an lxml tree is returned. For CSS files a css_parser stylesheet is returned. Note that parsed objects are cached for performance. If you make any changes to the parsed object, you must call :meth:`dirty` so that the container knows to update the cache. See also :meth:`replace`.
ar: إرجاع تمثيل محلل للملف المحدد بالاسم. لملفات HTML و XML، يتم إرجاع شجرة lxml. لملفات CSS، يتم إرجاع ورقة أنماط css_parser. لاحظ أن الكائنات المحللة يتم تخزينها مؤقتًا للأداء. إذا قمت بإجراء أي تغييرات على الكائن المحلل، يجب عليك استدعاء :meth:`dirty` حتى تدرك الحاوية تحديث ذاكرة التخزين المؤقت. انظر أيضًا :meth:`replace`.

en: Return the raw data corresponding to the file specified by name
ar: إرجاع البيانات الخام المقابلة للملف المحدد بالاسم

en: If True and the file has a text based MIME type, decode it and return a unicode object instead of raw bytes.
ar: إذا كان True وكان للملف نوع MIME نصي، فقم بفك تشفيره وإرجاع كائن يونيكود بدلاً من البايتات الخام.

en: If True the returned unicode object is normalized to the NFC normal form as is required for the EPUB and AZW3 file formats.
ar: إذا كان True، يتم تطبيع كائن يونيكود المُعاد إلى شكل NFC العادي كما هو مطلوب لتنسيقات ملفات EPUB و AZW3.

en: Remove the specified items (by canonical name) from the spine. If ``remove_if_no_longer_in_spine`` is True, the items are also deleted from the book, not just from the spine.
ar: إزالة العناصر المحددة (بالاسم القانوني) من العمود الفقري. إذا كان ``remove_if_no_longer_in_spine`` صحيحًا، يتم حذف العناصر أيضًا من الكتاب، وليس فقط من العمود الفقري.

en: Removes item from parent, fixing indentation (works only with self closing items)
ar: يزيل العنصر من الأصل، مع إصلاح المسافة البادئة (يعمل فقط مع العناصر ذاتية الإغلاق)

en: Remove the item identified by name from this container. This removes all references to the item in the OPF manifest, guide and spine as well as from any internal caches.
ar: إزالة العنصر المحدد بالاسم من هذه الحاوية. يؤدي هذا إلى إزالة جميع المراجع إلى العنصر في بيان OPF، والدليل، والعمود الفقري، بالإضافة إلى أي ذاكرات تخزين مؤقت داخلية.

en: Renames a file from current_name to new_name. It automatically rebases all links inside the file if the folder the file is in changes. Note however, that links are not updated in the other files that could reference this file. This is for performance, such updates should be done once, in bulk.
ar: إعادة تسمية ملف من current_name إلى new_name. يقوم تلقائيًا بإعادة بناء جميع الروابط داخل الملف إذا تغير المجلد الذي يوجد فيه الملف. لاحظ مع ذلك، أن الروابط لا يتم تحديثها في الملفات الأخرى التي قد تشير إلى هذا الملف. هذا من أجل الأداء، يجب أن تتم هذه التحديثات مرة واحدة، بشكل مجمع.

en: Replace the parsed object corresponding to name with obj, which must be a similar object, i.e. an lxml tree for HTML/XML or a css_parser stylesheet for a CSS file.
ar: استبدل الكائن المحلل المقابل للاسم بـ obj، والذي يجب أن يكون كائنًا مشابهًا، أي شجرة lxml لملفات HTML/XML أو ورقة أنماط css_parser لملف CSS.

en: Replace all links in name using replace_func, which must be a callable that accepts a URL and returns the replaced URL. It must also have a 'replaced' attribute that is set to True if any actual replacement is done. Convenient ways of creating such callables are using the :class:`LinkReplacer` and :class:`LinkRebaser` classes.
ar: استبدال جميع الروابط في الاسم باستخدام replace_func، والتي يجب أن تكون قابلة للاستدعاء تقبل عنوان URL وتعيد عنوان URL المستبدل. يجب أن تحتوي أيضًا على سمة 'replaced' يتم تعيينها إلى True إذا تم أي استبدال فعلي. الطرق الملائمة لإنشاء مثل هذه الدوال القابلة للاستدعاء هي استخدام فئتي :class:`LinkReplacer` و :class:`LinkRebaser`.

en: Convert a parsed object (identified by canonical name) into a bytestring. See :meth:`parsed`.
ar: تحويل كائن محلل (محدد بالاسم القانوني) إلى سلسلة بايتية. انظر :meth:`parsed`.

en: Set the spine to be spine_items where spine_items is an iterable of the form (name, linear). Will raise an error if one of the names is not present in the manifest.
ar: عيّن العمود الفقري ليكون spine_items حيث spine_items هو قابل للتكرار على شكل (الاسم، خطي). سيثير خطأ إذا لم يكن أحد الأسماء موجودًا في البيان.

en: An iterator yielding the path for every item in the books' spine. See also: :attr:`spine_iter` and :attr:`spine_items`.
ar: مكرر يعطي المسار لكل عنصر في العمود الفقري للكتب. انظر أيضًا: :attr:`spine_iter` و :attr:`spine_items`.

en: An iterator that yields item, name is_linear for every item in the books' spine. item is the lxml element, name is the canonical file name and is_linear is True if the item is linear. See also: :attr:`spine_names` and :attr:`spine_items`.
ar: مكرر يعطي العنصر، الاسم is_linear لكل عنصر في العمود الفقري للكتب. العنصر هو عنصر lxml، الاسم هو اسم الملف القانوني وis_linear صحيح إذا كان العنصر خطيًا. انظر أيضًا: :attr:`spine_names` و:attr:`spine_items`.

en: An iterator yielding name and is_linear for every item in the books' spine. See also: :attr:`spine_iter` and :attr:`spine_items`.
ar: مكرر يعطي الاسم و is_linear لكل عنصر في العمود الفقري للكتب. انظر أيضًا: :attr:`spine_iter` و :attr:`spine_items`.

en: Managing component files in a container
ar: إدارة ملفات المكونات في حاوية

en: Replace links to files in the container. Will iterate over all files in the container and change the specified links in them.
ar: استبدال الروابط إلى الملفات في الحاوية. سيتكرر على جميع الملفات في الحاوية ويغير الروابط المحددة فيها.

en: A mapping of old canonical name to new canonical name. For example: :code:`{'images/old.png': 'images/new.png'}`
ar: تعيين اسم قانوني قديم إلى اسم قانوني جديد. على سبيل المثال: :code:`{'images/old.png': 'images/new.png'}`

en: A callable that takes two arguments ``(name, anchor)`` and returns a new anchor. This is useful if you need to change the anchors in HTML files. By default, it does nothing.
ar: دالة قابلة للاستدعاء تأخذ وسيطتين ``(name, anchor)`` وتعيد مرساة جديدة. هذا مفيد إذا كنت بحاجة إلى تغيير المراسي في ملفات HTML. افتراضيًا، لا تفعل شيئًا.

en: If False, links are not replaced in the OPF file.
ar: إذا كانت False، لا يتم استبدال الروابط في ملف OPF.

en: Rename files in the container, automatically updating all links to them.
ar: إعادة تسمية الملفات في الحاوية، مع تحديث جميع الروابط إليها تلقائيًا.

en: A mapping of old canonical name to new canonical name, for example: :code:`{'text/chapter1.html': 'chapter1.html'}`.
ar: تعيين اسم قانوني قديم إلى اسم قانوني جديد، على سبيل المثال: :code:`{'text/chapter1.html': 'chapter1.html'}`.

en: Return the folders that are recommended for the given filenames. The recommendation is based on where the majority of files of the same type are located in the container. If no files of a particular type are present, the recommended folder is assumed to be the folder containing the OPF file.
ar: إرجاع المجلدات الموصى بها لأسماء الملفات المعطاة. تستند التوصية إلى مكان وجود غالبية الملفات من نفس النوع في الحاوية. إذا لم تكن هناك ملفات من نوع معين، فإن المجلد الموصى به هو المجلد الذي يحتوي على ملف OPF.

en: Pretty printing and auto fixing parse errors
ar: الطباعة الجميلة والتصحيح التلقائي لأخطاء التحليل

en: Fix any parsing errors in the HTML represented as a string in raw. Fixing is done using the HTML5 parsing algorithm.
ar: إصلاح أي أخطاء تحليل في HTML الممثل كسلسلة في raw. يتم الإصلاح باستخدام خوارزمية تحليل HTML5.

en: Fix any parsing errors in all HTML files in the container. Fixing is done using the HTML5 parsing algorithm.
ar: إصلاح أي أخطاء تحليل في جميع ملفات HTML في الحاوية. يتم الإصلاح باستخدام خوارزمية تحليل HTML5.

en: Pretty print the HTML represented as a string in raw
ar: طباعة HTML الممثل كسلسلة في raw بشكل جميل

en: Pretty print the CSS represented as a string in raw
ar: طباعة CSS الممثل كسلسلة في raw بشكل جميل

en: Pretty print the XML represented as a string in raw. If ``name`` is the name of the OPF, extra OPF-specific prettying is performed.
ar: طباعة XML الممثل كسلسلة في raw بشكل جميل. إذا كان ``name`` هو اسم OPF، يتم إجراء تنسيق إضافي خاص بـ OPF.

en: Pretty print all HTML/CSS/XML files in the container
ar: طباعة جميع ملفات HTML/CSS/XML في الحاوية بشكل جميل

en: Managing book jackets
ar: إدارة أغلفة الكتب

en: Remove an existing jacket, if any. Returns False if no existing jacket was found.
ar: إزالة غلاف موجود، إن وجد. يُرجع False إذا لم يتم العثور على غلاف موجود.

en: Either create a new jacket from the book's metadata or replace an existing jacket. Returns True if an existing jacket was replaced.
ar: إما إنشاء غلاف جديد من البيانات الوصفية للكتاب أو استبدال غلاف موجود. يُرجع True إذا تم استبدال غلاف موجود.

en: Splitting and merging of files
ar: تقسيم ودمج الملفات

en: Split the file specified by name at the position specified by loc_or_xpath. Splitting automatically migrates all links and references to the affected files.
ar: تقسيم الملف المحدد بالاسم عند الموضع المحدد بواسطة loc_or_xpath. يؤدي التقسيم تلقائيًا إلى ترحيل جميع الروابط والمراجع إلى الملفات المتأثرة.

en: Should be an XPath expression such as //h:div[@id="split_here"]. Can also be a *loc* which is used internally to implement splitting in the preview panel.
ar: يجب أن يكون تعبير XPath مثل //h:div[@id="split_here"]. يمكن أن يكون أيضًا *loc* الذي يستخدم داخليًا لتنفيذ التقسيم في لوحة المعاينة.

en: If True the split occurs before the identified element otherwise after it.
ar: إذا كان True، يحدث التقسيم قبل العنصر المحدد وإلا بعده.

en: Used internally
ar: يستخدم داخلياً

en: Split the specified file at multiple locations (all tags that match the specified XPath expression). See also: :func:`split`. Splitting automatically migrates all links and references to the affected files.
ar: تقسيم الملف المحدد في مواقع متعددة (جميع العلامات التي تتطابق مع تعبير XPath المحدد). انظر أيضًا: :func:`split`. يؤدي التقسيم تلقائيًا إلى ترحيل جميع الروابط والمراجع إلى الملفات المتأثرة.

en: If True the splits occur before the identified element otherwise after it.
ar: إذا كان True، تحدث التقسيمات قبل العنصر المحدد وإلا بعده.

en: Merge the specified files into a single file, automatically migrating all links and references to the affected files. The file must all either be HTML or CSS files.
ar: دمج الملفات المحددة في ملف واحد، مع ترحيل جميع الروابط والمراجع تلقائيًا إلى الملفات المتأثرة. يجب أن تكون جميع الملفات إما HTML أو ملفات CSS.

en: Must be either ``'text'`` for HTML files or ``'styles'`` for CSS files
ar: يجب أن يكون إما ``'text'`` لملفات HTML أو ``'styles'`` لملفات CSS

en: The list of files to be merged
ar: قائمة الملفات المراد دمجها

en: Which of the merged files is the *master* file, that is, the file that will remain after merging.
ar: أي من الملفات المدمجة هو الملف *الرئيسي*، أي الملف الذي سيبقى بعد الدمج.

en: Managing covers
ar: إدارة الأغلفة

en: Set the cover of the book to the image pointed to by cover_path.
ar: عيّن غلاف الكتاب ليكون الصورة التي يشير إليها cover_path.

en: Either the absolute path to an image file or the canonical name of an image in the book. When using an image in the book, you must also set options, see below.
ar: إما المسار المطلق لملف صورة أو الاسم القانوني لصورة في الكتاب. عند استخدام صورة في الكتاب، يجب عليك أيضًا تعيين الخيارات، انظر أدناه.

en: An optional callable that takes a single argument. It will be called with information about the tasks being processed.
ar: دالة اختيارية قابلة للاستدعاء تأخذ وسيطة واحدة. سيتم استدعاؤها مع معلومات حول المهام التي تتم معالجتها.

en: None or a dictionary that controls how the cover is set. The dictionary can have entries: **keep_aspect**: True or False  (Preserve aspect ratio of covers in EPUB) **no_svg**: True or False  (Use an SVG cover wrapper in the EPUB titlepage) **existing**: True or False  (``cover_path`` refers to an existing image in the book)
ar: None أو قاموس يتحكم في كيفية تعيين الغلاف. يمكن أن يحتوي القاموس على إدخالات: **keep_aspect**: True أو False (الحفاظ على نسبة العرض إلى الارتفاع للأغلفة في EPUB) **no_svg**: True أو False (استخدام غلاف SVG في صفحة عنوان EPUB) **existing**: True أو False (يشير ``cover_path`` إلى صورة موجودة في الكتاب)

en: Mark the specified image as the cover image.
ar: وضع علامة على الصورة المحددة كصورة الغلاف.

en: Mark the specified HTML file as the titlepage of the EPUB.
ar: وضع علامة على ملف HTML المحدد كصفحة عنوان EPUB.

en: If True the HTML file is moved to the start of the spine
ar: إذا كانت True، يتم نقل ملف HTML إلى بداية العمود الفقري

en: Working with CSS
ar: العمل مع CSS

en: Change a font family from old_name to new_name. Changes all occurrences of the font family in stylesheets, style tags and style attributes. If the old_name refers to an embedded font, it is removed. You can set new_name to None to remove the font family instead of changing it.
ar: تغيير عائلة خط من old_name إلى new_name. يغير جميع تكرارات عائلة الخط في أوراق الأنماط وعلامات الأنماط وسمات الأنماط. إذا كان old_name يشير إلى خط مضمن، فسيتم إزالته. يمكنك تعيين new_name إلى None لإزالة عائلة الخط بدلاً من تغييرها.

en: Remove all unused CSS rules from the book. An unused CSS rule is one that does not match any actual content.
ar: إزالة جميع قواعد CSS غير المستخدمة من الكتاب. قاعدة CSS غير مستخدمة هي تلك التي لا تتطابق مع أي محتوى فعلي.

en: An optional callable that takes a single argument. It is called with information about the operations being performed.
ar: دالة اختيارية قابلة للاستدعاء تأخذ وسيطة واحدة. يتم استدعاؤها مع معلومات حول العمليات التي يتم تنفيذها.

en: If True, class attributes in the HTML that do not match any CSS rules are also removed.
ar: إذا كان True، فسيتم أيضًا إزالة سمات الفئة في HTML التي لا تتطابق مع أي قواعد CSS.

en: If True, rules with identical selectors are merged.
ar: إذا كانت True، يتم دمج القواعد ذات المحددات المتطابقة.

en: If True, rules with identical properties are merged.
ar: إذا كانت True، يتم دمج القواعد ذات الخصائص المتطابقة.

en: If True, stylesheets that are not referenced by any content are removed
ar: إذا كانت True، يتم إزالة أوراق الأنماط التي لا يشير إليها أي محتوى

en: Remove the specified CSS properties from all CSS rules in the book.
ar: إزالة خصائص CSS المحددة من جميع قواعد CSS في الكتاب.

en: Set of properties to remove. For example: :code:`{'font-family', 'color'}`.
ar: مجموعة من الخصائص لإزالتها. على سبيل المثال: :code:`{'font-family', 'color'}`.

en: The files from which to remove the properties. Defaults to all HTML and CSS files in the book.
ar: الملفات التي سيتم إزالة الخصائص منها. الافتراضي هو جميع ملفات HTML و CSS في الكتاب.

en: Working with the Table of Contents
ar: العمل مع جدول المحتويات

en: Generate a Table of Contents from a list of XPath expressions. Each expression in the list corresponds to a level of the generate ToC. For example: :code:`['//h:h1', '//h:h2', '//h:h3']` will generate a three level Table of Contents from the ``<h1>``, ``<h2>`` and ``<h3>`` tags.
ar: إنشاء جدول محتويات من قائمة تعبيرات XPath. كل تعبير في القائمة يتوافق مع مستوى من جدول المحتويات الذي تم إنشاؤه. على سبيل المثال: :code:`['//h:h1', '//h:h2', '//h:h3']` سينشئ جدول محتويات من ثلاثة مستويات من علامات ``<h1>`` و ``<h2>`` و ``<h3>``.

en: Generate a Table of Contents from links in the book.
ar: إنشاء جدول محتويات من الروابط في الكتاب.

en: Generate a Table of Contents from files in the book.
ar: إنشاء جدول محتويات من الملفات في الكتاب.

en: Create an inline (HTML) Table of Contents from an existing NCX Table of Contents.
ar: إنشاء جدول محتويات مضمن (HTML) من جدول محتويات NCX موجود.

en: The title for this table of contents.
ar: عنوان جدول المحتويات هذا.

en: Edit book tool
ar: أداة تحرير الكتب

en: The base class for individual tools in an Edit Book plugin. Useful members include:
ar: الفئة الأساسية للأدوات الفردية في إضافة تحرير الكتب. تتضمن الأعضاء المفيدة:

en: ``self.plugin``: A reference to the :class:`calibre.customize.Plugin` object to which this tool belongs.
ar: ``self.plugin``: مرجع إلى كائن :class:`calibre.customize.Plugin` الذي تنتمي إليه هذه الأداة.

en: Methods that must be overridden in sub classes:
ar: الطرق التي يجب تجاوزها في الفئات الفرعية:

en: Set this to a unique name it will be used as a key
ar: عيّن هذا إلى اسم فريد وسيتم استخدامه كمفتاح

en: If True the user can choose to place this tool in the plugins toolbar
ar: إذا كان True، يمكن للمستخدم اختيار وضع هذه الأداة في شريط أدوات الإضافات

en: If True the user can choose to place this tool in the plugins menu
ar: إذا كان True، يمكن للمستخدم اختيار وضع هذه الأداة في قائمة الإضافات

en: The popup mode for the menu (if any) of the toolbar button. Possible values are 'delayed', 'instant', 'button'
ar: وضع القائمة المنبثقة (إن وجدت) لزر شريط الأدوات. القيم المحتملة هي 'delayed' (متأخر)، 'instant' (فوري)، 'button' (زر)

en: The :class:`calibre.gui2.tweak_book.boss.Boss` object. Used to control the user interface.
ar: كائن :class:`calibre.gui2.tweak_book.boss.Boss`. يستخدم للتحكم في واجهة المستخدم.

en: The main window of the user interface
ar: النافذة الرئيسية لواجهة المستخدم

en: Return the current :class:`calibre.ebooks.oeb.polish.container.Container` object that represents the book being edited.
ar: إرجاع كائن :class:`calibre.ebooks.oeb.polish.container.Container` الحالي الذي يمثل الكتاب الذي يتم تحريره.

en: Register a keyboard shortcut that will trigger the specified ``qaction``. This keyboard shortcut will become automatically customizable by the user in the Keyboard shortcuts section of the editor preferences.
ar: تسجيل اختصار لوحة مفاتيح سيؤدي إلى تشغيل ``qaction`` المحدد. سيصبح اختصار لوحة المفاتيح هذا قابلاً للتخصيص تلقائيًا بواسطة المستخدم في قسم اختصارات لوحة المفاتيح في تفضيلات المحرر.

en: A QAction object, it will be triggered when the configured key combination is pressed by the user.
ar: كائن QAction، سيتم تشغيله عند الضغط على مجموعة المفاتيح المكونة من قبل المستخدم.

en: A unique name for this shortcut/action. It will be used internally, it must not be shared by any other actions in this plugin.
ar: اسم فريد لهذا الاختصار/الإجراء. سيتم استخدامه داخليًا، ويجب ألا يتم مشاركته مع أي إجراءات أخرى في هذه الإضافة.

en: A list of the default keyboard shortcuts. If not specified no default shortcuts will be set. If the shortcuts specified here conflict with either builtin shortcuts or shortcuts from user configuration/other plugins, they will be ignored. In that case, users will have to configure the shortcuts manually via Preferences. For example: ``default_keys=('Ctrl+J', 'F9')``.
ar: قائمة باختصارات لوحة المفاتيح الافتراضية. إذا لم يتم تحديدها، فلن يتم تعيين أي اختصارات افتراضية. إذا تعارضت الاختصارات المحددة هنا مع اختصارات مدمجة أو اختصارات من تكوين المستخدم/إضافات أخرى، فسيتم تجاهلها. في هذه الحالة، سيتعين على المستخدمين تكوين الاختصارات يدويًا عبر التفضيلات. على سبيل المثال: ``default_keys=('Ctrl+J', 'F9')``.

en: An optional short description of this action. If not specified the text from the QAction will be used.
ar: وصف اختياري قصير لهذا الإجراء. إذا لم يتم تحديده، فسيتم استخدام النص من QAction.

en: An optional longer description of this action, it will be used in the preferences entry for this shortcut.
ar: وصف اختياري أطول لهذا الإجراء، سيتم استخدامه في إدخال التفضيلات لهذا الاختصار.

en: Create a QAction that will be added to either the plugins toolbar or the plugins menu depending on ``for_toolbar``. For example::
ar: إنشاء QAction سيتم إضافته إما إلى شريط أدوات الإضافات أو قائمة الإضافات اعتمادًا على ``for_toolbar``. على سبيل المثال::

en: Method :meth:`register_shortcut`.
ar: طريقة :meth:`register_shortcut`.

en: Controlling the editor's user interface
ar: التحكم في واجهة المستخدم للمحرر

en: The e-book editor's user interface is controlled by a single global *Boss* object. This has many useful methods that can be used in plugin code to perform common tasks.
ar: يتم التحكم في واجهة مستخدم محرر الكتب الإلكترونية بواسطة كائن *Boss* عالمي واحد. يحتوي هذا الكائن على العديد من الطرق المفيدة التي يمكن استخدامها في كود الإضافة لأداء المهام الشائعة.

en: Create a restore checkpoint with the name specified as ``msg``
ar: إنشاء نقطة استعادة باسم محدد كـ ``msg``

en: Update all the components of the user interface to reflect the latest data in the current book container.
ar: تحديث جميع مكونات واجهة المستخدم لتعكس أحدث البيانات في حاوية الكتاب الحالية.

en: If True, the book will be marked as modified, so the user will be prompted to save it when quitting.
ar: إذا كان صحيحًا، فسيتم وضع علامة على الكتاب كـ 'معدّل'، لذلك سيُطلب من المستخدم حفظه عند الإغلاق.

en: Close the editor that is editing the file specified by ``name``
ar: إغلاق المحرر الذي يقوم بتحرير الملف المحدد بواسطة ``name``

en: Commit any changes that the user has made to files open in editors to the container. You should call this method before performing any actions on the current container
ar: تثبيت أي تغييرات أجراها المستخدم على الملفات المفتوحة في المحررات إلى الحاوية. يجب عليك استدعاء هذه الطريقة قبل تنفيذ أي إجراءات على الحاوية الحالية

en: Return the name of the file being edited currently or None if no file is being edited
ar: إرجاع اسم الملف الذي يتم تحريره حاليًا أو None إذا لم يتم تحرير أي ملف

en: Open the file specified by name in an editor
ar: افتح الملف المحدد بالاسم في محرر

en: The media type of the file, for example, ``'text/html'``. If not specified it is guessed from the file extension.
ar: نوع وسائط الملف، على سبيل المثال، ``'text/html'``. إذا لم يتم تحديده، يتم تخمينه من امتداد الملف.

en: A template to initialize the opened editor with
ar: قالب لتهيئة المحرر المفتوح به

en: Open the e-book at ``path`` for editing. Will show an error if the e-book is not in a supported format or the current book has unsaved changes.
ar: افتح الكتاب الإلكتروني في ``path`` للتحرير. سيعرض خطأ إذا لم يكن الكتاب الإلكتروني بتنسيق مدعوم أو إذا كان الكتاب الحالي يحتوي على تغييرات غير محفوظة.

en: The name of a file inside the newly opened book to start editing. Can also be a list of names.
ar: اسم ملف داخل الكتاب الذي تم فتحه حديثًا لبدء التحرير. يمكن أن يكون أيضًا قائمة أسماء.

en: Undo the previous creation of a restore checkpoint, useful if you create a checkpoint, then abort the operation with no changes
ar: التراجع عن إنشاء نقطة استعادة سابقة، مفيد إذا قمت بإنشاء نقطة استعادة، ثم ألغيت العملية دون أي تغييرات

en: Save the book. Saving is performed in the background
ar: حفظ الكتاب. يتم الحفظ في الخلفية

en: Mark the book as having been modified
ar: وضع علامة على الكتاب بأنه تم تعديله

en: Show the changes to the book from its last checkpointed state
ar: إظهار التغييرات على الكتاب من آخر حالة تم حفظها

en: If True the diff dialog will have a button to allow the user to revert all changes
ar: إذا كان True، فسيحتوي مربع حوار الفروقات على زر يسمح للمستخدم بالتراجع عن جميع التغييرات

en: A container object to compare the current container to. If None, the previously checkpointed container is used
ar: كائن حاوية لمقارنة الحاوية الحالية به. إذا كان None، يتم استخدام الحاوية التي تم حفظها مسبقًا

en: Show the editor that is editing the file specified by ``name``
ar: إظهار المحرر الذي يقوم بتحرير الملف المحدد بواسطة ``name``

en: Sync the position of the preview panel to the current cursor position in the current editor
ar: مزامنة موضع لوحة المعاينة مع موضع المؤشر الحالي في المحرر الحالي
