مستودع مصدر LibreWolf

يحتوي هذا المستودع على جميع التصحيحات (patches) والتخصيصات (theming) التي تشكل LibreWolf، بالإضافة إلى البرامج النصية وملف Makefile لبناء LibreWolf. يوجد أيضًا مستودع الإعدادات، الذي يحتوي على تفضيلات LibreWolf.

نظرة عامة على LibreWolf

graph LR
    FFSRC(مصدر Firefox)

    FFSRC--ملف مضغوط--->Source

    subgraph librewolf-community/
    Settings(الإعدادات)--"librewolf.cfg<br>policies.json"-->Source
    Website(الموقع الإلكتروني<br><br>- التوثيق<br>- الأسئلة الشائعة)
    subgraph browser/
        Source(المصدر<br><br>- التصحيحات<br>- التخصيصات<br>- نصوص البناء)
        bsys6(bsys6<br><br>مستودع البناء الجديد<br>باستخدام Docker)
        AppImage
        Arch
    end
    end
    Website-->librewolf.net
    Source--"ملف مصدر مضغوط"-->bsys6
    AppImage--".appimage"-->librewolf.net
    bsys6--"ملف setup.exe لويندوز"--->librewolf.net
    bsys6--"ملف portable.zip لويندوز"--->librewolf.net
    bsys6--"ملف .msix لويندوز"--->MS("متجر Microsoft")
    bsys6--"ملف .nupkg لويندوز"--->Chocolatey
    bsys6--"ملف ثنائي مضغوط للينكس"--->Flathub
    bsys6--"ملف ثنائي مضغوط للينكس"--> AppImage
    bsys6--"ملف .deb للينكس"--->repo.librewolf.net
    bsys6--"ملف .rpm للينكس"--->repo.librewolf.net
    bsys6--"ملف ثنائي مضغوط للينكس لـ 'librewolf-bin'"--> Arch
    Source--"ملف مصدر مضغوط لـ 'librewolf'"-->Arch
    Arch-->AUR

المستودعات والمشاريع النشطة

قائمة بالمشاريع الفرعية لبناء المتصفح. هذه هي الأماكن التي يحتفظ فيها الأشخاص بمستودعاتهم وملفات البناء.

مستودعات البناء النشطة حاليًا:

• Arch: حزمة Arch Linux
• Bsys6: ملفات .deb/.rpm لنظامي Mint, Fedora, Ubuntu; ملف .dmg لنظام MacOS; ملف portable/setup لنظام ويندوز.
• Gentoo: حزمة Gentoo

حزم التوزيعات المشتقة:

• Alpine Linux aport

الانشقاقات السابقة:

• Cachy-Browser: https://github.com/cachyos/cachyos-browser-settings
• FireDragon: https://github.com/dr460nf1r3/firedragon-browser

تعليمات بناء LibreWolf

هناك طريقتان لبناء LibreWolf. يمكنك إما استخدام ملف المصدر المضغوط (tarball) أو التجميع مباشرة من هذا المستودع.

البناء من الملف المضغوط

أولاً، دعنا نقوم بتحميل أحدث ملف مضغوط. هذا الملف المضغوط هو الأحدث الذي تم إنتاجه بواسطة CI. يمكنك أيضًا التحقق من sha256sum للملف المضغوط هناك.

tar xf <اسم الملف المضغوط>
cd <المجلد>

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

./mach --no-interactive bootstrap --application-choice=browser

أخيرًا، يمكنك بناء LibreWolf ثم تعبئته كحزمة أو تشغيله باستخدام الأوامر التالية:

./mach build
./mach package
# أو
./mach run

البناء باستخدام هذا المستودع

أولاً، قم باستنساخ هذا المستودع باستخدام Git:

git clone --recursive https://codeberg.org/librewolf/source.git librewolf-source
cd librewolf-source

بعد ذلك، قم ببناء شفرة مصدر LibreWolf باستخدام الأمر التالي:

make dir

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

make bootstrap

أخيرًا، يمكنك بناء LibreWolf ثم تعبئته كحزمة أو تشغيله باستخدام الأوامر التالية:

make build
make package
# أو
make run

الترجمات

نستخدم Weblate لترجمة جميع السلاسل النصية الخاصة بـ LibreWolf. يمكنك مساعدتنا عن طريق ترجمة LibreWolf إلى لغتك على https://translate.codeberg.org/engage/librewolf. وفيما يلي حالة الترجمة الحالية:

ملاحظات التطوير

كيفية إنشاء تصحيح (patch)

أسهل طريقة لإنشاء التصحيحات هي الذهاب إلى مجلد مصدر LibreWolf:

cd librewolf-$(cat version)
git init
git add <مسار_الملف_الذي_غيرته>
git commit -am initial-commit
git diff > ../mypatch.patch

لدينا غرف Gitter / Matrix، وعلى الموقع الإلكتروني لدينا روابط لمتتبعات المشكلات المختلفة.

كيفية العمل على تصحيح موجود

أسهل طريقة لإنشاء التصحيحات هي الذهاب إلى مجلد مصدر LibreWolf:

make fetch # احصل على الملف المضغوط لـ firefox
./scripts/git-patchtree.sh patches/sed-patches/disable-pocket.patch

الآن قم بتعديل شجرة المصدر بالطريقة التي تريدها، مع تذكر إضافة الملفات الجديدة باستخدام git add. عند الانتهاء، يمكنك إنشاء التصحيح الجديد باستخدام:

cd firefox-<الإصدار>
git diff 4b825dc642cb6eb9a060e54bf8d69288fbee4904 HEAD > ../my-patch-name.patch

هذا المعرف هو قيمة التجزئة (hash) لأول commit، والذي يُسمى initial. لا تنسَ عمل commit للتغييرات قبل القيام بهذا الفرق (diff)، وإلا سيكون التصحيح ناقصًا.

كيفية إنشاء تصحيح لمشاكل في Bugzilla الخاص بـ Mozilla.

حسنًا، أولاً وقبل كل شيء:

• أنشئ حسابًا.
• رابط مفيد: الأخطاء المسجلة اليوم.
• الأساسيات: توثيق شجرة مصدر Firefox.

الآن بعد أن أصبح لديك تصحيح في LibreWolf، فهذا لا يكفي لرفعه إلى Mozilla. كما ترى، Mozilla تقبل فقط التصحيحات ضد إصدار Nightly. إليك كيفية القيام بذلك:

إذا لم تكن قد فعلت ذلك بالفعل، قم بإنشاء مجلد mozilla-unified وبناء Firefox باستخدامه:

hg clone https://hg.mozilla.org/mozilla-unified
cd mozilla-unified
hg update
MOZBUILD_STATE_PATH=$HOME/.mozbuild ./mach --no-interactive bootstrap --application-choice=browser
./mach build
./mach run

إذا تخطيت الخطوة السابقة، يمكنك التأكد من أنك محدث باستخدام:

cd mozilla-unified
hg pull
hg update

الآن يمكنك تطبيق التصحيح الخاص بك على Nightly:

patch -p1 -i ../mypatch.patch

الآن دع Mercurial يقوم بإنشاء التصحيح:

hg diff > ../my-nightly-patch.patch

ويمكن رفعه إلى Bugzilla.

(مقتطف من ملف README الخاص بـ Mozilla) الآن تبدأ المتعة

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

مرحبًا، أنا أستخدم MacOS أو ويندوز..

نحن نتفهم، الحياة ليست دائماً عادلة 😺. نفس الخطوات المذكورة أعلاه تنطبق، لكن ستحتاج إلى اتباع الجزء الأول من الأدلة التالية:

• MacOS: ملفات .dmg المُجمَّعة عبر الترجمة المتقاطعة (cross-compiled) لنظام Mac جديدة نسبيًا. يجب أن تعمل، ربما باستثناء خطوة make setup-wasi.
• ويندوز: البناء على ويندوز لم يتم اختباره بشكل جيد.

المساعدة في اختبار هذه الأهداف مرحب بها دائمًا.