Giter VIP home page Giter VIP logo

zakaria-chahboun / mujallad Goto Github PK

View Code? Open in Web Editor NEW

This project forked from mhsabbagh/mujallad

1.0 1.0 0.0 301 KB

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

Home Page: https://mujallad.mhsabbagh.com/

License: GNU General Public License v2.0

Python 28.09% CSS 36.42% HTML 35.49%

mujallad's Introduction

مقدّمة

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

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

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

  • لا حاجة لتثبيته، فهو لا يستعمل قاعدة بيانات ولا يوجد بيانات دخول، بل يقرأ من الملفّات النصية لماركداون مباشرةً.
  • يقرأ ملفّات الماركداون مرةً واحدة ويحفظها في الذاكرة على صيغة HTML ليعرضها عند الطلب. هذا يقلل عمليات الـI/O المطلوبة.
  • سهل الاستخدام جدًا ولا يتطلب أي تعلّم، فقط حمّل وابدأ الكتابة.
  • بما أنّ الوثائق/الكتب/الشروحات التي ستكتبها ستكون بصيغة .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 قبل أن تبدأ العمل على أي ميزة أو اقتراح من طرفك لأنني لا أرغب بتوسيع السكربت كثيرًا.

mujallad's People

Contributors

mhsabbagh avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.