Repositório do Código Fonte do LibreWolf

Este repositório contém todos os patches e temas que compõem o LibreWolf, bem como scripts e um Makefile para construir o LibreWolf. Existe também o repositório de Configurações, que contém as preferências do LibreWolf.

Visão geral do 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

Repositórios e projetos ativos

Lista de subprojetos de compilação do navegador. Estes são os locais onde as pessoas têm seus repositórios e artefatos de compilação.

Repositórios de compilação atualmente ativos:

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

Pacotes de distribuição downstream:

• Alpine Linux aport

Forks anteriores:

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

Instruções de compilação do LibreWolf

Existem duas formas de compilar o LibreWolf. Você pode usar o tarball de origem ou compilar diretamente com este repositório.

Compilando a partir do Tarball

Primeiro, vamos baixar o tarball mais recente. Este tarball é o mais recente produzido pelo CI. Você também pode verificar o sha256sum do tarball lá.

tar xf <tarball>
cd <folder>

Em seguida, você precisa preparar seu sistema para poder compilar o LibreWolf. Você só precisa fazer isso uma vez. Isso é feito executando os seguintes comandos:

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

Finalmente, você pode compilar o LibreWolf e então empacotá-lo ou executá-lo com os seguintes comandos:

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

Compilando com este Repositório

Primeiro, clone este repositório com Git:

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

Em seguida, compile o código fonte do LibreWolf com o seguinte comando:

make dir

Depois disso, você precisa preparar seu sistema para poder compilar o LibreWolf. Você só precisa fazer isso uma vez. Isso é feito executando o seguinte comando:

make bootstrap

Finalmente, você pode compilar o LibreWolf e então empacotá-lo ou executá-lo com os seguintes comandos:

make build
make package
# OU
make run

Traduções

Usamos o Weblate para localizar todas as strings específicas do LibreWolf. Você pode nos ajudar traduzindo o LibreWolf para o seu idioma em https://translate.codeberg.org/engage/librewolf. Aqui está o status atual da tradução:

Notas de Desenvolvimento

Como criar um patch

A maneira mais fácil de criar patches é ir para a pasta de origem do LibreWolf:

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

Temos salas no Gitter / Matrix, e no site temos links para os diversos rastreadores de problemas.

Como trabalhar em um patch existente

A maneira mais fácil de criar patches é ir para a pasta de origem do LibreWolf:

make fetch # obter o tarball do firefox
./scripts/git-patchtree.sh patches/sed-patches/disable-pocket.patch

Agora altere a árvore de origem como desejar, lembrando de usar git add para novos arquivos. Quando terminar, você pode criar o novo patch com:

cd firefox-<versão>
git diff 4b825dc642cb6eb9a060e54bf8d69288fbee4904 HEAD > ../meu-nome-de-patch.patch

Este ID é o valor hash do primeiro commit, chamado initial. Não se esqueça de commitar as alterações antes de fazer este diff, ou o patch ficará incompleto.

Como criar um patch para problemas no Bugzilla do Mozilla.

Bem, antes de tudo:

• Criar uma conta.
• Link útil: Bugs Registrados Hoje.
• O essencial: Documentação da Árvore de Origem do Firefox.

Agora que você tem um patch no LibreWolf, isso não é suficiente para enviar ao Mozilla. Veja, o Mozilla só aceita patches contra o Nightly. Então aqui está como fazer:

Se você ainda não fez isso, crie a pasta mozilla-unified e construa o Firefox com ela:

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 você pulou o passo anterior, pode garantir que está atualizado com:

cd mozilla-unified
hg pull
hg update

Agora você pode aplicar seu patch ao Nightly:

patch -p1 -i ../mypatch.patch

Agora você deixa o Mercurial criar o patch:

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

E ele pode ser enviado para o Bugzilla.

(trecho do readme do Mozilla) Agora começa a diversão

Hora de começar a hackear! Junte-se a nós no Matrix, diga olá no canal de Introdução, e encontre um bug para começar a trabalhar. Veja a Referência Rápida para Contribuidores do Firefox para aprender como testar suas alterações, enviar patches para o Mozilla, atualizar seu código-fonte localmente e mais.

Ei, estou usando MacOS ou Windows..

Nós entendemos, a vida nem sempre é justa 😺. Os mesmos passos acima se aplicam, você só precisará percorrer a parte inicial dos guias para:

• MacOS: Os arquivos .dmg do Mac compilados de forma cruzada são relativamente novos. Eles devem funcionar, talvez com exceção da etapa make setup-wasi.
• Windows: A compilação no Windows não é muito bem testada.

Ajuda com testes nesses alvos é sempre bem-vinda.