RTL Markdown Reader — قارئ ماركداون عربي

إضافة لـ VS Code تعرض ملفات Markdown بالكامل من اليمين إلى اليسار، مع دعم كل خصائص Markdown — وعلى رأسها الجداول.

المميزات

معالجة ذكية للاتجاه

• كل خلية جدول وكل فقرة تحصل على dir="auto" — فالنص الإنجليزي داخل جدول عربي يبقى LTR، وعلامات الترقيم لا تقفز إلى الجهة الخاطئة.
• كتل الكود والمعادلات تبقى LTR دائماً مع unicode-bidi: isolate.
• المحاذاة الصريحة في المصدر (|:---:|) لها الأولوية على الاتجاه العام.

التثبيت

نزّل أحدث ملف rtl-md-reader.vsix من صفحة Releases، ثم من داخل VS Code:

Ctrl+Shift+X ← قائمة ... ← Install from VSIX… ← اختر الملف ← أعد تشغيل VS Code.

الملف مكتفٍ ذاتياً (١٫٨ ميجابايت) — لا يحتاج إنترنت ولا Node.js على الجهاز الهدف، ويعمل على Windows و macOS و Linux. للتفاصيل الكاملة: INSTALL.md.

البناء من المصدر

npm install
npm run compile
npx @vscode/vsce package -o rtl-md-reader.vsix

للنشر على متجر VS Code: PUBLISHING.md.

الاستخدام

فتح المعاينة

جعلها الافتراضية

المقصود بـ "الافتراضي": عادةً عند النقر المزدوج على ملف .md يفتحه VS Code في محرر النص. بعد التفعيل، سيفتحه مباشرةً في قارئ RTL بدل ذلك.

الخطوات:

1. افتح أي ملف .md (مثل sample/نموذج.md المرفق).
2. اضغط Ctrl+Alt+R. أو من لوحة الأوامر Ctrl+Shift+P ← اكتب RTL Markdown ← اختر جعلها المعاينة الافتراضية لملفات MD.
3. ستظهر نافذة تأكيد تشرح ما سيحدث ← اضغط تفعيل.
4. سيُعاد فتح الملف الحالي في القارئ فوراً لترى النتيجة.

كيف أرجع للتحرير بعد التفعيل؟

• زر ✎ تحرير في شريط الأدوات أعلى القارئ، أو
• كليك يمين على الملف في المستكشف ← Open With… ← Text Editor.

للتراجع نهائياً: لوحة الأوامر ← RTL Markdown: إلغاء جعلها الافتراضية. (أو اضغط Ctrl+Alt+R مرة أخرى — سينبّهك أنها مفعّلة ويعرض زر الإلغاء.)

ماذا يتغيّر تقنياً؟ يضيف الأمر هذا إلى إعداداتك:

"workbench.editorAssociations": {
  "*.md": "rtlMd.reader",
  "*.markdown": "rtlMd.reader"
}

للتحرير بعد جعلها افتراضية: اضغط زر ✎ تحرير في شريط الأدوات، أو كليك يمين على الملف ← Open With… ← Text Editor.

للتراجع: RTL Markdown: إلغاء جعلها الافتراضية.

المعاينة المدمجة في VS Code

الإضافة تجعل معاينة Markdown المدمجة في VS Code تعمل بالاتجاه RTL أيضاً — تلقائياً ودون أي إعداد. لتعطيل ذلك:

"rtlMd.applyToBuiltinPreview": false

الإعدادات

مثال — وضع الكشف التلقائي (ملفات عربية RTL وإنجليزية LTR):

{
  "rtlMd.direction": "auto",
  "rtlMd.fontSize": 17,
  "rtlMd.fontFamily": "'Dubai', 'Segoe UI'"
}

شريط الأدوات

ملف تجريبي

sample/نموذج.md يحتوي على أمثلة لكل الخصائص المدعومة — افتحه للتأكد من أن كل شيء يعمل.

التطوير

npm install      # تثبيت التبعيات
npm run compile  # بناء TypeScript
npm run package  # إنتاج ملف VSIX

للتجربة أثناء التطوير: افتح المجلد في VS Code واضغط F5.

البنية

الترخيص

MIT