mhsabbagh / Mujallad
Labels
مقدّمة
إذا حاولت من قبل البحث عن طريقة لجعل Gitbook يدعم العربية ولم تجد، أو إذا ما كنت قد بحثت عن أي سكربت محتوى بسيط يدعم اللغة العربية ليقرأ ملفّات Markdown ويعرضها على شكل كتاب ولم تجد كذلك، فحينها ستسرّ عندما تتعرف إلى سكربت مجلّد.
سكربت مجلّد هو تطبيق ويب مكتوب ببايثون وإطار العمل فلاسك. يقوم ببساطة بقراءة مجموعة ملفّات بصيغة Markdown من مجلدٍ ما ثم يقوم تلقائيًا بعرضها بهذا الشكل الذي تراه حاليًا، على شكل كتاب.
بسبب ذلك له العديد من المميزات:
- لا حاجة لتثبيته، فهو لا يستعمل قاعدة بيانات ولا يوجد بيانات دخول، بل يقرأ من الملفّات النصية لماركداون مباشرةً.
- السكربت يقرأ ملفات الماركداون عند كل طلب ويحوّلها إلى HTML.
- سهل الاستخدام جدًا ولا يتطلب أي تعلّم، فقط حمّل وابدأ الكتابة.
- بما أنّ الوثائق/الكتب/الشروحات التي ستكتبها ستكون بصيغة .md فحينها يمكنك نسخها وعمل نسخة احتياطية منها بسهولة عبر سكربت بسيط أو أي طريقة أخرى تحبّها أنت.
- يمكنك استضافة تلك الملفّات على GitHub إن أردت ذلك، وهكذا يمكنك أن تتعاون مع فريق للعمل على الكتاب أو الشروحات أو المحتوى الذي تريده بسهولة.
- تصميم جذاب وبسيط مناسب للكتب أو المدونات التعليمية أو أي منصة شروحات وتدريب. يدعم شاشات الموبايل الصغيرة (تصميم تجاوبي).
- مبدأ حياة Keep it simple, stupid.
يمكنك استخدام السكربت لأي شيء تقريبًا، فهو يدعم الصور مثلًا:
وكذلك الأكواد:
sudo apt install firefox
وكذلك الجداول:
| الجداول | شيءٌ | جميل |
|---|---|---|
| العمود 3 | نصٌ ما هنا | $1600 |
| العمود 2 | بالوسط | $12 |
| السطر الأخير | نصٌ آخر هنا. | $1 |
والاقتباسات:
لا تعجبي يا سلمُ من رجلٍ ... ضحكَ المشيبُ برأسه فبكى.
قد كان يضحك في شيبته ... وأتى المشيبُ فقلَّما ضحكا.
الدافع
الدافع الأساسي هو أنني كنت أرغب بكتابة كتاب على السريع، ولم أرغب باستعمال برامج التحرير مثل LibreOffice وغيرها، كما لم أرغب بتثبيت أي سكربت محتوى معقّد ويتطلب إضافات أو ما شابه. الحل الأمثل أمامي كان استخدام Gitbook، ولكن للأسف خدمة Gitbook لا تدعم العربية ولا الاتجاه من اليمين إلى اليسار (RTL) (باستثناء إذا ما كنت على الخطة المدفوعة، حينها يمكنك حقن أكواد CSS الخاصّة بك).
ولم أجد للأسف أي خدمة تستعمل Markdown تدعم اللغة العربية، فقررت ببساطة إنشاء واحدة بنفسي.
من أنا؟
محمد هاني صبّاغ، مهندس حاسوب من سوريا - حلب. مطور برمجيات مفتوحة المصدر ومستخدم لينكس منذ 10 سنوات. قد تعرفني من بعض مشاريعي العربية كـلينكس اليوم أو هلال لينكس.
للمزيد عنّي راجع موقعي الشخصي على mhsabbagh.com.
الدعم
يمكنك عزيمتي على فنجان قهوة عبر الرابط التالي من بايبال: https://paypal.me/mhsabbaghpay
بخصوص تطوير السكربت، أنصحك أن تفتح نقاشًا على صفحة الـissues على GitHub قبل أن تبدأ العمل على أي ميزة أو اقتراح من طرفك لأنني لا أرغب بتوسيع السكربت كثيرًا.