mustafaalahmid / adwat_bitcoin

موقع أدوات بيتكوين بالعربي

رابط الموقع https://adwat.bitcoinarabic.org

كل محتوى الموقع تجدونه هنا على Github بشكل حُر مجاني ومفتوح المصدر، بإمكان اي شخص استعمال المواد المعروضة هنا، التعديل عليها وتقديم مواده الخاصة لدمجها في الموقع بشكل حُر ومفتوح للجميع.

هذا الموقع يستعمل VuePress لبناء محتوى الموقع من ملفات نصية محفوظة بنهاية md (markdown) لبناء موقع كامل.

• المحتوى النصي على شكل ملفات md تجدونهم في المجلد docs
• الصور تجدونها داخل مجلدات مختلفه هنا: /docs/.vuepress/public/images

للمساهمة والتعديل على محتوى الموقع

هنالك طريقتين للمساهمة والتعديل على محتوى الموقع:

✅ لتعديلات بسيطة بواسطة Github هنا

لتعديلات بسيطة: مثل تصحيح خطأ إملائي، تدقيق لغوي، تصحيح رابط لا يعمل وهكذا...

1. قم بإنشاء حساب على Github اذا لم يكن لديك حساب مسبقا.
2. إذهب للمقالة التي ترغب بالتعديل عليها في موقع أدوات بيتكوين بالعربي في نهاية كل المقالة ستجد رابط "ساعدنا في تحسين هذا المحتوى" عند الضغط عليه، سيأخدك لملف المقالة في Github (بعد تسجيل الدخول بواسطة حسابك).
3. قم بالضغط على صورة القلم ✏️ في الزاوية اليمنى من الأعلى في Github.
4. قم بالتعديل على محتوي النص. بإمكانك استخدام رموز Markdown.
5. وفي النهاية عند Propose changes اكتب في الخانة العليا عنوان يصف ما قمت به وفي الخانة تحتها شرح وافي لجميع التغييرات. ثم إضغط على زر Propose changes.

✅ لتعديلات كبيرة عن طريق بناء الموقع على حاسوبك الشخصي، إضافة محتواك وطلب دمجه

لتغيرات وتعديلات كبيرة: مثل إضافة مقالة، قسم جديد، أو شرح كامل على محتوى الموقع

بامكانك بناء الموقع محليا على حاسوبك الشخصي، إضافة محتواك وطلب دمجه في الموقع الرئيسي، عبر اتباع الخطوات التالية:

1. قم بإنشاء حساب على Github اذا لم يكن لديك حساب هناك.
2. تحميل وتنصيب هذة البرامج:

   • تحميل وتنصيب برنامج NodeJS

     • بعد تنصيب البرنامج سيتم اضافة cmd جديد قم بالبحث عنه Node.js command prompt وافتحه.
     • ستظهر شاشة سوداء مثل هذة:

        Your environment has been set up for using Node.js 16.13.2 (x64) and npm.
        C:\Users\YOUR_PC_USERNAME>

   • تنصيب إضافة Yarn

     • عن طريق كتابة الكود التالية في نافذة ال cmd التي فتحناها اعلاه:
       • npm install --global yarn

   • تحميل وتنصيب برنامج GitHub Desktop

   • تحميل وتنصيب برنامج تحرير نصوص Notepad++

3. نقوم بتحميل الموقع من GitHub
   • نقوم بالدخول الى رابط الموقع في GitHub
   • نضغط على زر Code باللون الاخضر من اليمين في الاعلى
   • ثم على Open with GitHub Desktop
   • في النافذة التي ستظهر لك قم باختيار Open GitHubDesktop.exe
   • انتبه في أي مجلد سيتم حفظ الملفات.
     • المسار الافتراضي سيكون: C:\Users\YOUR_PC_USERNAME\Documents\GitHub\adwat_bitcoin
     • سيكون YOUR_PC_USERNAME اسم المستخدم لحاسوبك
   • ثم قم بالضغط على Clone
4. سنقوم بالعودة Node.js command prompt الى الشاشة السوداء

   Your environment has been set up for using Node.js 16.15.0 (x64) and npm.
   C:\Users\YOUR_PC_USERNAME>

   • سنقوم بتغيير المسار الى المسار الذي يحتوي على ملفات الموقع داخل مجلد docs هكذا:

      cd C:\Users\YOUR_PC_USERNAME\Documents\GitHub\adwat_bitcoin\docs

     • قم بتغيير YOUR_PC_USERNAME لاسم المستخدم الخاص بحاسوبك

   • سنقوم ببناء الموديوز المطلوبة للموقع عبر ادخال الكود التالي:

      yarn install

   • لتشغيل الموقع

      yarn dev

     • ستظهر لك هذة الرسالة:

      > VuePress dev server listening at http://localhost:8080/

   • لمشاهدة الموقع يرجى الدخول من المتصفح الى العنوان التالي: http://localhost:8080/

شرح لكيفية المساهمة في محتوى الموقع