رابط الموقع https://adwat.bitcoinarabic.org
كل محتوى الموقع تجدونه هنا على Github بشكل حُر مجاني ومفتوح المصدر، بإمكان اي شخص استعمال المواد المعروضة هنا، التعديل عليها وتقديم مواده الخاصة لدمجها في الموقع بشكل حُر ومفتوح للجميع.
هذا الموقع يستعمل VuePress لبناء محتوى الموقع من ملفات نصية محفوظة بنهاية md (markdown) لبناء موقع كامل.
- المحتوى النصي على شكل ملفات md تجدونهم في المجلد docs
- الصور تجدونها داخل مجلدات مختلفه هنا: /docs/.vuepress/public/images
هنالك طريقتين للمساهمة والتعديل على محتوى الموقع:
لتعديلات بسيطة: مثل تصحيح خطأ إملائي، تدقيق لغوي، تصحيح رابط لا يعمل وهكذا...
- قم بإنشاء حساب على Github اذا لم يكن لديك حساب مسبقا.
- إذهب للمقالة التي ترغب بالتعديل عليها في موقع أدوات بيتكوين بالعربي في نهاية كل المقالة ستجد رابط "ساعدنا في تحسين هذا المحتوى" عند الضغط عليه، سيأخدك لملف المقالة في Github (بعد تسجيل الدخول بواسطة حسابك).
- قم بالضغط على صورة القلم ✏️ في الزاوية اليمنى من الأعلى في Github.
- قم بالتعديل على محتوي النص. بإمكانك استخدام رموز Markdown.
- وفي النهاية عند Propose changes اكتب في الخانة العليا عنوان يصف ما قمت به وفي الخانة تحتها شرح وافي لجميع التغييرات. ثم إضغط على زر
Propose changes
.
لتغيرات وتعديلات كبيرة: مثل إضافة مقالة، قسم جديد، أو شرح كامل على محتوى الموقع
بامكانك بناء الموقع محليا على حاسوبك الشخصي، إضافة محتواك وطلب دمجه في الموقع الرئيسي، عبر اتباع الخطوات التالية:
- قم بإنشاء حساب على Github اذا لم يكن لديك حساب هناك.
- تحميل وتنصيب هذة البرامج:
-
- بعد تنصيب البرنامج سيتم اضافة 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>
- بعد تنصيب البرنامج سيتم اضافة cmd جديد قم بالبحث عنه
-
- عن طريق كتابة الكود التالية في نافذة ال cmd التي فتحناها اعلاه:
npm install --global yarn
- عن طريق كتابة الكود التالية في نافذة ال cmd التي فتحناها اعلاه:
-
- نقوم بتحميل الموقع من GitHub
- نقوم بالدخول الى رابط الموقع في GitHub
- نضغط على زر
Code
باللون الاخضر من اليمين في الاعلى - ثم على
Open with GitHub Desktop
- في النافذة التي ستظهر لك قم باختيار
Open GitHubDesktop.exe
- انتبه في أي مجلد سيتم حفظ الملفات.
- المسار الافتراضي سيكون:
C:\Users\YOUR_PC_USERNAME\Documents\GitHub\adwat_bitcoin
- سيكون
YOUR_PC_USERNAME
اسم المستخدم لحاسوبك
- المسار الافتراضي سيكون:
- ثم قم بالضغط على
Clone
- سنقوم بالعودة
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/
-
شرح لكيفية المساهمة في محتوى الموقع