DNF5-ALIASES(7)

الاسم
dnf5-aliases - أسماء مستعارة لوسائط سطر الأوامر

الوصف

يمكن تعريف أسماء مستعارة مخصصة تُستخدم كأوامر أو خيارات dnf لاختصار تسلسلات الأوامر والخيارات الأطول.

يمكن تهيئة الأسماء المستعارة بتنسيق TOML وتُحمّل ملفات التهيئة من هذه الدلائل الإضافية:

•   /usr/share/dnf5/aliases.d/

•   /etc/dnf/dnf5-aliases.d/

•   $XDG_CONFIG_HOME/dnf5/aliases.d/

  الصيغة:

يجب أن يبدأ ملف التهيئة بالسمة version المضبوطة على إصدار مطلوب، على سبيل المثال:

    الإصدار = '1.1'

يُعرّف كل اسم مستعار في قسم منفصل باستخدام أزواج key = value، على سبيل المثال:

    ['in']
    type = 'command'
    attached_command = 'install'
    descr.C = "Alias for 'install'"
    descr.cs_CZ = "Alias pro 'install'"

يُحدد اسم القسم الاسم المستعار بشكل فريد. يكون على شكل مسار، أي سلسلة نصية واحدة أو أكثر مفصولة بنقاط، تُعرّف نطاق الاسم المستعار. على سبيل المثال، السلسلة "group.list.in" تُحدد اسمًا مستعارًا قابلًا للاستخدام فقط ضمن نطاق الأمر الفرعي group list.

توجد الأنواع التالية من الأسماء المستعارة:

•   أمر

•   وسيطة_مسماة_مستنسخة

•   وسيطة_مسماة

•   group

  النوع: أمر

يُعرّف الاسم المستعار command اسمًا مستعارًا لأمر.

المفاتيح:

•   type - يجب أن تكون قيمته command.

•   attached_command - مسار الأمر الذي يُعرّف له هذا الاسم المستعار.

•   descr.<locale> – وصف يُعرض في المساعدة. يُستخدم descr.C إذا لم يُعثر على وصف للإعدادات المحلية المناسبة. أُضيف في إصدار ملف التهيئة 1.1.

•   descr – وصف يُعرض في المساعدة. أُهمل في الإصدار 1.1، لكنه يبقى متوافقًا مع الإصدارات السابقة. لا يدعم الإعدادات المحلية.

•   group_id - مجموعة ينتمي إليها هذا الاسم المستعار إن وُجدت.

•   complete - ما إذا كان يجب استخدام الإكمال التلقائي bash لهذا الاسم المستعار، المبدئي هو false.

•   required_values - القيم (الوسائط الموضعية) التي يستهلكها الاسم المستعار للأمر. التنسيق هو مصفوفة من الجداول؛ يجب أن يتضمن كل منها إما value_help.<locale> للإعدادات المحلية النشطة أو value_help.C، وقد يتضمن اختياريًا descr.<locale>. المبدئي هو مصفوفة فارغة. أُضيف في إصدار ملف التهيئة 1.1.

•   attached_named_args - خيارات تُستخدم مع الأمر. التنسيق هو مصفوفة من الجداول، يجب أن يحتوي كل منها على مفتاح id_path لتحديد المسار إلى خيار، وقد يحتوي أيضًا على مفتاح value لتحديد قيمة الخيار. يمكن أن يحتوي value على عناصر نائبة ${index}، والتي تُستبدل بالقيم التي يستهلكها اسم الأمر المستعار (كما هو محدد بواسطة required_values). تبدأ وسائط الأمر من الفهرس 1. يشير الفهرس 0 إلى اسم الأمر المستعار نفسه. إذا لم يُقدم مفتاح value، فسيُمرر سلسلة فارغة إلى الوسائط المسماة التي تتوقع قيمة.

    المفاتيح المطلوبة هي type وattached_command.

أمثلة:

•   الاسم المستعار grouplist للأمر group list:

        ['grouplist']
        type = 'command'
        attached_command = 'group.list'
        descr.C = "Alias for 'group list'"
        descr.cs_CZ = "Alias pro 'group list'"

•   الاسم المستعار group.ls للأمر group list:

        ['group.ls']
        type = 'command'
        attached_command = 'group.list'
        descr.C = "Alias for 'group list'"
        descr.cs_CZ = "Alias pro 'group list'"
        complete = true

•   الاسم المستعار list-fedora-all للأمر --repo=fedora list --showduplicates:

        ['list-fedora-all']
        type = 'command'
        attached_command = 'list'
        descr.C = "Alias for '--repo=fedora list --showduplicates'"
        descr.cs_CZ = "Alias pro '--repo=fedora list --showduplicates'"
        complete = true
        attached_named_args = [
            { id_path = 'repo', value = 'fedora' },
            { id_path = 'list.showduplicates' }
        ]

•   الاسم المستعار whatrequires للأمر repoquery --installed --whatrequires=<requires_first_argument>:

        ['whatrequires']
        type = 'command'
        attached_command = 'repoquery'
        descr = 'Alias for "repoquery --installed --whatrequires=<whatrequires_first_argument>"'
        complete = true
        [[whatrequires.required_values]]
        value_help.C = 'CAPABILITY,...'
        descr.C = 'Limit to packages that require any of <capabilities>.'
        descr.cs_CZ = 'Omezí se na balíčky vyžadující něco z <capabilities>.'
        [[whatrequires.attached_named_args]]
        id_path = 'repoquery.installed'
        [[whatrequires.attached_named_args]]
        id_path = 'repoquery.whatrequires'
        value='${1}'

  النوع: cloned_named_arg

الاسم المستعار cloned_named_arg يُعرّف اسمًا آخر لخيار معين.

المفاتيح:

•   type - يجب أن تكون قيمته cloned_named_arg.

•   long_name - اسم خيار الاسم المستعار.

•   short_name - اختصار بحرف واحد للاسم.

•   source - المسار إلى الخيار الذي يُعرّف له هذا الاسم المستعار.

•   group_id - مجموعة ينتمي إليها هذا الاسم المستعار إن وُجدت.

•   complete - ما إذا كان يجب استخدام الإكمال التلقائي bash لهذا الاسم المستعار، المبدئي هو false.

    المفاتيح المطلوبة هي type، إما long_name أو short_name، وsource.

أمثلة:

•   الاسم المستعار --nobest للأمر --no-best:

        ['nobest']
        type = 'cloned_named_arg'
        long_name = 'nobest'
        source = 'no-best'

•   الاسم المستعار repoquery --list أو repoquery -l للأمر repoquery --files:

        ['repoquery.list']
        type = 'cloned_named_arg'
        long_name = 'list'
        short_name = 'l'
        source = 'repoquery.files'

  النوع: named_arg

يُعرِّف named_arg اسماً مستعاراً يمكنه استبدال خيارات متعددة وتعريف قيمة لكل منها.

المفاتيح:

•   type - يجب أن تكون القيمة named_arg.

•   long_name - اسم خيار الاسم المستعار.

•   short_name - اختصار بحرف واحد للاسم.

•   descr.<locale> – وصف يُعرض في المساعدة. يُستخدم descr.C إذا لم يُعثر على وصف للإعدادات المحلية المناسبة. أُضيف في إصدار ملف التهيئة 1.1.

•   descr – وصف يُعرض في المساعدة. أُهمل في الإصدار 1.1، لكنه يبقى متوافقًا مع الإصدارات السابقة. لا يدعم الإعدادات المحلية.

•   has_value - ما إذا كان الخيار يتطلب قيمة. تُستبدل القيمة بعد ذلك بسلاسل ${} في قيم attached_named_args. المبدئي هو false.

•   value_help.<locale> - السلسلة المعروضة في المساعدة للقيمة (مثال: CONFIG_FILE_PATH لـ --config=CONFIG_FILE_PATH). يُستخدم value_help.C إذا لم تُعثر على سلسلة للإعدادات المحلية المناسبة. أُضيف في إصدار ملف الإعدادات 1.1.

•   value_help - السلسلة المعروضة في المساعدة للقيمة (مثال: CONFIG_FILE_PATH لـ --config=CONFIG_FILE_PATH). أُهمل في الإصدار 1.1، لكنه يبقى متوافقاً مع الإصدارات السابقة. لا يدعم الإعدادات المحلية.

•   const_value - قيمة ثابتة مبدئية (تُحدد فقط إذا لم يكن للاسم المستعار قيمة في سطر الأوامر). تُستبدل القيمة بعد ذلك بسلاسل ${} في قيم attached_named_args.

•   group_id - مجموعة ينتمي إليها هذا الاسم المستعار إن وُجدت.

•   complete - ما إذا كان يجب استخدام الإكمال التلقائي bash لهذا الاسم المستعار، المبدئي هو false.

•   attached_named_args - الخيارات التي ستُستخدم. التنسيق هو مصفوفة من جداول مضمنة، يجب أن يحتوي كل منها على مفتاح id_path لتحديد المسار إلى خيار، وقد يحتوي أيضًا على مفتاح value لتحديد قيمة الخيار.

    المفاتيح المطلوبة هي type، وإما long_name أو short_name.

أمثلة:

•   الاسم المستعار list --all-available لـ list --showduplicates --available:

        ['list.all-available']
        type = 'named_arg'
        long_name = 'all-available'
        attached_named_args = [
            { id_path = 'list.showduplicates' },
            { id_path = 'list.available' }
        ]

•   الاسم المستعار download --dest=DESTDIR لـ download --destdir=DESTDIR:

        ['download.dest']
        type = 'named_arg'
        long_name = 'dest'
        has_value = true
        value_help.C = 'DESTDIR'
        attached_named_args = [
            { id_path = 'download.destdir' }
        ]

•   الاسم المستعار --settsflags=TS_FLAGS لـ --setopt=tsflags=TS_FLAGS:

        ['settsflags']
        type = 'named_arg'
        long_name = 'settsflags'
        descr.C = 'Set transaction flags'
        descr.cs_CZ = 'Nastavit parametry transakce'
        has_value = true
        value_help.C = 'TS_FLAGS'
        attached_named_args = [
         { id_path = 'setopt', value = 'tsflags=${}' }
        ]

  النوع: group

يُعرِّف group مجموعة لأوامر أو خيارات متعددة.

المفاتيح المطلوبة:

•   type - يجب أن تكون القيمة group.

•   header.<locale> – رأس المجموعة كما سيُعرض في المساعدة. يُستخدم header.C إذا لم يُعثر على رأس للإعدادات المحلية المناسبة. أُضيف في إصدار ملف الإعدادات 1.1.

•   header - رأس المجموعة كما سيُعرض في المساعدة. أُهمل في الإصدار 1.1، لكنه يبقى متوافقاً مع الإصدارات السابقة. لا يدعم الإعدادات المحلية.

    المفاتيح المطلوبة هي type و header.

    تُضاف الأسماء المستعارة إلى المجموعة باستخدام مفتاح group_id في أقسامها الخاصة.

أمثلة:

•   المجموعة query-aliases للأمر الفرعي repo التي تحتوي على الأسماء المستعارة repo.ls و repo.if:

        ['repo.query-aliases']
        type = 'group'
        header.C = 'Query Aliases:'
        header.cs_CZ = 'Zkratky pro dotazy:'
        ['repo.ls']
        type = 'command'
        attached_command = 'repo.list'
        descr.C = "Alias for 'repo list'"
        descr.cs_CZ = "Alias pro 'repo list'"
        group_id = 'query-aliases'
        ['repo.if']
        type = 'command'
        attached_command = 'repo.info'
        descr.C = "مختصر لـ 'repo info'"
        descr.cs_CZ = "مختصر لـ 'repo info'"
        group_id = 'query-aliases'

المؤلف
انظر AUTHORS.md في توزيعة مصدر dnf5.

حقوق النسخ
المساهمون في مشروع dnf5.

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.