مُعامِلات واجهة سطر الأوامر
يمكنك استخدام هذه المعاملات في واجهة سطر الأوامر (CLI) للتحكم في سلوك التطبيق:
| المُعامِل | الوصف |
|---|---|
--help | يُظهر شاشة المساعدة |
--version | يعرض رقم نسخة التطبيق |
--portable | يشغل التطبيق في الوضع المحمول |
--clear-settings | يمسح الإعدادات ويشغل التطبيق |
--dump-settings | يطبع تفريغ الإعدادات ومعلومات أخرى عن التطبيق والبيئة، بصيغة ماركداون GitHub ويخرج من التطبيق |
--session <اسم> | يشغل التطبيق في سياق مختلف للإعدادات والملفات الداخلية |
--allow-multiple-instances | يسمح بتشغيل عدة نسخ من تطبيق QOwnNotes حتى في حالة منع ذلك في الإعدادات |
--action <اسم> | ينفذ إجراء قائمة بعد تشغيل التطبيق (انظر بالأسفل) |
--completion <الصدفة> | يولّد أوامر الإكمال الملائمة للصَدفة. يقبل fish و bash. |
--decrypt-note <file> | Prints the decrypted text of an encrypted note file to the command line and exits |
--decrypt-note-password <password> | Provides the password for --decrypt-note instead of prompting for it |
Tips
إذا كنت تواجه مشاكل مع QOwnNotes المثبت لديك، ربما تود أن تشغّل التطبيق بإعدادات جديدة بغير أن تفقد إعداداتك الحالية، باستخدام المُعامل --session.
QOwnNotes --session test
قد تحتاج إلى تشغيل التطبيق من واجهة سطر الأوامر بطرق مختلفة على أنظمة التشغيل المختلفة:
| نظام التشغيل | الأمر |
|---|---|
| لينكس | QOwnNotes (أو qownnotes لو كان مثبتًا عبر snap) |
| ماك أو إس | <span dir="ltr">/Applications/QOwnNotes.app/Contents/MacOS/QOwnNotes</span> |
| ويندوز | QOwnNotes.exe |
Tips
لنسخ تفريغ الإعدادات إلى الحافظة مباشرةً لنشره في مسألة أو مشكلة على GitHub، يمكنك استخدام 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
Print decrypted encrypted note text
With the parameter --decrypt-note <file> you can print the decrypted text of an encrypted note file to the command line. If no password is provided, QOwnNotes will ask for it on the command line.
QOwnNotes --decrypt-note secret.md
You can also provide the password directly with --decrypt-note-password:
QOwnNotes --decrypt-note secret.md --decrypt-note-password "my password"
Warning
Providing passwords as command line parameters can expose them in your shell history or process list. Prefer the password prompt if this is a concern.
تنفيذ إجراءات قائمة بعد التشغيل
باستخدام المُعامِل --action <اسم>، يمكنك تنفيذ إجراءات قائمة بعد تشغيل التطبيق.
مثلا لإظهار حوار قائمة المهام بعد التشغيل، استخدم:
QOwnNotes --action actionShow_Todo_List
Tips
يمكنك الحصول على أسماء كائنات إجراءات القائمة من mainwindow.ui. فقط ابحث بالعنوان الإنجليزي للقائمة. لاحظ أن هذه النصوص قد تتغير بمرور الوقت.
لتنفيذ إجراء برمجي، استخدم customAction_متبوعًا باسم الإجراء المخصص. اسم الإجراء المخصص هو المُعامل الأول في نداء script.registerCustomAction في البُريمج.
مثلا لتنفيذ الإجراء المخصص myAction، شغّل QOwnNotes هكذا:
QOwnNotes --action customAction_myAction
Tips
إذا كنت تستخدم وضع النسخة الوحيدة وقمت بتشغيل QOwnNotes مرة ثانية باستخدام مُعامِل الإجراء، فإن إجراء القائمة سيُنفَّذ في النسخة الأولى.