ملفات Dotfiles

يُضبط OmarOS في المقام الأول من خلال ما يسمى بـ dotfiles التي تعيش في ~/.config. وتُعتبر تلك ملفاتك الخاصة بتغييراتك. أما الملفات التي تعيش في /usr/share/omaros فهي تنتمي إلى OmarOS نفسه، ولا يجب عليك العبث بها. إذا احتجت إلى تغيير أي شيء في /usr/share/omaros، فيجب عليك الكتابة فوق القيمة في ~/.config بدلًا من ذلك.

يمكن تعديل الإعدادات الرئيسية مباشرة من قائمة OmarOS (Super + Space)، مثل الإعداد > Monitors و_الإعداد > Keybindings_ و_الإعداد > Input_ و_الإعداد > Config > [file]_. عندما تقوم بذلك بهذه الطريقة، فإن أي عملية تحتاج إلى إعادة تشغيل بعد تعديلات الإعدادات ستحدث تلقائيًا بعدما تخرج من المحرر (Neovim افتراضيًا — :wq، تذكّر! — ولكن يمكنك تغيير ذلك عبر الإعداد > Defaults > Editor).

إليك قائمة بالملفات الرئيسية في ~/.config وما تتحكم به:

File	Purpose
~/.config/hypr/hyprland.lua	ملف Hyprland الرئيسي للإعدادات. يقوم بتحميل إعدادات OmarOS الافتراضية بالإضافة إلى ملفات التجاوز الخاصة بك أدناه. تعرّف على المزيد حول إعدادات Hyprland.
~/.config/hypr/bindings.lua	اختصارات المفاتيح الخاصة بك وتجاوزاتك للإعدادات الافتراضية.
~/.config/hypr/monitors.lua	يتحكم في شاشاتك ودقتها وموضعها.
~/.config/hypr/input.lua	يتحكم في تخطيط لوحة المفاتيح وفأرتك وإعدادات لوحة اللمس.
~/.config/hypr/looknfeel.lua	يتحكم في الفواصل والحدود والرسوم المتحركة وبقية الإطلالة.
~/.config/hypr/autostart.lua	يتحكم في العمليات الإضافية التي تبدأ مع الجلسة.
~/.config/omaros/shell.json	يتحكم في OmarOS shell: موضع الشريط وتخطيطه وأدواته، بالإضافة إلى توقيتات شاشة التوقف والقفل والخمول.
~/.config/foot/foot.ini	يتحكم في terminal الخاصة بك (foot هو الافتراضي).
~/.XCompose	يعرّف إيموجي الوصول السريع الخاصة بك وإكمال الاسم/البريد الإلكتروني تلقائيًا. تأكد من تشغيل omaros-restart-xcompose بعد إجراء تغييرات.

إذا أجريت في النهاية الكثير من التغييرات لضبط إعداداتك الخاصة، فمن الجيد الاحتفاظ بنسخة احتياطية من جميع ملفات dotfiles هذه. Stow طريقة رائعة للقيام بذلك.

بدء تشغيل تطبيقاتك الخاصة مع الجلسة

إذا كنت تريد أن يعمل شيء ما كلما قمت بتسجيل الدخول — خدمة مزامنة في الخلفية، أو تطبيق دردشة، أو نصًا برمجيًا خاصًا بك — ضعه في ~/.config/hypr/autostart.lua:

o.launch_on_start("my-service")

يؤدي ذلك إلى بدء الأمر بوصفه جزءًا من الجلسة، فيتم تنظيفه بشكل صحيح عندما تقوم بتسجيل الخروج مجددًا.

تشغيل النصوص البرمجية عند أحداث النظام

يُطلق OmarOS خطافات في بضعة لحظات محددة، ويمكنك تعليق نصوصك البرمجية عليها. إنها تعيش في ~/.config/omaros/hooks/<event>.d/، بمجلد واحد لكل حدث، ويقوم كل ملف قابل للتنفيذ هناك بالتشغيل عندما يحدث الحدث:

Event	When it runs
post-boot	مباشرة بعد بدء سطح المكتب
post-update	قرب نهاية omaros update، بعد الحزم والترحيلات وإعادات تشغيل الخدمات، قبل تحديث أدوات mise
pre-refresh-pacman	بعد أن يعيد omaros refresh pacman مزامنة إعدادات الحزمة، قبل أن يقوم بتحديث الحزم؛ ويقوم تبديل القناة بتشغيلها أثناء خطوة التحديث نفسها
theme-set	بعد تغيير السمة (اسم السمة في $1)
font-set	بعد تغيير الخط (اسم الخط في $1)
battery-low	عندما ينخفض مستوى البطارية (النسبة المئوية في $1)

خطاف pre-refresh-pacman هو المكان الذي تنتمي إليه المستودعات المخصصة أو أسطر IgnorePkg، لأنه يعمل قبل معاملة الحزمة. يعمل خطافا التحديث ذوي الصلة كلاهما كمستخدمك بعد أن يمسح OmarOS تصريح sudo المخزن مؤقتًا له، لذا يحتاج خطاف يستخدم sudo إلى تصريحه الخاص وقد يطلب كلمة مرورك.

يحتفظ كل واحد من هذه المجلدات بملف .sample يعرض شكل الخطاف — أزل .sample من الاسم لتضعه موضع التنفيذ. ولتثبيت نص كتبته في مكان آخر، استخدم omaros hook install post-boot ~/my-hook، الذي سينسخه ويجعله قابلًا للتنفيذ.

إضافة إدخالات القائمة الخاصة بك

يمكن توسيع قائمة OmarOS (Super + Space) بصفوفك الخاصة عن طريق تحرير ~/.config/omaros/extensions/omaros-menu.jsonc. يتم فهرسة الإدخالات بواسطة معرّف منقوط، والمعرّف هو ما يضعها في الشجرة، لذا تظهر personal على القائمة الجذرية وتظهر personal.notes داخلها:

"personal": {"icon":"","label":"Personal"},
"personal.notes": {"icon":"󰎞","label":"Notes","action":"omaros-launch-editor ~/notes"},

استخدم معرّفًا موجودًا وستقوم بتجاوز ذلك الصف بدلًا من إضافة صف جديد. يأتي الملف مع توثيق لجميع الحقول المتاحة في شكل تعليقات.

إضافة صادرات shell والدوال والاختصارات الخاصة بك

يأتي OmarOS مع مجموعة من الاختصارات المريحة والدوال المفيدة، ولكن من الشائع جدًا أنك تريد إضافة اختصارات خاصة بك. يجب عليك إضافة الاختصارات والدوال والصادرات كلها في ~/.bashrc. لن يتم الكتابة فوق هذا الملف عند التحديثات. وإذا كنت تريد تغيير أي من إعدادات OmarOS الافتراضية، فيمكنك أيضًا إضافة ذلك هنا بأمان.

تغيير ملفات OmarOS الداخلية

اسمع، هذا حاسوبك. يمكنك أن تفعل به ما تشاء، ولكني أنصح تجنب إجراء تغييرات على الملفات في /usr/share/omaros مباشرة. فهي تنتمي إلى حزمة OmarOS في pacman، لذا ستتم استبدال تغييراتك ببساطة عند التحديث التالي. من الأفضل أن تكتب فقط فوق أي قيم افتراضية لا تعجبك في مجلد ~/.config/* بدلًا من ذلك.

يمكنك تغيير كل شيء تقريبًا بهذه الطريقة، مثل اختصارات المفاتيح الافتراضية. فقط عدّل ~/.config/hypr/bindings.lua لتستبدل، على سبيل المثال، Obsidian بـ Joplin (ثبّته باستخدام omaros-pkg-add joplin-bin):

o.rebind("SUPER + SHIFT + O", "Joplin", "joplin-desktop")

يقوم o.rebind بإزالة الربط الحالي قبل إضافة بديله. وهو يأخذ الوسائط نفسها التي يأخذها o.bind، بما في ذلك مساعدو التشغيل وخيارات الربط. استخدم o.bind لإضافة ربط، أو hl.unbind لإزالة ربط دون استبداله.

إذا أصررت على اختراق ملفات OmarOS الداخلية، فانتقل إلى قناة dev عبر تحديث > Channel > Dev. يربط ذلك OmarOS بنسخة git من الكود المصدري في ~/omaros، التي تتمتع بحرية تغييرها كيفما تشاء. ليس هنا من يقول لك ماذا تفعل!

إعادة ضبط أي تغييرات

إذا انتهى بك الأمر إلى إفساد الإعدادات، فيمكنك دائمًا إرجاعها إلى الإعدادات الافتراضية عبر تحديث > Config في قائمة OmarOS. أو عن طريق تشغيل omaros reinstall configs لإعادة ضبط كل شيء.