- Shell 98.4%
- Python 1.2%
- Dockerfile 0.4%
| .forgejo/workflows | ci: use woodpecker for build integration | |
| .vscode | Initial commit | |
| assets | librewolf -> konform | |
| src | deb/rpm: indicate supported extension packages as recommends/suggests | |
| .gitignore | Make deb | |
| .woodpecker.yml | chore(ci): comment typo fix | |
| bsys6 | make shebang use /usr/bin/env | |
| bsys6_docker | librewolf -> konform | |
| LICENSE | add license | |
| README.md | librewolf -> konform | |
🛠️ bsys6
This repository should make it easy to build Konform Browser and various things around it, via Docker or directly on your system.
Usage
Right now this repository is only meant to be used on a x86_64 Linux system. You
always run ./bsys6, followed by a chain of commands you want to run. The most
important commands are the following, a arrow indicates a dependency to another
command:
flowchart TB
source --> build --> package --> deb & rpm
To view all commands, run ./bsys6 help. Commands can be customized by setting
environment variables, most importantly:
| Environment variable | Description | Possible values (bold is default) |
|---|---|---|
TARGET |
The platform you want to build for. | linux |
ARCH |
The architecture that you want to build for. | x86_64 arm64 i686 |
VERSION |
The version of Konform Browser to build. | [latest version] [version tag]. |
WORKDIR |
The directory where the source code should be downloaded to and where the compilation should happen. | ~/.local/share/bsys6/work [any directory] |
SOURCE_TAR |
Optionally, a path to a local source tarball to use instead of downloading the VERSION-tarball from GitLab. |
[any filepath] |
For actually building Konform Browser, there are two options available:
Building with Docker
-
Run
./bsys6_docker <COMMAND>. The available commands can be found above and the resulting artifact will be placed in your current directory.This will automatically download a prebuilt docker image as a build environment. If you want to build the image yourself, run
./bsys6 build_image, optionally with theTARGETenvironment variable set to specify which image you want to build.
Building directly on your system
-
Prepare all the dependencies for your system. You can do that by running
./bsys6 prepare.This step is only supported on Arch and Debian based systems, you will have to install the dependencies manually on other systems. If you want to cross-compile, also already set the
TARGETenvironment variable to the platform you want to target before that to ensure all necessary dependencies are installed. -
Run
./bsys6 <COMMAND>. The available commands can be found above and the resulting artifact will be placed in your current directory.
Development
Structure
| Directory | Contents | Arguments | How to include |
|---|---|---|---|
src/{command}.sh |
Commands that can be run by the user with ./bsys6 {command}. Can export new environment variables. |
Via environment variable | With source |
src/exports/*.sh |
Scripts that export environment variables, but shouldn't be run directly by the user. | Via environment variable | With source |
src/utils/*.sh |
Scripts that don't export environment variables and shouldn't be run directly by the user. | Via environment variable or positional arguments | Run directly |
License
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.