> For the complete documentation index, see [llms.txt](https://hacking-notes.jord4n.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hacking-notes.jord4n.pro/ar/useful-resources/gh0stzk-bspwm-dotfiles.md).
# إعداد Arch Linux للمخترقين مع BSPWM
[gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles) هي بيئة سطح مكتب BSPWM كاملة لـ Arch Linux والتوزيعات المبنية على Arch. وتتضمن الثيمات، وأشرطة النظام، والمشغلات، وإعدادات الطرفية، وZSH، وNeovim، وأدوات Rofi الصغيرة، والخلفيات، والسكربتات المساعدة للتبديل السريع بين الأنماط.
مثال على بيئة سطح مكتب BSPWM من README الخاص بالمشروع.
{% hint style="warning" %}
ثبّت هذا فقط على جهاز مختبر شخصي أو على محطة عمل Linux جديدة. تستبدل ملفات dotfiles العديد من ملفات إعدادات المستخدم، لذا راجع المُثبّت وخذ نسخة احتياطية من إعدادك الحالي قبل التشغيل.
{% endhint %}
## أين يندرج
يندرج هذا ضمن `موارد مفيدة` لأنه مورد لإعداد محطة عمل، وليس أداة اختبار اختراق. استخدمه عندما تريد بيئة BSPWM نظيفة مبنية على Arch للملاحظات اليومية، والمختبرات، والعمل على CTF، والتطوير، وسير العمل المعتمد بكثافة على الطرفية.
## ما الذي يقدّمه لك
| المكوّن | ما الذي يعنيه |
| -------------------- | ------------------------------------------------------------------------------------------ |
| BSPWM | مدير نوافذ متراص لسطح مكتب سريع يعتمد على لوحة المفاتيح. |
| 18 ثيمًا | أنماط بصرية جاهزة يمكن التبديل بينها فورًا. |
| Polybar | شريط سطح مكتب مع مساحات العمل، والوحدات، ومعلومات النظام، وألوان الثيم. |
| تطبيقات Rofi الصغيرة | قوائم للتطبيقات، والطاقة، ولقطات الشاشة، والحافظة، والشبكة، والبلوتوث، والخلفيات، والمزيد. |
| الطرفيات | دعم الثيمات لـ Alacritty وKitty وGhostty وST وXfce Terminal. |
| إعداد ZSH | إعداد سريع للغلاف مع الإكمال، والبحث في السجل، ومعاينات fzf-tab. |
| إعداد Neovim | إعداد محرر جاهز مسبقًا مع LSP، والإكمال، والتنسيق، والمستعرض، وشريط الحالة، ولوحة التحكم. |
| RiceEditor | تطبيق مساعد لضبط الإعدادات البصرية دون تعديل كل ملف إعداد يدويًا. |
## معاينة بصرية
المشروع بصري جدًا، لذا تحقق من لقطات الشاشة والعرض التجريبي قبل التثبيت.
محدد الثيم.
محدد الخلفية.
RiceEditor لتخصيص الثيم.
### العرض التجريبي للمشروع
{% embed url="" %}
### شرح تثبيت Arch
هذا الفيديو من المنشئ مفيد إذا أردت تثبيت Arch نظيفًا قبل تطبيق ملفات dotfiles.
{% embed url="" %}
### قناة المشروع
تحتوي قناة المؤلف على المزيد من عروض BSPWM وPolybar وEww وRofi والثيمات.
{% embed url="" %}
## قبل التثبيت
المثبّت الرسمي مخصص لـ Arch Linux والتوزيعات المبنية على Arch. ويذكر README أن التوزيعات غير المعتمدة على systemd مثل Artix غير مدعومة.
نقطة البداية الموصى بها:
| المتطلب | ملاحظات |
| ----------------------------- | --------------------------------------------------- |
| توزيعة Arch أو مبنية على Arch | التثبيت الجديد هو الأكثر أمانًا. |
| حساب مستخدم عادي | لا تشغّل المثبّت بامتيازات root. |
| اتصال إنترنت يعمل | يقوم المثبّت بتنزيل الحزم والمستودعات. |
| مدير تسجيل الدخول | يوصى بـ LightDM من قبل المشروع. |
| NetworkManager | مطلوب لتطبيق الشبكة الصغير في Rofi. |
| نسخة احتياطية | احتفظ بنسخة من `~/.config` والملفات الخاصة بالغلاف. |
أمر نسخ احتياطي مفيد قبل التجربة:
```bash
mkdir -p "$HOME/dotfiles-backup"
cp -a "$HOME/.config" "$HOME/dotfiles-backup/config-$(date +%F)" 2>/dev/null
cp -a "$HOME/.zshrc" "$HOME/.gtkrc-2.0" "$HOME/.icons" "$HOME/dotfiles-backup/" 2>/dev/null
```
## إعداد Arch السريع
استخدم هذا عندما تبدأ من جهاز Arch نظيف أو آلة افتراضية وتريد أقصر مسار عملي.
### 1. إقلاع ISO الخاص بـ Arch
ابدأ من ISO الرسمي لـ Arch. إذا كنت تستخدم Wi‑Fi فقم بالاتصال أولًا:
```bash
iwctl
```
داخل `iwctl`:
```
device list
station wlan0 scan
station wlan0 get-networks
station wlan0 connect "SSID"
exit
```
تحقق من الإنترنت:
```bash
ping -c 3 archlinux.org
```
مزامنة الوقت:
```bash
timedatectl set-ntp true
```
### 2. ثبّت Arch بسرعة
المسار السريع هو `archinstall`:
```bash
archinstall
```
الخيارات الموصى بها:
| الخيار | اختر |
| -------------- | ---------------------------------------------------------------------------- |
| تخطيط الأقراص | الافتراضي أو اليدوي، حسب الجهاز الافتراضي/القرص لديك. |
| محمل الإقلاع | `systemd-boot` لـ UEFI، أو GRUB إذا كنت تفضله. |
| الملف التعريفي | الخيار Minimal يكفي؛ أما سطح المكتب فهو اختياري. |
| الشبكة | NetworkManager. |
| الصوت | PipeWire. |
| المستخدم | أنشئ مستخدمًا عاديًا مع صلاحية sudo. |
| حزم إضافية | `git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager` |
بعد التثبيت:
```bash
إعادة التشغيل
```
### 3. فعّل الأساسيات
سجّل الدخول كمستخدمك العادي، ثم تأكد من أن الخدمات الأساسية جاهزة:
```bash
sudo pacman -Syu
sudo pacman -S --needed git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager
sudo systemctl enable --now NetworkManager
sudo systemctl enable lightdm
```
أعد التشغيل مرة أخرى إذا كنت قد فعّلت LightDM للتو:
```bash
sudo reboot
```
## تثبيت Dotfiles
افتح طرفية من مجلد المنزل الخاص بك:
```bash
cd "$HOME"
```
حمّل المثبّت الرسمي:
```bash
curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller
```
راجع المثبّت قبل تنفيذه:
```bash
less RiceInstaller
```
امنحه إذن التنفيذ:
```bash
chmod +x RiceInstaller
```
شغّله كمستخدمك العادي:
```bash
./RiceInstaller
```
المثبّت تفاعلي. قد يسألك عمّا إذا كنت تريد إعدادات Neovim وFirefox المرفقة. اقرأ كل مطالبة بدلًا من الضغط على Enter دون تفكير.
### تثبيت في خطوة واحدة
لتثبيت سريع في المختبر بعد أن يصبح Arch لديك جاهزًا:
```bash
cd "$HOME"
curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller
less RiceInstaller
chmod +x RiceInstaller
./RiceInstaller
```
## ما الذي يفعله المثبّت
على مستوى عالٍ، يقوم المثبّت بما يلي:
1. يتحقق من أنه لا يتم تشغيله كـ root.
2. يتحقق من أنه يتم تنفيذه من داخل `$HOME`.
3. يضيف مستودع الحزمة `gh0stzk-dotfiles` .
4. يضيف Chaotic-AUR.
5. يحمل ملفات dotfiles.
6. ينشئ نسخًا احتياطية من إعدادات المستخدم الحالية عند الحاجة.
7. يثبّت بيئة BSPWM.
8. يُفعّل MPD لميزات الموسيقى.
9. يغيّر الغلاف إلى ZSH.
ينقل السكربت أيضًا العديد من مجلدات الإعدادات الحالية إلى مجلد نسخ احتياطي قبل استبدالها. ومع ذلك، احتفظ بنسختك الاحتياطية أولًا.
## أول تسجيل دخول
بعد التثبيت:
1. أعد التشغيل أو سجّل الخروج.
2. اختر جلسة BSPWM من مدير تسجيل الدخول لديك.
3. سجّل الدخول بشكل طبيعي.
4. انتظر حتى ينتهي التشغيل الأول من الإعداد التلقائي.
5. اختبر الطرفية، وRofi، وPolybar، ومحدد الثيم، ومحدد الخلفية.
إذا كنت داخل آلة افتراضية وكان سطح المكتب يبدو معطّلًا أو بطيئًا، فحاول تغيير Picom من `glx` إلى `xrender` قبل افتراض أن التثبيت فشل.
## أول الأشياء التي يجب التحقق منها
بعد التشغيل الأول، تحقق من المتغيرات المتعلقة بالعتاد. افتح:
```bash
~/.config/bspwm/config/system.ini
```
تحقق من القيم الخاصة بـ:
| القيمة | لماذا هذا مهم |
| ----------------- | ------------------------------------- |
| واجهة الشبكة | وحدات الشبكة في الشريط. |
| بطاقة الرسوميات | بعض الوحدات البصرية ووحدات الحالة. |
| البطارية والمحوّل | وحدات بطارية الحاسوب المحمول والسطوع. |
إذا كنت على حاسوب مكتبي، فعادةً ما تكون واجهة الشبكة هي العنصر الرئيسي الذي يهمك.
## أوامر مفيدة
| الأمر | استخدم |
| ----------------------------------- | -------------------------------------------------------------------- |
| `RiceSelector` | افتح محدد الثيم. |
| `RiceEditor` | عدّل الثيم الحالي بصريًا. |
| `WallSelect` | افتح محدد الخلفية. |
| `Term --selecterm` | اختر تطبيق الطرفية. |
| `OpenApps --menu` | افتح مشغّل التطبيقات. |
| `OpenApps --KeyHelp` | افتح ورقة اختصارات لوحة المفاتيح. |
| `OpenApps --screenshot` | افتح أداة لقطات الشاشة. |
| `OpenApps --netmanager` | افتح أداة إدارة الشبكة. |
| `OpenApps --bluetooth` | افتح أداة البلوتوث. |
| `OpenApps --clipboard` | افتح مدير الحافظة. |
| `OpenApps --powermenu` | افتح قائمة الطاقة. |
| `OpenApps --keyboard` | افتح أداة تخطيط لوحة المفاتيح. |
| `OpenApps --scratch` | افتح scratchpad. |
| `HideBar -h` | إخفاء الأشرطة. |
| `HideBar -u` | إظهار الأشرطة. |
| `SoftReload` | إعادة تحميل ناعمة للبيئة. |
| `ScreenLocker` | قفل الشاشة. |
| `bspc wm -r` | إعادة تحميل BSPWM. |
| `pkill -USR1 -x sxhkd` | إعادة تحميل اختصارات لوحة المفاتيح. |
| `~/.config/bspwm/config/system.ini` | المتغيرات المتعلقة بالعتاد/الوحدات التي يجب التحقق منها بعد التثبيت. |
| `~/.config/bspwm/config/sxhkdrc` | ملف الاختصارات الرئيسي. |
## الاختصارات الكاملة
يعرض المشروع ورقة الاختصارات البصرية باستخدام `Alt + F1`. `سوبر` تعني مفتاح Windows في معظم لوحات المفاتيح. المصدر المعتمد هو الملف المثبّت `~/.config/bspwm/config/sxhkdrc`؛ هذا الجدول يتبع الملف الحالي في المستودع الأصلي ويجمع كل اختصار معًا لتسهيل التصفح.
### مساعدة
| المفاتيح | الإجراء |
| ---------- | ---------------------------------- |
| `Alt + F1` | إظهار ورقة اختصارات لوحة المفاتيح. |
### التطبيقات الرئيسية
| المفاتيح | الإجراء |
| ---------------------- | --------------------------- |
| `Super + Return` | افتح الطرفية العادية. |
| `Super + Alt + Return` | افتح الطرفية العائمة. |
| `Super + Space` | افتح مشغّل التطبيقات. |
| `Alt + Space` | افتح محدد الثيم. |
| `Super + B` | افتح المتصفح. |
| `Super + E` | افتح المحرر. |
| `Super + F` | افتح مدير الملفات. |
| `Super + Y` | افتح Yazi. |
| `Super + V` | افتح Neovim. |
| `Super + M` | افتح مشغل الموسيقى/Ncmpcpp. |
| `Super + P` | افتح Pavucontrol. |
| `Super + T` | افتح Telegram. |
| `Super + W` | افتح WhatsApp. |
| `Super + R` | افتح RiceEditor. |
### تطبيقات Rofi الصغيرة
| المفاتيح | الإجراء |
| ----------------------------------- | -------------------------- |
| `Super + Alt + T` | محدد الطرفية. |
| `Super + Alt + W` | محدد الخلفية. |
| `Super + Alt + A` | أداة تركيب Android. |
| `Super + Alt + N` | مدير الشبكة. |
| `Super + Alt + B` | مدير البلوتوث. |
| `Super + Alt + C` | مدير الحافظة. |
| `Super + Alt + S` | أداة لقطات الشاشة. |
| `Super + Alt + P` | قائمة الطاقة. |
| `Super + Alt + L` | محدد نمط مشغّل Rofi. |
| `Super + Alt + K` | أداة تخطيط لوحة المفاتيح. |
| `Super + Alt + X` | أداة RofiPass/كلمة المرور. |
| `النقر بالزر الأيمن على سطح المكتب` | افتح Jgmenu. |
### النظام والبيئة
| المفاتيح | الإجراء |
| ------------------------ | ----------------------------------------- |
| `Super + Alt + O` | scratchpad. |
| `Ctrl + Super + Alt + P` | أطفئ الكمبيوتر. |
| `Ctrl + Super + Alt + R` | أعد تشغيل الكمبيوتر. |
| `Ctrl + Super + Alt + Q` | سجّل الخروج. |
| `Ctrl + Super + Alt + L` | قفل الشاشة. |
| `Ctrl + Super + Alt + K` | أغلق التطبيق باستخدام `xkill`. |
| `Ctrl + Super + Alt + S` | إعادة تحميل ناعمة. |
| `Super + Alt + H` | إخفاء الشريط. |
| `Super + Alt + U` | إظهار الشريط. |
| `Ctrl + Alt + Plus` | زيادة الشفافية في النافذة المركّزة. |
| `Ctrl + Alt + Minus` | تقليل الشفافية في النافذة المركّزة. |
| `Ctrl + Alt + T` | إعادة تعيين الشفافية في النافذة المركّزة. |
| `XF86MonBrightnessUp` | زيادة السطوع. |
| `XF86MonBrightnessDown` | تقليل السطوع. |
| `XF86AudioRaiseVolume` | زيادة مستوى الصوت. |
| `XF86AudioLowerVolume` | خفض مستوى الصوت. |
| `XF86AudioMute` | تبديل كتم الصوت. |
| `XF86AudioNext` | المقطع الإعلامي التالي. |
| `XF86AudioPrev` | المقطع الإعلامي السابق. |
| `XF86AudioPlay` | تشغيل/إيقاف مؤقت للوسائط. |
| `XF86AudioStop` | أوقف الوسائط. |
### النواة الأساسية لـ BSPWM
| المفاتيح | الإجراء |
| ------------------- | -------------------------- |
| `Super + Alt + R` | إعادة تحميل BSPWM. |
| `Super + X` | أغلق العقدة المحددة. |
| `Super + Shift + X` | أنهِ العقدة المحددة قسرًا. |
| `Super + Escape` | أعد تحميل اختصارات sxhkd. |
### حالات العقدة والأعلام
| المفاتيح | الإجراء |
| ----------------- | ------------------------------------ |
| `Alt + T` | اجعل العقدة متجاورة. |
| `Alt + Shift + T` | اجعل العقدة شبه متجاورة. |
| `Alt + A` | اجعل العقدة عائمة. |
| `Alt + F` | اجعل العقدة بملء الشاشة. |
| `Alt + M` | بدّل علم الوسم. |
| `Alt + X` | بدّل العلم المقفل. |
| `Alt + S` | بدّل العلم المثبت. |
| `Alt + P` | بدّل العلم الخاص. |
| `Alt + H` | أخفِ النافذة المحددة. |
| `Ctrl + Alt + H` | اعرض قائمة لاستعادة النوافذ المخفية. |
### مساحات العمل والتركيز
| المفاتيح | الإجراء |
| ----------------------------------------- | ------------------------------------------------------------- |
| `Ctrl + Tab` | دوّر سطح المكتب. |
| `Super + Left` | انتقل إلى مساحة العمل السابقة. |
| `Super + Right` | انتقل إلى مساحة العمل التالية. |
| `Super + 1` إلى `Super + 9` | ركّز مساحة العمل 1 إلى 9. |
| `Super + 0` | ركّز مساحة العمل 10. |
| `Super + Ctrl + 1` إلى `Super + Ctrl + 9` | أرسل النافذة المحددة إلى مساحة العمل 1 إلى 9. |
| `Super + Ctrl + 0` | أرسل النافذة المحددة إلى مساحة العمل 10. |
| `Super + Ctrl + Left` | أرسل النافذة المحددة إلى مساحة العمل السابقة واتبعها. |
| `Super + Ctrl + Right` | أرسل النافذة المحددة إلى مساحة العمل التالية واتبعها. |
| `Alt + Tab` | مبدّل النوافذ. |
| `Super + Alt + Left` | ركّز النافذة إلى الغرب، مع العودة إلى السابقة عند عدم وجودها. |
| `Super + Alt + Down` | ركّز النافذة إلى الجنوب. |
| `Super + Alt + Up` | ركّز النافذة إلى الشمال. |
| `Super + Alt + Right` | ركّز النافذة إلى الشرق، مع العودة إلى التالية عند عدم وجودها. |
| `Ctrl + Alt + Left` | بدّل موضع النافذة المحددة إلى الغرب. |
| `Ctrl + Alt + Down` | بدّل موضع النافذة المحددة إلى الجنوب. |
| `Ctrl + Alt + Up` | بدّل موضع النافذة المحددة إلى الشمال. |
| `Ctrl + Alt + Right` | بدّل موضع النافذة المحددة إلى الشرق. |
| `Ctrl + Shift + Comma` | ركّز آخر عقدة. |
| `Ctrl + Shift + Period` | ركّز آخر سطح مكتب. |
### التحديد المسبق
| المفاتيح | الإجراء |
| ------------------ | ------------------------------------ |
| `Super + Ctrl + H` | حدّد مسبقًا تقسيمًا أفقيًا/شرقيًا. |
| `Super + Ctrl + V` | حدّد مسبقًا تقسيمًا عموديًا/جنوبيًا. |
| `Super + Ctrl + Q` | ألغِ التحديد المسبق. |
### نقل وتحجيم
| المفاتيح | الإجراء |
| ----------------------- | -------------------------------- |
| `Super + Ctrl + B` | وازِن عقد سطح المكتب. |
| `Super + Alt + Plus` | زِد حجم العقدة المتجاورة. |
| `Super + Alt + Minus` | قلّل حجم العقدة المتجاورة. |
| `Super + Ctrl + Plus` | زِد حجم العقدة العائمة. |
| `Super + Ctrl + Minus` | قلّل حجم العقدة العائمة. |
| `Super + Shift + Left` | انقل النافذة العائمة إلى اليسار. |
| `Super + Shift + Down` | انقل النافذة العائمة إلى الأسفل. |
| `Super + Shift + Up` | انقل النافذة العائمة إلى الأعلى. |
| `Super + Shift + Right` | انقل النافذة العائمة إلى اليمين. |
### عمليات متعددة
| المفاتيح | الإجراء |
| --------------------------- | ------------------------------------------------------ |
| `Super + Ctrl + X` | أغلق جميع العقد في سطح المكتب الحالي. |
| `Super + N`، ثم `X` | أغلق جميع النوافذ المحلية غير المحددة. |
| `Super + N`، ثم `K` | أنهِ جميع النوافذ المحلية غير المحددة قسرًا. |
| `Super + N`، ثم `M` | انقل جميع النوافذ المعلَّمة إلى سطح المكتب المحدد. |
| `Super + N`، ثم `1` إلى `9` | انقل كل نافذة من ذلك سطح المكتب إلى سطح المكتب الحالي. |
## تخصيص شائع
### تغيير السمة
استخدم:
```
Alt + Space
```
اختر سمة من المحدد. يتم تحديث البيئة دون الحاجة إلى إعادة تشغيل الجلسة كاملة.
### تغيير الخلفية
استخدم:
```
Super + Alt + W
```
يدعم المشروع خلفيات عشوائية، وأدلة مخصصة، وخلفيات ثابتة، وخلفيات متحركة، وسلوك عرض الشرائح.
### تحرير السمة الحالية
استخدم RiceEditor عندما تريد ضبط الإعدادات المرئية دون تحرير كل وحدة يدويًا:
```
RiceEditor
```
تشمل التعديلات الشائعة الحدود والظلال والرسوم المتحركة والشفافية وسلوك الخلفية وإعدادات الوحدات الخاصة بالسمة.
## استكشاف الأخطاء وإصلاحها
| المشكلة | ما الذي يجب التحقق منه |
| ----------------------------------- | -------------------------------------------------------------------------------- |
| تسجيل الدخول يعيدك إلى مدير العرض | تأكد من تثبيت جلسة BSPWM وراجع `~/.xsession-errors`. |
| وحدات الشريط غير صحيحة | تحقق من `~/.config/bspwm/config/system.ini`. |
| التطبيق الصغير للشبكة لا يعمل | تأكد من تثبيت NetworkManager وأنه قيد التشغيل. |
| تبدو رسوميات الآلة الافتراضية معطلة | جرّب Picom `xrender` الواجهة الخلفية بدلًا من `glx`. |
| تفشل اختصارات لوحة المفاتيح | تحقق من `sxhkd` قيد التشغيل وراجع `~/.config/bspwm/config/sxhkdrc`. |
| تبدو السمة غير محاذاة | صُمم المشروع وفقًا لـ 1600x900 و96 DPI؛ عدّله بما يناسب شاشتك. |
| اختفت الإعدادات الموجودة | تحقق من مجلد النسخ الاحتياطي الذي أنشأه المثبت ومن ملفك الخاص `dotfiles-backup`. |
## ملاحظات إعادة التثبيت النظيفة
لإعادة المحاولة بأمان أكبر:
1. انسخ ملفاتك الحالية احتياطيًا.
2. أزِل أو انقل أدلة dotfiles القديمة.
3. أعد تنزيل أحدث `RiceInstaller`.
4. راجع البرنامج النصي مرة أخرى.
5. شغّله من `$HOME` كمستخدم عادي.
لا تشغّل مثبتات معدلة عشوائيًا من تفرعات طرف ثالث إلا إذا راجعت الفروقات.
## المراجع
* [المستودع الرسمي لـ gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles)
* [RiceInstaller](https://github.com/gh0stzk/dotfiles/blob/master/RiceInstaller)
* [الخطوات الأولى بعد التثبيت](https://github.com/gh0stzk/dotfiles/wiki/First-steps-after-installation)
* [ويكي اختصارات لوحة المفاتيح](https://github.com/gh0stzk/dotfiles/wiki/Keyboard-Shortcuts)
* [ملف ربط المفاتيح الحالي sxhkdrc](https://github.com/gh0stzk/dotfiles/blob/master/config/bspwm/config/sxhkdrc)
* [ويكي إعدادات الخلفيات](https://github.com/gh0stzk/dotfiles/wiki/Wallpapers-Configuration)
* [ArchWiki: bspwm](https://wiki.archlinux.org/title/Bspwm)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://hacking-notes.jord4n.pro/ar/useful-resources/gh0stzk-bspwm-dotfiles.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
