# مُعامِلات واجهة سطر الأوامر

يمكنك استخدام هذه المعاملات في واجهة سطر الأوامر (CLI) للتحكم في سلوك التطبيق:

المُعامِل الوصف
‪--help يُظهر شاشة المساعدة
‪--version يعرض رقم نسخة التطبيق
‪--portable يشغل التطبيق في الوضع المحمول
‪--clear-settings يمسح الإعدادات ويشغل التطبيق
‪--dump-settings يطبع تفريغ الإعدادات ومعلومات أخرى عن التطبيق والبيئة، بصيغة ماركداون GitHub ويخرج من التطبيق
‪--session <اسم> يشغل التطبيق في سياق مختلف للإعدادات والملفات الداخلية
‪--allow-multiple-instances يسمح بتشغيل عدة نسخ من تطبيق QOwnNotes حتى في حالة منع ذلك في الإعدادات
‪--action <اسم> ينفذ إجراء قائمة بعد تشغيل التطبيق (انظر بالأسفل)

TIP

إذا كنت تواجه مشاكل مع QOwnNotes المثبت لديك، ربما تود أن تشغّل التطبيق بإعدادات جديدة بدون أن تفقد إعداداتك الحالية، باستخدام المُعامل --session.

QOwnNotes --session test
1

قد تحتاج إلى تشغيل التطبيق من واجهة سطر الأوامر بطرق مختلفة على أنظمة التشغيل المختلفة:

نظام التشغيل الأمر
لينكس QOwnNotes (أو qownnotes لو كان مثبتًا عبر snap)
ماك أو إس <span dir="ltr">/Applications/QOwnNotes.app/Contents/MacOS/QOwnNotes</span>
ويندوز QOwnNotes.exe

# تنفيذ إجراءات قائمة بعد التشغيل

باستخدام المُعامِل --action <اسم>، يمكنك تنفيذ إجراءات قائمة بعد تشغيل التطبيق.

مثلا لإظهار حوار قائمة المهام بعد التشغيل، استخدم:

QOwnNotes --action actionShow_Todo_List
1

TIP

يمكنك الحصول على أسماء كائنات إجراءات القائمة من mainwindow.ui (opens new window). فقط ابحث بالعنوان الإنجليزي للقائمة. لاحظ أن هذه النصوص قد تتغير بمرور الوقت.

لتنفيذ إجراء برمجي، استخدم customAction_ متبوعًا باسم الإجراء المخصص. اسم الإجراء المخصص هو المُعامل الأول في نداء script.registerCustomAction في البُريمج.

مثلا لتنفيذ الإجراء المخصص myAction، شغّل QOwnNotes هكذا:

QOwnNotes --action customAction_myAction
1

TIP

إذا كنت تستخدم وضع النسخة الوحيدة وقمت بتشغيل QOwnNotes مرة ثانية باستخدام مُعامِل الإجراء، فإن إجراء القائمة سيُنفَّذ في النسخة الأولى.