calibre - en to ar translation catalogue (35 entries)

en: Snippets
ar: قصاصات

en: The calibre E-book editor supports *snippets*. A snippet is a piece of text that is either re-used often or contains a lot of redundant text. The editor allows you to insert a snippet with only a few key strokes. For example, suppose you often find yourself inserting link tags when editing HTML files, then you can simply type ``<a`` in the editor and press |ct|. The editor will expand it to::
ar: يدعم محرر الكتب الإلكترونية في calibre *القصاصات*. القصاصة هي جزء من النص يتم إعادة استخدامه غالبًا أو يحتوي على الكثير من النص الزائد. يتيح لك المحرر إدراج قصاصة ببضع ضغطات مفاتيح فقط. على سبيل المثال، لنفترض أنك غالبًا ما تجد نفسك تقوم بإدراج علامات الروابط عند تحرير ملفات HTML، فيمكنك ببساطة كتابة ``<a`` في المحرر والضغط على |ct|. سيقوم المحرر بتوسيعها إلى::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link.
ar: ليس هذا فحسب، بل سيتم تحديد كلمة ``filename``، مع وضع المؤشر فوقها، بحيث يمكنك بسهولة كتابة اسم الملف الحقيقي، باستخدام ميزة الإكمال التلقائي الذكية للمحرر :ref:`editor_auto_complete`. وبمجرد الانتهاء من كتابة اسم الملف، اضغط على |ct| مرة أخرى وسيقفز المؤشر إلى الموضع بين علامتي ``<a>`` بحيث يمكنك بسهولة كتابة نص الرابط.

en: The snippets system in the editor is very sophisticated, there are a few built-in snippets and you can create your own to suit your editing style.
ar: نظام القصاصات في المحرر متطور للغاية، هناك بعض القصاصات المدمجة ويمكنك إنشاء قصاصات خاصة بك لتناسب أسلوب تحريرك.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
ar: يجب أن تساعد المناقشة التالية للقصاصات المدمجة في توضيح قوة نظام القصاصات.

en: You can also use snippets in the text entry fields in the :guilabel:`Search & replace` panel, however, placeholders (using |ct| to jump around) will not work.
ar: يمكنك أيضًا استخدام القصاصات في حقول إدخال النص في لوحة :guilabel:`البحث والاستبدال`، ومع ذلك، لن تعمل العناصر النائبة (باستخدام |ct| للقفز).

en: The built-in snippets
ar: القصاصات المدمجة

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
ar: يتم وصف القصاصات المدمجة أدناه. لاحظ أنه يمكنك تجاوزها عن طريق إنشاء قصاصات خاصة بك بنفس نص التشغيل.

en: Inserting filler text [Lorem]
ar: إدراج نص حشو [Lorem]

en: The first built-in snippet, and the simplest is used to insert filler text into a document. The filler text is taken from `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ a philosophical work by Cicero (translated to English). To use it simply type ``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of paragraphs of filler.
ar: تُستخدم القصاصة المدمجة الأولى والأبسط لإدراج نص حشو في مستند. يتم أخذ نص الحشو من `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ وهو عمل فلسفي لشيشرون (مترجم إلى الإنجليزية). لاستخدامه، ما عليك سوى كتابة ``Lorem`` في ملف HTML والضغط على |ct|. سيتم استبداله ببضعة فقرات من الحشو.

en: The definition of this snippet is very simple, the trigger text is defined as ``Lorem`` and the template is defined simply as the literal text to be inserted. You can easily customize it to use your favorite form of filler text.
ar: تعريف هذه القصاصة بسيط للغاية، يتم تعريف نص التشغيل كـ ``Lorem`` ويتم تعريف القالب ببساطة كنص حرفي يتم إدراجه. يمكنك تخصيصه بسهولة لاستخدام الشكل المفضل لديك من نص الحشو.

en: Inserting a self-closing HTML tag [<>]
ar: إدراج علامة HTML ذاتية الإغلاق [<>]

en: Now let's look at a simple example of the powerful concept of *placeholders*. Say you want to insert the self-closing tag ``<hr/>``. Just type ``<>``, and press |ct|, the editor will expand the snippet to::
ar: الآن دعنا نلقي نظرة على مثال بسيط لمفهوم *العناصر النائبة* القوي. لنفترض أنك تريد إدراج العلامة ذاتية الإغلاق ``<hr/>``. ما عليك سوى كتابة ``<>``، والضغط على |ct|، سيقوم المحرر بتوسيع القصاصة إلى::

en: Here, the ``|`` symbol represents the current cursor position. You can then type ``hr`` and press |ct| to move the cursor to after the end of the tag. This snippet is defined as::
ar: هنا، يمثل الرمز ``|`` موضع المؤشر الحالي. يمكنك بعد ذلك كتابة ``hr`` والضغط على |ct| لنقل المؤشر إلى ما بعد نهاية العلامة. يتم تعريف هذه القصاصة كالتالي::

en: Placeholders are simply the dollar ($) sign followed by a number. When the snippet is expanded by pressing |ct| the cursor is positioned at the first placeholder (the placeholder with the lowest number). When you press |ct| again the cursor jumps to the next placeholder (the placeholder with the next higher number).
ar: العناصر النائبة هي ببساطة علامة الدولار ($) متبوعة برقم. عندما يتم توسيع القصاصة بالضغط على |ct|، يتم وضع المؤشر عند العنصر النائب الأول (العنصر النائب ذو الرقم الأقل). عندما تضغط على |ct| مرة أخرى، يقفز المؤشر إلى العنصر النائب التالي (العنصر النائب ذو الرقم الأعلى التالي).

en: Inserting an HTML link tag [<a]
ar: إدراج علامة رابط HTML [<a]

en: HTML link tags all share a common structure. They have an ``href`` attribute and some text between the opening and closing tags. A snippet to make typing them more efficient will introduce us to some more features of placeholders. To use this snippet, simply type ``<a`` and press |ct|. The editor will expand this to::
ar: تتشارك علامات الروابط في HTML جميعها في بنية مشتركة. لديها سمة ``href`` وبعض النص بين علامتي الفتح والإغلاق. ستعرفنا قصاصة لجعل كتابتها أكثر كفاءة على بعض ميزات أخرى للعناصر النائبة. لاستخدام هذه القصاصة، ما عليك سوى كتابة ``<a`` والضغط على |ct|. سيقوم المحرر بتوسيع هذا إلى::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link. After you are done typing the text, press |ct| again to jump to the point after the closing tag.  This snippet is defined as::
ar: ليس هذا فحسب، بل سيتم تحديد كلمة ``filename``، مع وضع المؤشر فوقها، بحيث يمكنك بسهولة كتابة اسم الملف الحقيقي، باستخدام ميزة الإكمال التلقائي الذكية للمحرر :ref:`editor_auto_complete`. وبمجرد الانتهاء من كتابة اسم الملف، اضغط على |ct| مرة أخرى وسيقفز المؤشر إلى الموضع بين علامتي ``<a>`` بحيث يمكنك بسهولة كتابة نص الرابط. بعد الانتهاء من كتابة النص، اضغط على |ct| مرة أخرى للقفز إلى النقطة بعد علامة الإغلاق. يتم تعريف هذه القصاصة كالتالي::

en: There are a couple of new features here. First the ``$1`` placeholder has become more complex. It now includes some *default text* (the word ``filename``). If a placeholder contains default text, the default text is substituted for the placeholder when the snippet is expanded. Also when you jump to a placeholder with default text using |ct|, the default text is selected. In this way, you can use default text to act as a reminder to you to fill in important parts of the template. You can specify default text for a placeholder by using the syntax: ``${<number>:default text}``.
ar: هنا توجد بعض الميزات الجديدة. أولاً، أصبح العنصر النائب ``$1`` أكثر تعقيدًا. وهو يتضمن الآن بعض *النص الافتراضي* (كلمة ``filename``). إذا كان العنصر النائب يحتوي على نص افتراضي، يتم استبدال النص الافتراضي بالعنصر النائب عند توسيع القصاصة. أيضًا عندما تقفز إلى عنصر نائب بنص افتراضي باستخدام |ct|، يتم تحديد النص الافتراضي. بهذه الطريقة، يمكنك استخدام النص الافتراضي كتذكير لك لملء الأجزاء المهمة من القالب. يمكنك تحديد نص افتراضي لـ عنصر نائب باستخدام الصيغة: ``${<number>:default text}``.

en: The other new feature is that the second placeholder has an asterisk after it (``${2*}``). This means that any text that was selected before expanding the template is substituted for the placeholder. To see this in action, select some text in the editor, press |ct|, type ``<a`` and press |ct| again, the template will be expanded to::
ar: الميزة الجديدة الأخرى هي أن العنصر النائب الثاني يحتوي على نجمة بعده (``${2*}``). هذا يعني أن أي نص تم تحديده قبل توسيع القالب يتم استبداله بالعنصر النائب. لرؤية هذا عمليًا، حدد بعض النصوص في المحرر، اضغط |ct|، اكتب ``<a`` واضغط |ct| مرة أخرى، سيتم توسيع القالب إلى::

en: Inserting a HTML image tag [<i]
ar: إدراج علامة صورة HTML [<i]

en: This is very similar to inserting an HTML link, as we saw above. It allows you to quickly input an ``<img src="filename" alt="description" />`` tag and jump between the ``src`` and ``alt`` attributes::
ar: هذا مشابه جدًا لإدراج رابط HTML، كما رأينا أعلاه. يسمح لك بإدخال سريع لعلامة ``<img src="filename" alt="description" />`` والقفز بين سمتي ``src`` و ``alt``::

en: Insert an arbitrary HTML tag [<<]
ar: إدراج علامة HTML عشوائية [<<]

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
ar: اكتب اسم العلامة، على سبيل المثال: ``span`` واضغط على |ct|، سينتج عن ذلك ما يلي::

en: You will note that the closing tag has been automatically filled with ``span``. This is achieved with yet another feature of placeholders, *mirroring*. Mirroring simply means that if you specify the sample placeholder more than once in a template, the second and all later positions will be automatically filled in with whatever you type in the first position, when you press |ct|. The definition for this snippet is::
ar: ستلاحظ أن علامة الإغلاق قد تم ملؤها تلقائيًا بـ ``span``. يتم تحقيق ذلك بميزة أخرى للعناصر النائبة، وهي *المرايا*. تعني المرايا ببساطة أنه إذا قمت بتحديد العنصر النائب النموذجي أكثر من مرة في قالب، فسيتم ملء الموضع الثاني وجميع المواضع اللاحقة تلقائيًا بما تكتبه في الموضع الأول، عندما تضغط على |ct|. تعريف هذه القصاصة هو::

en: As you can see, the first placeholder ($1) has been specified twice, the second time in the closing tag, which will simply copy whatever you type in the opening tag.
ar: كما ترى، تم تحديد العنصر النائب الأول ($1) مرتين، المرة الثانية في علامة الإغلاق، والتي ستقوم ببساطة بنسخ أي شيء تكتبه في علامة الفتح.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
ar: إدراج علامة HTML عشوائية بسمة فئة [<c]

en: This is very similar to the insert arbitrary tag example above, except that it assumes that you want to specify a class for the tag::
ar: هذا مشابه جدًا لمثال إدراج علامة عشوائية أعلاه، باستثناء أنه يفترض أنك تريد تحديد فئة للعلامة::

en: This will allow you to first type the tag name, press |ct|, type the class name, press |ct| type the contents of the tag and press |ct| one last time to jump out of the tag. The closing tag will be auto-filled.
ar: سيسمح لك هذا أولاً بكتابة اسم العلامة، ثم الضغط على |ct|، ثم كتابة اسم الفئة، ثم الضغط على |ct|، ثم كتابة محتويات العلامة، ثم الضغط على |ct| للمرة الأخيرة للقفز خارج العلامة. سيتم ملء علامة الإغلاق تلقائيًا.

en: Creating your own snippets
ar: إنشاء قصاصاتك الخاصة

en: Snippets really shine because you can create your own to suit your editing style. To create your own snippets go to :guilabel:`Edit->Preferences->Editor settings->Manage snippets` in the editor. This will pop-up an easy to use dialog to help you create your own snippets. Simply click the :guilabel:`Add snippet` button and you will see a dialog that looks like:
ar: تتألق القصاصات حقًا لأنه يمكنك إنشاء قصاصات خاصة بك لتناسب أسلوب تحريرك. لإنشاء قصاصاتك الخاصة، انتقل إلى :guilabel:`تحرير->التفضيلات->إعدادات المحرر->إدارة القصاصات` في المحرر. سيظهر مربع حوار سهل الاستخدام لمساعدتك في إنشاء قصاصاتك الخاصة. ما عليك سوى النقر على زر :guilabel:`إضافة قصاصة` وسترى مربع حوار يبدو كالتالي:

en: The create your own snippets tool
ar: أداة إنشاء قصاصاتك الخاصة

en: First give your snippet a name, something descriptive, to help identify the snippet in the future. Then specify the *trigger*. A trigger is simply the text that you have to type in the editor before pressing |ct| in order to expand the snippet.
ar: أولاً، أعطِ قصاصتك اسمًا، شيئًا وصفيًا، للمساعدة في تحديد القصاصة في المستقبل. ثم حدد *المشغل*. المشغل هو ببساطة النص الذي يجب عليك كتابته في المحرر قبل الضغط على |ct| لـ توسيع القصاصة.

en: Then specify the snippet template. You should start with one of the examples above and modify it to suit your needs. Finally, specify which file types you want the snippet to be active for. This way you can have multiple snippets with the same trigger text that work differently in different file types.
ar: ثم حدد قالب القصاصة. يجب أن تبدأ بأحد الأمثلة المذكورة أعلاه وتعدلها لتناسب احتياجاتك. أخيرًا، حدد أنواع الملفات التي تريد أن تكون القصاصة نشطة لها. بهذه الطريقة يمكنك الحصول على عدة قصاصات بنفس نص التشغيل تعمل بشكل مختلف في أنواع ملفات مختلفة.

en: The next step is to test your newly created snippet. Use the :guilabel:`Test` box at the bottom. Type in the trigger text and press |ct| to expand the snippet and jump between placeholders.
ar: الخطوة التالية هي اختبار القصاصة التي أنشأتها حديثًا. استخدم مربع :guilabel:`اختبار` في الأسفل. اكتب نص التشغيل واضغط على |ct| لتوسيع القصاصة والقفز بين العناصر النائبة.
