A development workspace with notes for an open-source contribution, editorial illustration
الدليل العملي

تعديل المشاريع مفتوحة المصدر

دليل المبتدئ للمساهمة في المشاريع مفتوحة المصدر.

ابدأ القراءة
8 دقائق للقراءة16 صورالعربيةالصفحة الأصلية
وضع القراءة

يتضمن هذا الشرح المصور برامج وأجهزة قديمة. تشرح اللقطات سير العمل، لكن أسماء القوائم والأسعار والمتطلبات وتوافر الخدمات قد تختلف. راجع وثائق المشروع المرتبطة بالإصدار الذي تشغله.

رسم توضيحي لتعديل المشاريع مفتوحة المصدر

كيفية إنشاء نسخة متفرعة من مشروع مفتوح المصدر

قد يبدو الدخول إلى عالم البرمجيات مفتوحة المصدر قفزة في الماء العميق إذا كنت جديدًا عليه. لكن لا تقلق، سنساعدك! يشرح هذا الدليل كل جزء من العملية. وسنستخدم Bitcoiner.Guide ساحةً للتجربة، لنرشدك إلى كتابة مقال واقتراح تغييرات لإضافتها إلى المشروع الأساسي.

الخطوة 1: إنشاء حساب GitHub وتثبيت الأدوات اللازمة

الخطوات اللازمة

لنتأكد من تثبيت كل الأدوات اللازمة على حاسوبك.

  1. حساب GitHub: تحتاج إلى حساب على GitHub لإنشاء نسخة متفرعة من المشروع وتقديم تغييراتك. إن لم يكن لديك حساب، فأنشئه على GitHub.

  2. Git: نظام لإدارة الإصدارات يتيح للمطورين تتبع تغييرات الشيفرة وإدارتها. وهو ضروري للعمل مع GitHub. يأتي Git مثبتًا مسبقًا على أجهزة كثيرة. للتحقق، افتح الطرفية واكتب git -v. إذا كان مثبتًا، فسيظهر رقم الإصدار. وإن لم يكن، فراجع هذا الدليل.

  3. Visual Studio Code: محرر نصوص متعدد الاستخدامات، يتضمن ميزات تسهّل العمل مع Git. نزّله هنا.

  4. للشيفرة التاريخية المبنية على Jekyll، ثبّت بيئة Ruby مدعومة وBundler قبل تثبيت اعتماديات المستودع. على macOS، استخدم Ruby منفصلًا يديره chruby أو rbenv أو asdf أو مدير إصدارات مدعوم آخر؛ ولا تعتمد على Ruby المرفق بنظام Apple. تحقق باستخدام ruby -v، ثم ثبّت حزم gems المطلوبة في تلك البيئة دون استخدام sudo بصورة روتينية. يحتاج مستخدمو Windows إلى RubyInstaller مدعوم وحزمة أدوات تطوير. تصف خطوات Jekyll هذه المستودع الأصلي، لا إعادة التصميم الثابتة 3.0.

معلومات إضافية

تختلف طريقة فتح الطرفية بحسب نظام التشغيل. إليك الطريقة على أنظمة سطح المكتب الثلاثة الأكثر شيوعًا:

  1. Windows:
    • عبر قائمة ابدأ: انقر زر ابدأ أو اضغط مفتاح Windows، واكتب «cmd» أو «Command Prompt» في البحث، ثم اضغط Enter.
    • عبر Run: اضغط Windows+R لفتح نافذة Run، واكتب «cmd» ثم اضغط Enter.
  2. macOS:
    • عبر Spotlight: اضغط Command+Space لفتح بحث Spotlight، واكتب «Terminal»، ثم اضغط Enter.
    • عبر Finder: افتح نافذة Finder، وانتقل إلى Applications -> Utilities، ثم انقر Terminal مرتين.
  3. Linux:
    • عبر شبكة التطبيقات: بحسب توزيعتك وبيئة سطح المكتب، تجد تطبيق الطرفية غالبًا في شبكة التطبيقات أو مشغّلها.
    • عبر اختصار لوحة المفاتيح: في توزيعات كثيرة، يمكنك الضغط على Ctrl+Alt+T لفتح نافذة الطرفية.

في Visual Studio Code، يمكنك فتح الطرفية من القائمة العلوية عبر View -> Terminal، أيًا كان نظام التشغيل.

الخطوة 2: إنشاء نسخة متفرعة من Bitcoiner.Guide

ينشئ التفريع نسخة من المستودع في حساب GitHub الخاص بك، لتتمكن من التعديل دون التأثير في المشروع الأصلي.

  1. انتقل إلى https://github.com/BitcoinQnA/Bitcoiner.Guide.
  2. اضغط زر «Fork» أعلى يمين الصفحة لإنشاء نسخة من المشروع في حسابك.

FIG. 01الخطوة 2: إنشاء نسخة متفرعة من Bitcoiner.Guideرسم توضيحي لتعديل المشاريع مفتوحة المصدر

الخطوة 3: استنساخ المشروع إلى حاسوبك

نحتاج الآن إلى الحصول على نسخة من المشروع على حاسوبك، أي «استنساخه».

  1. انتقل إلى نسختك المتفرعة من المشروع. يفترض أن يكون الرابط https://github.com/YOUR_GITHUB_USERNAME/Bitcoiner.Guide
  2. اضغط زر «Code» الأخضر، ثم رمز الحافظة لنسخ الرابط.

FIG. 02الخطوة 3: استنساخ المشروع إلى حاسوبكرسم توضيحي لتعديل المشاريع مفتوحة المصدر

  1. افتح Visual Studio Code.
  2. اضغط زر «Source Control» في اللوحة اليسرى.
  3. اضغط «Clone Repository».
  4. في النافذة التي تظهر، الصق الرابط الذي نسخته واضغط Enter.

FIG. 03الخطوة 3: استنساخ المشروع إلى حاسوبكرسم توضيحي لتعديل المشاريع مفتوحة المصدر

  1. عندما يُطلب اختيار مجلد، انتقل إلى سطح المكتب واضغط «Select Repository Location».

FIG. 04الخطوة 3: استنساخ المشروع إلى حاسوبكرسم توضيحي لتعديل المشاريع مفتوحة المصدر

الخطوة 4: إنشاء فرع جديد

إنشاء فرع جديد لتغييراتك ممارسة جيدة في المشاريع التعاونية، ومنها المشاريع مفتوحة المصدر. يتيح العمل في فرع مختلف عزل تغييراتك عن الفرع الأساسي للمشروع، الذي يُسمى غالبًا «main» أو «master».

  1. اضغط اسم الفرع أسفل يسار الشاشة؛ يفترض أن يكون master أو main.
  2. في النافذة التي تظهر، اختر Create new branch.
  3. أدخل اسمًا للفرع الجديد، مثل «foundation-devices»، واضغط Enter.

FIG. 05الخطوة 4: إنشاء فرع جديدرسم توضيحي لتعديل المشاريع مفتوحة المصدر

يمكنك العودة إلى الفرع الأساسي في أي وقت بالضغط على اسم الفرع أسفل اليسار واختيار الفرع الأساسي من القائمة.

الخطوة 5: إعداد المشروع محليًا

اقرأ README الحالي وملف قفل الاعتماديات وتعليمات المساهمة قبل تثبيت Ruby أو Bundler. احتفظ بتغييراتك في فرع خاص بالميزة، وشغّل الفحوص المحلية الموثقة للمشروع، ثم قدّم طلب دمج. تصف الأوامر النموذجية أدناه مشروع Jekyll الأصلي؛ وليست تعليمات بناء تجربة التصميم المحلية هذه.

لنشغّل Bitcoiner.Guide على حاسوبك.

  1. افتح الطرفية في Visual Studio Code عبر View -> Terminal.

FIG. 06الخطوة 5: إعداد المشروع محليًارسم توضيحي لتعديل المشاريع مفتوحة المصدر

  1. شغّل bundle install لتثبيت حزم Ruby اللازمة للمشروع.
  2. شغّل bundle exec jekyll serve لبدء خادم محلي.
  3. يمكنك الآن عرض الموقع على http://localhost:4000.

FIG. 07الخطوة 5: إعداد المشروع محليًارسم توضيحي لتعديل المشاريع مفتوحة المصدر

بعد استنساخ مستودع Jekyll التاريخي هذا، شغّل bundle install من المجلد الذي يحتوي Gemfile، ثم bundle exec jekyll serve. فتثبيت برنامج Bundler وحده لا يثبت اعتماديات هذا المستودع. أعد تشغيل bundle install عندما تتغير ملفات الاعتماديات.

الخطوة 6: إجراء التغييرات وتسجيلها في commit

حان وقت تعديل المشروع. سنضيف مقالًا جديدًا بعنوان «Foundation Devices»:

  1. أنشئ ملفًا جديدًا في Visual Studio Code بالتنسيق التالي: foundation-devices.md.

FIG. 08الخطوة 6: إجراء التغييرات وتسجيلها في commitرسم توضيحي لتعديل المشاريع مفتوحة المصدر

  1. أضف البيانات الوصفية التالية أعلى الملف:
---
layout: page
title: Foundation Devices
subtitle: Sovereign computing company
---
  1. ابدأ كتابة المقال أسفل البيانات الوصفية. مثلًا:

Foundation Devices شركة أجهزة تصنع أدوات تتمحور حول البيتكوين، وتساعدك على استعادة سيادتك الرقمية. تهدف إلى بناء شركة أجهزة من نوع مختلف، تركز على المصدر المفتوح والتصنيع المحلي. تبدأ هذه الرحلة بـPassport وEnvoy، لكنهما مجرد البداية!

تستخدم مقالات Bitcoiner.Guide تنسيق Markdown، وهو لغة ترميز خفيفة لإنشاء نصوص منسقة. إذا أردت تعلم جعل النص عريضًا وإنشاء القوائم وغيرها، فإليك دليلًا ممتازًا.

لإدراج صور في مقالك:

  1. أولًا، ارفع الصورة إلى مجلد assets > img في مشروعك.

FIG. 09الخطوة 6: إجراء التغييرات وتسجيلها في commitرسم توضيحي لتعديل المشاريع مفتوحة المصدر

  1. يمكنك بعد ذلك استخدام الصيغة التالية لإدراج الصور:
<p align="center">
  <img src="/assets/img/your-image-file-name.jpg" class="responsive" style="max-width: 100%; height: auto;" />
</p>
  1. استبدل your-image-file-name.jpg باسم ملف صورتك.
  2. احفظ الملف باستخدام CMD+S أو CTRL+S.
  3. عد إلى المتصفح وانتقل إلى http://localhost:4000/foundation-devices

حوّلنا هذا:

---
layout: page
title: Foundation Devices
subtitle: Sovereign computing company
---
Foundation Devices is a hardware company that builds Bitcoin-centric tools that empower you to reclaim your digital sovereignty. They aimed to build a different kind of hardware company with an emphasis on Open Source and local manufacturing. This starts with Passport and Envoy – but they are just getting started!

<p align="center">
  <img src="/assets/img/foundation-devices-images.jpg" class="responsive" style="max-width: 100%; height: auto;" />
</p>

إلى:

FIG. 10الخطوة 6: إجراء التغييرات وتسجيلها في commitرسم توضيحي لتعديل المشاريع مفتوحة المصدر

راجع مقالات .md الأخرى في المشروع لتفهم بصورة أفضل كيفية بنائها. من المهم احترام أسلوب الكتابة الخاص بالمشروع للحفاظ على الاتساق.

الخطوة 7: رفع تغييراتك إلى GitHub

لنحفظ تغييراتك ونرفعها إلى GitHub.

  1. اضغط رمز التحكم في المصدر على يسار Visual Studio Code.
  2. يفترض أن ترى تغييراتك في قسم «Changes». اضغط رمز «+» بجوار ملفاتك لتجهيز التغييرات للـcommit.

FIG. 11الخطوة 7: رفع تغييراتك إلى GitHubرسم توضيحي لتعديل المشاريع مفتوحة المصدر

  1. أدخل رسالة commit في مربع النص بالأعلى، مثل «Added Foundation Devices article»، واضغط Ctrl+Enter أو Cmd+Enter على Mac.
  2. اضغط النقاط الثلاث أعلى عرض Source Control واختر «Push» لرفع تغييراتك إلى GitHub.

FIG. 12الخطوة 7: رفع تغييراتك إلى GitHubرسم توضيحي لتعديل المشاريع مفتوحة المصدر

FIG. 13الخطوة 7: رفع تغييراتك إلى GitHubرسم توضيحي لتعديل المشاريع مفتوحة المصدر

الخطوة 8: فتح طلب دمج

أخيرًا، لنقترح إدخال تغييراتك في المشروع الأصلي:

  1. انتقل إلى https://github.com/YOUR_GITHUB_USERNAME/Bitcoiner.Guide
  2. اضغط زر «Pull request».
  3. اضغط «New pull request» أو «Compare & pull request».

FIG. 14الخطوة 8: فتح طلب دمجرسم توضيحي لتعديل المشاريع مفتوحة المصدر

  1. تأكد من أن «base repository» هو BitcoinQnA/Bitcoiner.Guide وأن «head repository» هو YOUR_GITHUB_USERNAME/Bitcoiner.Guide.
  2. اضغط «Create pull request».
  3. أدخل عنوانًا ووصفًا لتغييراتك.
  4. اضغط «Create pull request» مرة أخرى.

FIG. 15الخطوة 8: فتح طلب دمجرسم توضيحي لتعديل المشاريع مفتوحة المصدر

تهانينا! نجحت في إنشاء نسخة متفرعة من Bitcoiner.Guide والمساهمة وفتح طلب دمج. سيراجع مسؤول صيانة المشروع، وهو هنا QnA، تغييراتك. وقد يقبلها كما هي، أو يطلب تعديلات، أو يناقشها معك.

خطوات اختيارية

الخطوة 9: إجراء تغييرات إضافية بعد إنشاء طلب الدمج

بعد إنشاء طلب الدمج، قد تقرر إجراء مزيد من التغييرات، أو يطلب منك مسؤولو المشروع تعديل شيء. يمكنك فعل ذلك دون إنشاء طلب دمج جديد. إليك الطريقة:

  1. تأكد من أنك على الفرع الصحيح في Visual Studio Code، أي الفرع نفسه الذي أجريت عليه التغييرات الأولى وأنشأت منه طلب الدمج.
  2. أجرِ التعديلات الإضافية في الشيفرة واحفظ الملفات.
  3. جهّز هذه التغييرات وسجّلها في commit كما فعلت في الخطوة 6-7.
  4. اضغط النقاط الثلاث أعلى عرض Source Control واختر «Push».

ستظهر التغييرات الجديدة تلقائيًا في طلب الدمج القائم على GitHub، ولا تحتاج إلى طلب جديد. إذا أردت التعليق على تغييراتك، فانتقل إلى طلب الدمج على GitHub وأضف تعليقًا في سلسلة النقاش.

الخطوة 10: إبقاء نسختك المتفرعة محدثة

جلب التحديثات يحصل فقط على حالة المستودع المتاحة آنذاك. راجع التحديثات اللاحقة وطبقها عمداً؛ نجاح الجلب لا يضمن بقاء النشر محدثاً تلقائياً.

عندما تنشئ نسخة متفرعة، تحصل على لقطة من المشروع في لحظة معينة. لكن المشروع الأصلي يستمر في التطور مع تغييرات المساهمين الآخرين. لإبقاء نسختك مواكبة لأحدث تغييرات المشروع الأصلي، اتبع الخطوات التالية:

  1. إضافة المشروع الأصلي بوصفه مستودعًا بعيدًا: تُخبر هذه الخطوة Git بموقع المشروع الأصلي. لا تحتاج إلى تنفيذها إلا مرة واحدة.
    • افتح Visual Studio Code وتأكد من فتح مشروع Bitcoiner.Guide.
    • افتح الطرفية في Visual Studio Code عبر View -> Terminal.
    • اكتب git remote add upstream https://github.com/BitcoinQnA/Bitcoiner.Guide.git واضغط Enter. يضيف هذا الأمر مستودعًا بعيدًا جديدًا، هو المشروع الأصلي، ويسميه «upstream».
  2. جلب تغييرات المشروع الأصلي: تنزّل هذه الخطوة أحدث تغييرات المشروع الأصلي، لكنها لا تدمجها في مشروعك بعد.
    • في الطرفية، اكتب git fetch upstream واضغط Enter.
  3. الانتقال إلى فرعك الأساسي: ينبغي دمج التغييرات في الفرع الأساسي، لا في فرع الميزة الذي أجريت فيه تغييراتك.
    • في Visual Studio Code، اضغط اسم الفرع أسفل يسار الشاشة؛ يفترض أن يكون اسم فرع الميزة الخاص بك.
    • في النافذة التي تظهر، اختر الفرع الأساسي، الذي يُسمى عادة main أو master.
  4. دمج التغييرات: تدمج هذه الخطوة تغييرات المشروع الأصلي في فرعك الأساسي.
    • في الطرفية، اكتب git merge upstream/main أو git merge upstream/master بحسب اسم الفرع الأساسي في المشروع الأصلي، ثم اضغط Enter.

خاتمة

قد تبدو المساهمة في مشاريع مفتوحة المصدر مثل Bitcoiner.Guide مخيفة، خصوصًا للمبتدئين. لكن هذا الدليل الشامل يوفر الخطوات والأدوات اللازمة لإنشاء نسخة متفرعة وتعديلها وتقديم طلب دمج بثقة.

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

عن الكاتب

مرحبًا، أنا Bitlevi! أبلور ما أتعلمه في رحلتي إلى السيادة الشخصية بالكتابة عن البيتكوين وأدوات FOSS. يمكنك مراسلتي على Twitter أو زيارة موقعي الإلكتروني. إذا أعجبك هذا الدليل وأردت التبرع، فهذا هو PayNym الخاص بي!


تابع مسار تعلمك

سؤال يقود إلى آخر.

01معاملة عالقة: انتظر أو سرّعها أو ألغها02أول عطلة نهاية أسبوع لك مع الحفظ الذاتي

Find your next answer.

Search the complete field guide · Esc to close