Skip to content

أنشأ كتابًا أو مدونةً تعليمية من ملفّات Markdown باللغة العربية | Create An Arabic book or a tutorial blog from Markdown files with ease

License

Notifications You must be signed in to change notification settings

yassinya/mujallad

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

مقدّمة

إذا حاولت من قبل البحث عن طريقة لجعل Gitbook يدعم العربية ولم تجد، أو إذا ما كنت قد بحثت عن أي سكربت محتوى بسيط يدعم اللغة العربية ليقرأ ملفّات Markdown ويعرضها على شكل كتاب ولم تجد كذلك، فحينها ستسرّ عندما تتعرف إلى سكربت مجلّد.

سكربت مجلّد هو تطبيق ويب مكتوب ببايثون وإطار العمل فلاسك. يقوم ببساطة بقراءة مجموعة ملفّات بصيغة Markdown من مجلدٍ ما ثم يقوم تلقائيًا بعرضها بهذا الشكل الذي تراه حاليًا، على شكل كتاب.

بسبب ذلك له العديد من المميزات:

  • لا حاجة لتثبيته، فهو لا يستعمل قاعدة بيانات ولا يوجد بيانات دخول، بل يقرأ من الملفّات النصية لماركداون مباشرةً.
  • السكربت يقرأ ملفات الماركداون عند كل طلب ويحوّلها إلى HTML.
  • سهل الاستخدام جدًا ولا يتطلب أي تعلّم، فقط حمّل وابدأ الكتابة.
  • بما أنّ الوثائق/الكتب/الشروحات التي ستكتبها ستكون بصيغة .md فحينها يمكنك نسخها وعمل نسخة احتياطية منها بسهولة عبر سكربت بسيط أو أي طريقة أخرى تحبّها أنت.
  • يمكنك استضافة تلك الملفّات على GitHub إن أردت ذلك، وهكذا يمكنك أن تتعاون مع فريق للعمل على الكتاب أو الشروحات أو المحتوى الذي تريده بسهولة.
  • تصميم جذاب وبسيط مناسب للكتب أو المدونات التعليمية أو أي منصة شروحات وتدريب. يدعم شاشات الموبايل الصغيرة (تصميم تجاوبي).
  • مبدأ حياة Keep it simple, stupid.

يمكنك استخدام السكربت لأي شيء تقريبًا، فهو يدعم الصور مثلًا:

alt text

وكذلك الأكواد:

sudo apt install firefox

وكذلك الجداول:

الجداول شيءٌ جميل
العمود 3 نصٌ ما هنا $1600
العمود 2 بالوسط $12
السطر الأخير نصٌ آخر هنا. $1

والاقتباسات:

لا تعجبي يا سلمُ من رجلٍ ... ضحكَ المشيبُ برأسه فبكى.
قد كان يضحك في شيبته ... وأتى المشيبُ فقلَّما ضحكا.

الدافع

الدافع الأساسي هو أنني كنت أرغب بكتابة كتاب على السريع، ولم أرغب باستعمال برامج التحرير مثل LibreOffice وغيرها، كما لم أرغب بتثبيت أي سكربت محتوى معقّد ويتطلب إضافات أو ما شابه. الحل الأمثل أمامي كان استخدام Gitbook، ولكن للأسف خدمة Gitbook لا تدعم العربية ولا الاتجاه من اليمين إلى اليسار (RTL) (باستثناء إذا ما كنت على الخطة المدفوعة، حينها يمكنك حقن أكواد CSS الخاصّة بك).

ولم أجد للأسف أي خدمة تستعمل Markdown تدعم اللغة العربية، فقررت ببساطة إنشاء واحدة بنفسي.

من أنا؟

محمد هاني صبّاغ، مهندس حاسوب من سوريا - حلب. مطور برمجيات مفتوحة المصدر ومستخدم لينكس منذ 10 سنوات. قد تعرفني من بعض مشاريعي العربية كـلينكس اليوم أو هلال لينكس.

للمزيد عنّي راجع موقعي الشخصي على mhsabbagh.com.

الدعم

يمكنك عزيمتي على فنجان قهوة عبر الرابط التالي من بايبال: https://paypal.me/mhsabbaghpay

بخصوص تطوير السكربت، أنصحك أن تفتح نقاشًا على صفحة الـissues على GitHub قبل أن تبدأ العمل على أي ميزة أو اقتراح من طرفك لأنني لا أرغب بتوسيع السكربت كثيرًا.

About

أنشأ كتابًا أو مدونةً تعليمية من ملفّات Markdown باللغة العربية | Create An Arabic book or a tutorial blog from Markdown files with ease

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 45.4%
  • CSS 32.8%
  • Python 21.8%