Repository sorgente di LibreWolf

Questo repository contiene tutte le patch e il theming che compongono LibreWolf, oltre a script e un Makefile per compilare LibreWolf. Esiste anche il repository Settings, che contiene le preferenze di LibreWolf.

Panoramica di 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

Repository e progetti attivi

Elenco dei sottoprogetti di compilazione del browser. Queste sono le posizioni in cui le persone hanno i loro repository e gli artefatti di compilazione.

Repository di compilazione attualmente attivi:

• Arch: pacchetto Arch Linux
• Bsys6: .deb/.rpm per Mint, Fedora, Ubuntu; .dmg per MacOS; portable/setup per Windows.
• Gentoo: pacchetto Gentoo

Pacchetti delle distribuzioni a valle:

• Alpine Linux aport

Fork precedenti:

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

Istruzioni per la compilazione di LibreWolf

Ci sono due modi per compilare LibreWolf. Puoi usare il tarball dei sorgenti o compilare direttamente con questo repository.

Compilazione dal Tarball

Per prima cosa, scarica l'ultimo tarball. Questo tarball è l'ultimo prodotto dal CI. Puoi anche controllare lo sha256sum del tarball qui.

tar xf <tarball>
cd <folder>

Poi, devi eseguire il bootstrap del tuo sistema per essere in grado di compilare LibreWolf. Devi farlo solo una volta. Si esegue con i seguenti comandi:

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

Infine puoi compilare LibreWolf e poi impacchettarlo o eseguirlo con i seguenti comandi:

./mach build
./mach package
# OR
./mach run

Compilazione con questo Repository

Per prima cosa, clona questo repository con Git:

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

Poi, compila il codice sorgente di LibreWolf con il seguente comando:

make dir

Dopo di che, devi eseguire il bootstrap del tuo sistema per essere in grado di compilare LibreWolf. Devi farlo solo una volta. Si esegue con il seguente comando:

make bootstrap

Infine puoi compilare LibreWolf e poi impacchettarlo o eseguirlo con i seguenti comandi:

make build
make package
# OR
make run

Traduzioni

Usiamo Weblate per localizzare tutte le stringhe specifiche di LibreWolf. Puoi aiutarci traducendo LibreWolf nella tua lingua su https://translate.codeberg.org/engage/librewolf. Ecco lo stato attuale della traduzione:

Note di sviluppo

Come creare una patch

Il modo più semplice per creare patch è andare alla cartella dei sorgenti di LibreWolf:

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

Abbiamo stanze Gitter / Matrix, e sul sito web abbiamo link ai vari issue tracker.

Come lavorare su una patch esistente

Il modo più semplice per creare patch è andare alla cartella dei sorgenti di LibreWolf:

make fetch # get the firefox tarball
./scripts/git-patchtree.sh patches/sed-patches/disable-pocket.patch

Ora modifica l'albero dei sorgenti come desideri, tenendo presente di eseguire git add per i nuovi file. Quando hai finito, puoi creare la nuova patch con:

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

Questo ID è il valore hash del primo commit, che si chiama initial. Non dimenticare di eseguire il commit delle modifiche prima di eseguire questo diff, altrimenti la patch sarà incompleta.

Come creare una patch per problemi in Bugzilla di Mozilla.

Bene, prima di tutto:

• Crea un account.
• Link utile: Bug Segnalati Oggi.
• L'essenziale: Documentazione dell'Albero dei Sorgenti di Firefox.

Ora che hai una patch in LibreWolf, non è sufficiente per caricarla su Mozilla. Vedi, Mozilla accetta solo patch contro Nightly. Ecco come fare:

Se non l'hai già fatto, crea la cartella mozilla-unified e compila Firefox con essa:

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

Se hai saltato il passaggio precedente, puoi assicurarti di essere aggiornato con:

cd mozilla-unified
hg pull
hg update

Ora puoi applicare la tua patch a Nightly:

patch -p1 -i ../mypatch.patch

Ora lascia che Mercurial crei la patch:

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

E può essere caricata su Bugzilla.

(estratto dal readme di Mozilla) Ora inizia il divertimento

È ora di iniziare a sperimentare! Dovresti unirti a noi su Matrix, salutare nel canale Introduzione, e trovare un bug su cui iniziare a lavorare. Vedi la Guida Rapida per i Collaboratori di Firefox per imparare come testare le tue modifiche, inviare patch a Mozilla, aggiornare il codice sorgente localmente e altro ancora.

Ehi, sto usando MacOS o Windows..

Capiamo, la vita non è sempre giusta 😺. Gli stessi passaggi di cui sopra si applicano, dovrai solo seguire la parte iniziale delle guide per:

• MacOS: I file .dmg per Mac compilati in modo incrociato sono relativamente nuovi. Dovrebbero funzionare, forse con l'eccezione del passaggio make setup-wasi.
• Windows: La compilazione su Windows non è molto testata.

L'aiuto nel testare queste destinazioni è sempre gradito.