Repositorio Fuente de LibreWolf

Este repositorio contiene todos los parches y temas que componen LibreWolf, así como scripts y un Makefile para compilar LibreWolf. También está el repositorio de Configuración, que contiene las preferencias de LibreWolf.

Resumen 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

Repositorios y proyectos activos

Lista de subproyectos de compilación del navegador. Estas son las ubicaciones donde las personas tienen sus repositorios y artefactos de compilación.

Repositorios de compilación actualmente activos:

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

Paquetes de distribución posteriores:

• Alpine Linux aport

Forks anteriores:

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

Instrucciones de compilación de LibreWolf

Hay dos formas de compilar LibreWolf. Puede usar el tarball fuente o compilar directamente con este repositorio.

Compilación desde el Tarball

Primero, descargue el último tarball. Este tarball es el más reciente producido por el CI. También puede verificar el sha256sum del tarball allí.

tar xf <tarball>
cd <folder>

Luego, debe iniciar su sistema para poder compilar LibreWolf. Solo tiene que hacer esto una vez. Se realiza ejecutando los siguientes comandos:

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

Finalmente, puede compilar LibreWolf y luego empaquetarlo o ejecutarlo con los siguientes comandos:

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

Compilación con este Repositorio

Primero, clone este repositorio con Git:

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

A continuación, compile el código fuente de LibreWolf con el siguiente comando:

make dir

Después de eso, debe iniciar su sistema para poder compilar LibreWolf. Solo tiene que hacer esto una vez. Se realiza ejecutando el siguiente comando:

make bootstrap

Finalmente, puede compilar LibreWolf y luego empaquetarlo o ejecutarlo con los siguientes comandos:

make build
make package
# OR
make run

Traducciones

Usamos Weblate para localizar todas las cadenas específicas de LibreWolf. Puede ayudarnos traduciendo LibreWolf a su idioma en https://translate.codeberg.org/engage/librewolf. Aquí está el estado actual de la traducción:

Notas de Desarrollo

Cómo hacer un parche

La forma más fácil de hacer parches es ir a la carpeta fuente de LibreWolf:

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

Tenemos salas de Gitter / Matrix, y en el sitio web tenemos enlaces a los diversos rastreadores de problemas.

Cómo trabajar en un parche existente

La forma más fácil de hacer parches es ir a la carpeta fuente de LibreWolf:

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

Ahora cambie el árbol fuente como desee, teniendo en cuenta agregar archivos nuevos con git add. Cuando termine, puede crear el nuevo parche con:

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

Este ID es el valor hash del primer commit, que se llama initial. No olvide hacer commit de los cambios antes de hacer este diff, o el parche estará incompleto.

Cómo crear un parche para problemas en Bugzilla de Mozilla.

Bueno, antes que nada:

• Crear una cuenta.
• Enlace útil: Bugs reportados hoy.
• Lo esencial: Documentación del árbol fuente de Firefox.

Ahora que tiene un parche en LibreWolf, eso no es suficiente para subirlo a Mozilla. Verá, Mozilla solo acepta parches contra Nightly. Así que aquí está cómo hacerlo:

Si aún no lo ha hecho, cree la carpeta mozilla-unified y compile Firefox con ella:

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 omitió el paso anterior, puede asegurarse de estar actualizado con:

cd mozilla-unified
hg pull
hg update

Ahora puede aplicar su parche a Nightly:

patch -p1 -i ../mypatch.patch

Ahora deje que Mercurial cree el parche:

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

Y se puede subir a Bugzilla.

(extracto del readme de Mozilla) Ahora comienza la diversión

¡Es hora de empezar a hackear! Debería unirse a nosotros en Matrix, saludar en el canal de Introducción, y encontrar un bug para empezar a trabajar. Consulte la Referencia rápida para contribuyentes de Firefox para aprender cómo probar sus cambios, enviar parches a Mozilla, actualizar su código fuente localmente y más.

Oye, estoy usando MacOS o Windows..

Entendemos, la vida no siempre es justa 😺. Los mismos pasos de arriba se aplican, solo tendrá que recorrer la parte inicial de las guías para:

• MacOS: Los archivos .dmg de Mac compilados de forma cruzada son algo nuevos. Deberían funcionar, quizás con la excepción del paso make setup-wasi.
• Windows: La compilación en Windows no está muy bien probada.

La ayuda para probar estos objetivos siempre es bienvenida.