docs(readme): update structure and tables for improved clarity

This commit is contained in:
2025-06-15 16:35:28 +02:00
parent fd0c2a8f84
commit 5c928e565a

View File

@@ -9,14 +9,16 @@ externe Abhängigkeiten verteilen möchtest.
## Inhalt
1. [Funktionsweise](#funktionsweise)
2. [Voraussetzungen](#voraussetzungen)
3. [Schnellstart](#schnellstart)
4. [Beispiele](#beispiele)
5. [Erklärung der Parameter](#erklärung-der-parameter)
6. [Dateiaufbau des SFX](#dateiaufbau-des-sfx)
7. [Troubleshooting](#troubleshooting)
8. [Lizenz](#lizenz)
- [Self-Extracting Archive (SFX) Builder](#self-extracting-archive-sfx-builder)
- [Inhalt](#inhalt)
- [Funktionsweise](#funktionsweise)
- [Voraussetzungen](#voraussetzungen)
- [Schnellstart](#schnellstart)
- [Beispiele](#beispiele)
- [Erklärung der Parameter](#erklärung-der-parameter)
- [Dateiaufbau des SFX](#dateiaufbau-des-sfx)
- [Troubleshooting](#troubleshooting)
- [Lizenz](#lizenz)
---
@@ -39,7 +41,7 @@ externe Abhängigkeiten verteilen möchtest.
## Voraussetzungen
| Tool | Zweck | Getestete Version |
|-----------------|----------------------------|-------------------|
| ---------------------------------------- | ------------------------- | ----------------- |
| `bash` | Shell-Interpreter | ≥ 4.2 |
| `tar` | Paketierung | _(coreutils)_ |
| `zstd` | Kompression | ≥ 1.5 |
@@ -90,7 +92,7 @@ bash -x cool_tool.run --version
## Erklärung der Parameter
| Option | Alias | Pflicht? | Beschreibung |
|----------------------------|-------|----------|--------------------------------------------------|
| --------------------- | ----- | -------- | -------------------------------------------------------- |
| `--payload-dir <DIR>` | `-p` | ✅ | Verzeichnis mit allen zu verteilenden Dateien |
| `--entrypoint <FILE>` | `-e` | ✅ | Ausführbare Datei *innerhalb* von **DIR** |
| `--output <FILE>` | `-o` | ❌ | Zielpfad der erzeugten `.run`-Datei (Default: `sfx.run`) |
@@ -116,11 +118,10 @@ Die Platzhalter werden beim Build automatisch ersetzt.
## Troubleshooting
| Problem | Ursache / Lösung |
|---------------------------------------|-------------------------------------------------------------------|
| ------------------------------------ | ----------------------------------------------- |
| `zstd: command not found` | Installiere das Paket `zstd`. |
| Entrypoint wird nicht ausgeführt | Prüfe Ausführungsrechte (`chmod +x`). |
| „Marker __ARCHIVE_BEGIN__ not found“ | Stelle sicher, dass der Header unverändert ist. |
| `bad tar header` bei Ausführung | Header im Repo vs. Build-Header gemischt? `make clean && make`. |
---