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

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

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

TIP

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

QOwnNotes --session test
1

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

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

TIP

لنسخ تفريغ الإعدادات إلى الحافظة مباشرةً لنشره في مسألة أو مشكلة على GitHub (opens new window)، يمكنك استخدام xclip أو xsel على لينكس، أو pbcopy على macOS، أو clip على Windows:

# انسخ تفريغ الإعدادات إلى الحافظة على لينكس باستخدام xclip
QOwnNotes --dump-settings | xclip -selection clipboard

# انسخ تفريغ الإعدادات إلى الحافظة على لينكس باستخدام xsel
QOwnNotes --dump-settings | xsel --clipboard

# انسخ تفريغ الإعدادات إلى الحافظة على ماك باستخدام pbcopy
QOwnNotes --dump-settings | pbcopy

# انسخ تفريغ الإعدادات إلى الحافظة على ويندوز باستخدام clip
QOwnNotes --dump-settings | clip
1
2
3
4
5
6
7
8
9
10
11

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

باستخدام المُعامِل --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 مرة ثانية باستخدام مُعامِل الإجراء، فإن إجراء القائمة سيُنفَّذ في النسخة الأولى.