Dépôt source de LibreWolf

Ce dépôt contient tous les correctifs et le thème qui composent LibreWolf, ainsi que des scripts et un Makefile pour construire LibreWolf. Il y a également le dépôt des paramètres, qui contient les préférences de LibreWolf.

Aperçu de LibreWolf

graph LR
    FFSRC(Firefox Source)

    FFSRC--Tarball--->Source

    subgraph librewolf-community/
    Settings(Settings)--"librewolf.cfg<br>policies.json"-->Source
    Website(Website<br><br>- Documentation<br>- FAQ)
    subgraph browser/
        Source(Source<br><br>- Patches<br>- Theming<br>- Build scripts)
        bsys6(bsys6<br><br>New Docker building<br>repository)
        AppImage
        Arch
    end
    end
    Website-->librewolf.net
    Source--"Source 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

Dépôts et projets actifs

Liste des sous-projets de construction du navigateur. Ce sont les emplacements où les gens ont leurs dépôts et artefacts de construction.

Dépôts de construction actuellement actifs :

Arch: Paquet pour Arch Linux
Bsys6: .deb/.rpm pour Mint, Fedora, Ubuntu ; .dmg pour MacOS ; portable/setup pour Windows.
Gentoo: Paquet pour Gentoo

Paquets de distribution en aval :

Alpine Linux aport

Forks précédents :

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

Instructions de construction de LibreWolf

Il y a deux façons de construire LibreWolf. Vous pouvez soit utiliser l'archive source, soit compiler directement avec ce dépôt.

Construction à partir de l'archive

Tout d'abord, téléchargez la dernière archive. Cette archive est la dernière produite par le CI. Vous pouvez également vérifier la somme sha256 de l'archive à cet endroit.

tar xf <tarball>
cd <folder>

Ensuite, vous devez amorcer votre système pour pouvoir construire LibreWolf. Vous ne devez le faire qu'une seule fois. Cela se fait en exécutant les commandes suivantes :

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

Enfin, vous pouvez construire LibreWolf, puis l'empaqueter ou l'exécuter avec les commandes suivantes :

./mach build
./mach package
# OU
./mach run

Construction avec ce dépôt

Tout d'abord, clonez ce dépôt avec Git :

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

Ensuite, construisez le code source de LibreWolf avec la commande suivante :

make dir

Après cela, vous devez amorcer votre système pour pouvoir construire LibreWolf. Vous ne devez le faire qu'une seule fois. Cela se fait en exécutant la commande suivante :

make bootstrap

Enfin, vous pouvez construire LibreWolf, puis l'empaqueter ou l'exécuter avec les commandes suivantes :

make build
make package
# OU
make run

Traductions

Nous utilisons Weblate pour localiser toutes les chaînes spécifiques à LibreWolf. Vous pouvez nous aider en traduisant LibreWolf dans votre langue sur https://translate.codeberg.org/engage/librewolf. Voici l'état actuel de la traduction :

Notes de développement

Comment créer un correctif

La façon la plus simple de créer des correctifs est d'aller dans le dossier source de LibreWolf :

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

Nous avons des salons Gitter / Matrix, et sur le site web nous avons des liens vers les différents suivis de problèmes.

Comment travailler sur un correctif existant

La façon la plus simple de créer des correctifs est d'aller dans le dossier source de LibreWolf :

make fetch # obtenir l'archive Firefox
./scripts/git-patchtree.sh patches/sed-patches/disable-pocket.patch

Maintenant modifiez l'arborescence source comme vous le souhaitez, en gardant à l'esprit d'utiliser git add pour les nouveaux fichiers. Une fois terminé, vous pouvez créer le nouveau correctif avec :

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

Cet ID est la valeur de hachage du premier commit, qui s'appelle initial. N'oubliez pas de commiter les modifications avant de faire ce diff, sinon le correctif sera incomplet.

Comment créer un correctif pour des problèmes dans Bugzilla de Mozilla.

Eh bien, tout d'abord :

Créez un compte.
Lien pratique : Bugs déposés aujourd'hui.
L'essentiel : Documentation de l'arborescence source de Firefox.

Maintenant que vous avez un correctif dans LibreWolf, ce n'est pas suffisant pour le soumettre à Mozilla. Voyez, Mozilla n'accepte que les correctifs contre Nightly. Voici donc comment faire :

Si vous ne l'avez pas déjà fait, créez le dossier mozilla-unified et construisez Firefox avec :

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

Si vous avez sauté l'étape précédente, vous pouvez vous assurer d'être à jour avec :

cd mozilla-unified
hg pull
hg update

Maintenant vous pouvez appliquer votre correctif à Nightly :

patch -p1 -i ../mypatch.patch

Maintenant laissez Mercurial créer le correctif :

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

Et il peut être téléversé sur Bugzilla.

(extrait du readme de Mozilla) Maintenant le plaisir commence

Il est temps de commencer à bidouiller ! Vous devriez nous rejoindre sur Matrix, dire bonjour dans le canal Introduction, et trouver un bug sur lequel travailler. Consultez le Aide-mémoire pour les contributeurs de Firefox pour apprendre comment tester vos modifications, envoyer des correctifs à Mozilla, mettre à jour votre code source localement, et plus encore.

Hé, j'utilise MacOS ou Windows..

Nous comprenons, la vie n'est pas toujours juste 😺. Les mêmes étapes que ci-dessus s'appliquent, vous devrez simplement parcourir la partie initiale des guides pour :

MacOS : Les fichiers .dmg Mac compilés en cross-compilation sont relativement récents. Ils devraient fonctionner, peut-être à l'exception de l'étape make setup-wasi.
Windows : La construction sur Windows n'est pas très bien testée.

L'aide pour tester ces cibles est toujours la bienvenue.

Source

Populaires