This is a skelton for mkdocs Arabic project which is RTL language uses mkdocs-material theme. you have to use mkdocs with material to generate the docs.
To generate the docs run the command mkdocs build , then the docs will be in public folder , copy public folder where you want. and the documentation website will look like:
Happy Extendying!
هذا مجرد مثال على موقع مستندات توثيق باللغة العربية يمكن توليده من خلال MkDocs يستخدم قالب mkdocs-material. يمكن استخدام هيكلية الملفات لبدء مشروع توثيق جديد ، ولا تنسى استبدال المحتويات هذة الصفحة بالمحتوى المناسب لك.
لإنشاء الوثائق، قم بتشغيل الأمر mkdocs build، ثم ستكون الوثائق في مجلد public. قم بنسخ مجلد public إلى الموقع الذي ترغب فيه. وموقع التوثيق سوف يكون شبيها بالموقع التالي:
لمشاهدة معاينه حية للمستندات من هذا المستودع راجع الرابط التالي انقر هنا
تكمن القوة في انشاء مواقع المستندات بهذة الطريقة قي تمكين المطورين من انشاء مستندات التوثيق (باللغة العربية) بشكل متلازم اثناء البرمجة وارفاق مستندات التوثيق ايضا مع الملفات البرمجة ضمن مستودع git مع الاحتفاظ بالكود الاصلي للمستندات ضمن ملفات المستودع. بل ويمكن لهم نشر المستتدات بشكل تلقائي من خلال اوامر deploy
يمكنك اخذ نسخه من هذا المستودع (كقالب) والبدء بمستودع جديد خاص بك ومن ثم البدء بمشروعك المستقل لانشاء مستندات التوثيق التي تريد.
من الصفحة الرئيسية للمستودع https://github.com/Extendy/mkdocs-arabic-skelton اختر Use this template الموجوده في اعلى صفحة المستودع على الجهة اليمنى واختر Create a new repository ومن ثم املئ النموذج الخاص بانشاء مستودع جديد كيفما تريد.
راجع الصورة التاليه:
بعدها يمكنك العمل على مستودعك الخاص كيفما يحلو لك حيث انه سوف يكون منفصل تماما عن هذا المستودع.
في حال كان لديك مشروع برمجي جاهز وتود استخدام المستندات بداخله وبالتالي لا تود عمل git clone لهذا المستودع ، فبامكانك فقط نقل الملف mkdocs.yaml بداخل مشروعك في المجلد الذي تحب والبدء باستخدام mkdocs كيفما تحب حيث ان هذا الملف هو ما تحتاجة بالفعل للبدء (مع بعض التحرير لتحديد المجلد المصدر والهدف).
هذا القالب يتطلب توفر دعم ل MkDocs على جهازك وهذا بدورة يتطلب توفر لغة دعم python و دعم ل pip على جهازك، للمزيد راجع https://www.mkdocs.org/user-guide/installation
(ان شرط توفر mkdocs هو من اجل تنفيذ امر mkdocs build الذي يقوم بتحويل ملفات .md المكتوبة بصيغة markdown الموجوده بداخل مجلد docs الى ملفات html ووضعها في المجلد public، وبالتالي في حال عدم تمكنك من تركيب mkdocs يمكنك الاستمرار في كتابه المستندات بالطريقه الاعتياديه ولكن لعمل build للمستندات لتكون ملفات html فانك سوف تحتاج mkdocs لهذا يمكن نقلها لجهاز متوافق وعمل build).
في حال كانت لغة python و pip موجودة على جهازك فانه يمكن تنصيب mkdocs من خلال الاوامر التالية:
pip install mkdocsولاستخدام قالب material هذا المستخدم في هذا الموقع كقالب للمستندات من خلال Mkdocs فانه يجب عليك ايضا تركيب القالب ولمعرفة كيفية القيام بذلك راجع الرابط التالي https://squidfunk.github.io/mkdocs-material/getting-started
حيث يتم تركيب material في حال انه لم يكن منصبا بوقت سابق وذلك باستخدام الامر
pip install mkdocs-materialبعدها يمكنك انشاء المستندات وتوليدها عن طريق mkdocs build وبعد نجاح تحويل الملفات الى html يمكنك رفع المجلد public الذي يتم توليده الى اي مكان فهو يعمل كملفات html ثابتة دون الحاجة لان يدعم الويب سيرفر لاي لغة برمج، فالموقع هو عبارة عن ملفات html، كما ويمكنك ايضا تغيير اسم المجلد public الى اي اسم ترغب به.
اي تعديل تقوم به علي ملفات .md الموجودة بداخل المجلد docs يتطلب منك تنفيذ الامر mkdocs build ليتم اعادة انشاء ملفات html مجددا . تذكر هذا 🥳
يجب كتابه ملفات التوثيق بتنسيق markdown وعند تنفيذ امر mkdocs build فانه سوف يتم تحويلها الى html ولمعرفة المزيد عن هذا الامر راجع الرابط
https://www.mkdocs.org/user-guide/writing-your-docs
اذا كنت بحاجة لتعلم طريقة الكتابة بواسطة markdown راجع الرابط التالي https://daringfireball.net/projects/markdown/syntax
Happy Extendying,
Extendy Team.