الغَسَق ظلمة أول الليل، حين يغيب الشفق ويبقى أثر ضوئه. يقوم الثيم على ثلاثة عناصر:

• حبر: خلفيات ليلية مائلة إلى البنفسجي.
• ورق: نصٌّ دافئ لا أبيض ناصع.
• آخر الضوء: لون تمييز كهرماني يُستعمل قليلًا، في الروابط والمؤشر والأزرار.

الوضع الداكن «غَسَق» هو الأصل، والوضع الفاتح «أصيل» آخر النهار قبل الغروب. صُمّمت الهوية كاملة في Figma أولًا، ثم اشتُقّت ألوان الثيم ومقاساته منها آليًا.

المعيار: ملاحظة عربية طويلة مشكولة، فيها سطر إنجليزي وكتلة شيفرة وجدول وقصيدة عمودية. ينبغي أن يظهر ذلك كله في موضعه الصحيح، ومريحًا للعين، في الوضعين، وتحت الواجهة العربية والإنجليزية.

المعاينة

لقطات حقيقية من Obsidian 1.15.0 بواجهة عربية.

غَسَق · قراءة	أصيل · قراءة
غَسَق · Live Preview	أصيل · قصيدة عمودية
ملاحظة مختلطة الاتجاه	لوحة الأوامر

المزايا

الطباعة العربية

• المتن بخط Noto Naskh Arabic مضمَّنًا، بوزنين حقيقيين 400 و700، وارتفاع سطر 1.9 حتى لا يتصادم التشكيل.
• العناوين والواجهة بخط Cairo مضمَّنًا، فتتّحد الواجهة على كل الأنظمة.
• الخط العربي مقصور على الحروف العربية (unicode-range)، فتأخذ الكلمات اللاتينية خطًّا لاتينيًا من النظام، بمائل حقيقي.
• لا ميل اصطناعي للعربية: التوكيد بلون خفيف بدل الميل.
• لا تباعد حروف: صفر في كل نص قد يكون عربيًا.
• لا قصّ للتشكيل: في التبويبات والمستكشف والمخطط والعناوين.
• الحجم البصري بين العربي واللاتيني موزون بـ size-adjust، دون المساس بحجم الخط الذي تختاره.

الاتجاه والنص المختلط

• يبني على دعم Obsidian الأصلي لـ RTL ولا يحاربه، ويكمل ما ينقصه:
  • كتل الشيفرة والرياضيات وMermaid LTR دائمًا.
  • الشيفرة المضمّنة معزولة داخل السطر العربي.
  • اختصارات المفاتيح لا تنقلب.
  • سهم الـ callout المطويّ يشير إلى جهة نهاية السطر.
• حدّ الاقتباس، وأيقونة الـ callout، والنقاط، والمهام، والأرقام، والجداول، والحواشي، وأسهم الطيّ، وأرقام الأسطر، ولوحة الخصائص: كلها في جهتها في الاتجاهين.

الألوان

• سلّم --color-base كامل لكل وضع، وألوان الشيفرة والـ callouts وCanvas والرسم البياني من عائلة واحدة.
• التباين مفحوص آليًا وفق WCAG في كل بناء: النص الأساسي 11:1 فأكثر، والثانوي والتمييز والوسوم 4.5:1 فأكثر.
• إن اخترت لون تمييز من إعدادات Obsidian فاختيارك يتقدّم، والكهرماني افتراضي فقط.

التثبيت

من متجر الثيمات

غسق مدرج في دليل ثيمات Obsidian، فاضغط «Add to Obsidian» من صفحته، أو من داخل التطبيق:

1. افتح الإعدادات ← المظهر ← السمات ← إدارة.
2. ابحث عن Ghasaq.
3. اضغط تثبيت واستخدام.

يدويًا

1. نزّل manifest.json وtheme.css من آخر إصدار.
2. ضعهما في .obsidian/themes/Ghasaq/ داخل خزينتك.
3. اختر Ghasaq من الإعدادات ← المظهر.

يحتاج Obsidian 1.14.4 فأحدث. اختُبر على 1.14.4 و1.15.0 على macOS.

الإعدادات

الثيم يعمل كاملًا بدون إضافة Style Settings. إن ثبّتّها ظهرت الخيارات التالية بعناوين عربية:

القصيدة العمودية

أضف الصنف qasida إلى خصائص الملاحظة، واكتب الأبيات جدولًا من عمودين: الصدر في العمود الأول، والعجز في الثاني. اترك صف الترويسة فارغًا، فهو صف يفرضه Markdown والثيم يخفيه.

---
cssclasses:
  - qasida
---

| | |
| --- | --- |
| الخَيْلُ وَاللَّيْلُ وَالبَيْدَاءُ تَعْرِفُنِي | وَالسَّيْفُ وَالرُّمْحُ وَالقِرْطَاسُ وَالقَلَمُ |
| أَنَا الَّذِي نَظَرَ الأَعْمَى إِلَى أَدَبِي | وَأَسْمَعَتْ كَلِمَاتِي مَنْ بِهِ صَمَمُ |

النتيجة:

• الصدر في جهة البداية والعجز بعده، بعرضين متساويين، وبينهما فراغ واضح.
• بلا حدود ولا ترويسة.
• يعمل في وضع القراءة وفي Live Preview، ويتحمّل التشكيل التام، ويبقى RTL حتى تحت واجهة إنجليزية.

الملاحظة تبقى Markdown عاديًا. إن غيّرت الثيم يومًا ظهرت الأبيات جدولًا مقروءًا.

الخطوط

الخطّان مضمَّنان في theme.css بصيغة woff2 مجزّأة، فلا طلبات شبكة. الكلمات اللاتينية في المتن تأخذ خط النظام (Iowan Old Style ← Charter ← Georgia)، والشيفرة خط mono النظام.

قيود معروفة

• حقل التاريخ في الخصائص: يعرض حروف «يوم/شهر/سنة» معكوسة تحت الواجهة العربية. هذا عيب في Obsidian/Chromium يظهر في الثيم الافتراضي أيضًا.
• الصورة المنفردة في سطرها: تأخذ اتجاه LTR، لأن السطر بلا حرف قوي فيأخذ dir=auto اتجاه LTR، وهذا سلوك Obsidian.
• الجوال وWindows وLinux: لم تُختبر على أجهزة حقيقية بعد.

المشكلات والاقتراحات

• وجدت خللًا؟ افتح بلاغًا وأرفق لقطة شاشة، واذكر نسخة Obsidian والجهاز ولغة الواجهة.
• عندك فكرة؟ افتح اقتراحًا وصِف ما تريد.

التطوير

• الهوية في Figma هي مصدر الحقيقة: الألوان والمقاسات والطباعة تُعدَّل هناك. ثم يُشغَّل scripts/figma/export-variables.js عبر Figma MCP، ويُحفظ ناتجه في tokens/figma.json.

• المتطلبات: Python 3 (جُرّب على 3.9) ومعه fontTools وbrotli، وPyYAML لفحص كتلة Style Settings:

  python3 -m pip install fonttools brotli pyyaml
  

• أمر البناء الواحد:

  python3 scripts/build.py
  

  يولّد src/tokens.css وsrc/fonts.css، ويجمع src/ في theme.css، فلا تحرّر هذه الملفات الثلاثة يدويًا. ويُفشل البناء إن نزل التباين، أو ظهرت خاصية فيزيائية خارج مناطق LTR الموثّقة، أو !important، أو رابط خارجي، أو تجاوز الحجم 700KB، أو فسد manifest.json أو كتلة Style Settings.

• سكربتات الاختبار (على macOS، وتفترض Obsidian في /Applications وNode في /opt/homebrew/bin/node):

  • scripts/obsidian-test.sh: يشغّل نسخة Obsidian معزولة على test-vault/. إضافة Style Settings لا تُرفع مع المستودع؛ ثبّتها في الخزينة من المتجر، أو انسخها إلى test-vault/.obsidian/plugins/obsidian-style-settings/.
  • scripts/cli-check.sh: يتحقق عبر Obsidian CLI من القيم المحسوبة لأهم القواعد في الوضعين.
  • scripts/shoot-matrix.sh ar|en: يلتقط مصفوفة اللقطات في screenshots/matrix/ وscreenshots/ui/. لا يتتبّع Git منها إلا ما يعرضه README، فأضف غيرها بـ git add -f إن احتجت إليه.

• الإصدار: ارفع version في manifest.json، وأضف قسمًا إلى CHANGELOG.md، واكتب ملاحظات الإصدار في release-notes/<الرقم>.md، ثم ادفع وسمًا بالرقم نفسه، فينشئ GitHub Actions مسودّة إصدار مرفقًا بها manifest.json وtheme.css.

شكر

• Noto Naskh Arabic من مؤلفي مشروع Noto.
• Cairo من مؤلفي مشروع Cairo.
• إضافة Style Settings التي جعلت الإعدادات ممكنة.
• فريق Obsidian على دعم الواجهة من اليمين إلى اليسار.

الرخصة

كود الثيم برخصة MIT. الخطوط المضمَّنة برخصة SIL Open Font License 1.1، وحقوقها ونصّ رخصتها في fonts/NOTICE.md.

_{تصميم وتطوير: سلطان العنزي — Sultan Al-Anazi · bysltan.com}