LibreWolf-Quellrepository

Dieses Repository enthält alle Patches und das Theming, aus denen LibreWolf besteht, sowie Skripte und ein Makefile zum Erstellen von LibreWolf. Es gibt auch das Settings-Repository, das die LibreWolf-Einstellungen enthält.

LibreWolf-Übersicht

graph LR
    FFSRC(Firefox Source)

    FFSRC--Tarball--->Source

    subgraph librewolf-community/
    Settings(Settings)--"librewolf.cfg<br>policies.json"-->Source
    Website(Website<br><br>- Dokumentation<br>- FAQ)
    subgraph browser/
        Source(Source<br><br>- Patches<br>- Theming<br>- Build-Skripte)
        bsys6(bsys6<br><br>Neues Docker-Erstellungs-<br>Repository)
        AppImage
        Arch
    end
    end
    Website-->librewolf.net
    Source--"Quell-Tarball"-->bsys6
    AppImage--".appimage"-->librewolf.net
    bsys6--"Windows setup.exe"--->librewolf.net
    bsys6--"Windows portable.zip"--->librewolf.net
    bsys6--"Windows .msix"--->MS("Microsoft Store")
    bsys6--"Windows .nupkg"--->Chocolatey
    bsys6--"Linux binary tarball"--->Flathub
    bsys6--"Linux binary tarball"--> AppImage
    bsys6--"Linux .deb"--->repo.librewolf.net
    bsys6--"Linux .rpm"--->repo.librewolf.net
    bsys6--"Linux binary tarball for 'librewolf-bin'"--> Arch
    Source--"Source tarball for 'librewolf'"-->Arch
    Arch-->AUR

Aktive Repositories und Projekte

Liste der Browser-Build-Unterprojekte. Dies sind die Orte, an denen die Leute ihre Repositories und Build-Artefakte haben.

Derzeit aktive Build-Repositories:

• Arch: Arch Linux-Paket
• Bsys6: .deb/.rpm für Mint, Fedora, Ubuntu; .dmg für MacOS; portable/setup für Windows.
• Gentoo: Gentoo-Paket

Downstream-Distributionspakete:

• Alpine Linux aport

Frühere Forks:

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

LibreWolf-Bauanleitung

Es gibt zwei Möglichkeiten, LibreWolf zu erstellen. Du kannst entweder den Quell-Tarball verwenden oder direkt mit diesem Repository kompilieren.

Bauen aus dem Tarball

Lade zunächst den neuesten Tarball herunter. Dieser Tarball ist der neueste, der vom CI erstellt wurde. Du kannst dort auch die sha256sum des Tarballs überprüfen.

tar xf <tarball>
cd <ordner>

Dann musst du dein System bootstrappen, um LibreWolf bauen zu können. Dies musst du nur einmal tun. Das erledigst du mit den folgenden Befehlen:

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

Schließlich kannst du LibreWolf bauen und es dann mit den folgenden Befehlen verpacken oder ausführen:

./mach build
./mach package
# ODER
./mach run

Bauen mit diesem Repository

Klone zunächst dieses Repository mit Git:

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

Baue als nächstes den LibreWolf-Quellcode mit dem folgenden Befehl:

make dir

Danach musst du dein System bootstrappen, um LibreWolf bauen zu können. Dies musst du nur einmal tun. Das erledigst du mit dem folgenden Befehl:

make bootstrap

Schließlich kannst du LibreWolf bauen und es dann mit den folgenden Befehlen verpacken oder ausführen:

make build
make package
# ODER
make run

Übersetzungen

Wir verwenden Weblate, um alle LibreWolf-spezifischen Zeichenketten zu lokalisieren. Du kannst uns helfen, indem du LibreWolf in deine Sprache übersetzt unter https://translate.codeberg.org/engage/librewolf. Hier ist der aktuelle Übersetzungsstatus:

Entwicklerhinweise

Wie man einen Patch erstellt

Der einfachste Weg, Patches zu erstellen, ist, in den LibreWolf-Quellordner zu gehen:

cd librewolf-$(cat version)
git init
git add <pfad_zur_geänderten_datei>
git commit -am initial-commit
git diff > ../mypatch.patch

Wir haben Gitter/Matrix-Räume und auf der Website gibt es Links zu den verschiedenen Issue-Trackern.

Wie man an einem bestehenden Patch arbeitet

Der einfachste Weg, Patches zu erstellen, ist, in den LibreWolf-Quellordner zu gehen:

make fetch # Firefox-Tarball abrufen
./scripts/git-patchtree.sh patches/sed-patches/disable-pocket.patch

Ändere nun den Quellbaum nach deinen Wünschen, wobei du daran denkst, neue Dateien mit git add hinzuzufügen. Wenn du fertig bist, kannst du den neuen Patch erstellen mit:

cd firefox-<version>
git diff 4b825dc642cb6eb9a060e54bf8d69288fbee4904 HEAD > ../my-patch-name.patch

Diese ID ist der Hash-Wert des ersten Commits, der initial genannt wird. Vergiss nicht, vor dem Erstellen dieses Diffs die Änderungen zu committen, sonst wird der Patch unvollständig sein.

Wie man einen Patch für Probleme in Mozillas Bugzilla erstellt.

Nun, zunächst einmal:

• Ein Konto erstellen.
• Praktischer Link: Heute eingereichte Fehler.
• Das Wesentliche: Firefox-Quellbaum-Dokumentation.

Nun, wenn du einen Patch in LibreWolf hast, reicht das nicht aus, um ihn an Mozilla hochzuladen. Mozilla akzeptiert nur Patches gegen Nightly. So gehst du dabei vor:

Falls du noch nicht gemacht, erstelle den mozilla-unified-Ordner und baue Firefox damit:

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

Falls du den vorherigen Schritt übersprungen hast, kannst du sicherstellen, dass du auf dem neuesten Stand bist mit:

cd mozilla-unified
hg pull
hg update

Jetzt kannst du deinen Patch auf Nightly anwenden:

patch -p1 -i ../mypatch.patch

Jetzt lässt du Mercurial den Patch erstellen:

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

Und er kann auf Bugzilla hochgeladen werden.

(Auszug aus der Mozilla-Readme) Jetzt beginnt der Spaß

Zeit mit dem Hacken zu beginnen! Du solltest dich uns auf Matrix anschließen, im Einführungskanal Hallo sagen und einen Fehler zum Bearbeiten finden. Siehe die Kurzreferenz für Firefox-Mitwirkende, um zu lernen, wie du deine Änderungen testest, Patches an Mozilla sendest, deinen Quellcode lokal aktualisierst und mehr.

Hey, ich benutze MacOS oder Windows..

Wir verstehen, das Leben ist nicht immer fair 😺. Die gleichen Schritte wie oben gelten, du musst nur den Anfangsteil der Anleitungen durchgehen für:

• MacOS: Die cross-kompilierten Mac .dmg-Dateien sind relativ neu. Sie sollten funktionieren, vielleicht mit Ausnahme des make setup-wasi-Schritts.
• Windows: Das Bauen unter Windows ist nicht sehr gut getestet.

Hilfe beim Testen dieser Ziele ist immer willkommen.