Skip to content

Commit c71cac8

Browse files
QaidVoidQaidVoid
committed
bring back useful docs
1 parent cb0f0ac commit c71cac8

12 files changed

Lines changed: 242 additions & 5 deletions

File tree

‎SUMMARY.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@
66
* [About](orgs/pkgforge-core/about.md)
77
* [People](orgs/pkgforge-core/people.md)
88
* [PkgForge-Community](orgs/pkgforge-community.md)
9+
* [PkgForge-Dev](orgs/pkgforge-dev/README.md)
10+
* [Projects](orgs/pkgforge-dev/projects/README.md)
11+
* [Anylinux-AppImages](orgs/pkgforge-dev/projects/anylinux-appimages.md)
12+
* [People](orgs/pkgforge-dev/people.md)
913

1014
## Soar
1115

@@ -26,6 +30,10 @@
2630
* [RunImage](formats/packages/runimage/README.md)
2731
* [NixAppImage](formats/packages/nixappimage/README.md)
2832
* [Archive](formats/packages/archive/README.md)
33+
* [Errors & Quirks](formats/packages/errors-and-quirks/README.md)
34+
* [FUSE](formats/packages/errors-and-quirks/fuse.md)
35+
* [Fonts](formats/packages/errors-and-quirks/fonts.md)
36+
* [Namespaces](formats/packages/errors-and-quirks/namespaces.md)
2937

3038
## SBUILD
3139

@@ -62,6 +70,7 @@
6270
* [soarpkgs](repositories/soarpkgs/README.md)
6371
* [Metadata](repositories/soarpkgs/metadata.md)
6472
* [Contribution](repositories/soarpkgs/contribution.md)
73+
* [Package Request](repositories/soarpkgs/package-request.md)
6574
* [Security](repositories/soarpkgs/security.md)
6675
* [FAQ](repositories/soarpkgs/faq.md)
6776
* [bincache](repositories/bincache/README.md)

‎formats/packages/README.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,3 +13,7 @@ Portable package formats for GUI applications:
1313
- [RunImage](runimage/) - Container-based portable apps
1414
- [NixAppImage](nixappimage/) - Nix-based AppImages
1515
- [Archive](archive/) - Compressed archives
16+
17+
## Troubleshooting
18+
19+
See [Errors & Quirks](errors-and-quirks/) for common issues (FUSE, fonts, namespaces).

‎formats/packages/errors-and-quirks/README.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
icon: triangle-exclamation
3+
description: Common Issues
4+
---
5+
6+
# Errors & Quirks
7+
8+
Common issues when running portable packages:
9+
10+
- [FUSE](fuse.md) - Filesystem in Userspace issues
11+
- [Fonts](fonts.md) - Font rendering problems
12+
- [Namespaces](namespaces.md) - User namespace restrictions

‎formats/packages/errors-and-quirks/fonts.md‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
icon: font
3+
description: Font Issues
4+
---
5+
6+
# Fonts
7+
8+
Portable packages may have font rendering issues due to missing fonts or fontconfig.
9+
10+
## Common Issues
11+
12+
- Missing fonts (squares or boxes instead of characters)
13+
- Wrong font fallbacks
14+
- CJK characters not rendering
15+
16+
## Solutions
17+
18+
### Install Common Fonts
19+
20+
**Debian/Ubuntu:**
21+
```bash
22+
sudo apt install fonts-noto fonts-liberation
23+
```
24+
25+
**Fedora:**
26+
```bash
27+
sudo dnf install google-noto-fonts-common liberation-fonts
28+
```
29+
30+
**Arch:**
31+
```bash
32+
sudo pacman -S noto-fonts ttf-liberation
33+
```
34+
35+
### Set Font Environment
36+
37+
```bash
38+
export FONTCONFIG_PATH=/etc/fonts
39+
```

‎formats/packages/errors-and-quirks/fuse.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
icon: hard-drive
3+
description: FUSE Issues
4+
---
5+
6+
# FUSE
7+
8+
AppImages and similar formats use FUSE (Filesystem in Userspace) to mount themselves.
9+
10+
## Common Errors
11+
12+
```
13+
fusermount: mount failed: Operation not permitted
14+
```
15+
16+
```
17+
Cannot mount AppImage, please check your FUSE setup
18+
```
19+
20+
## Solutions
21+
22+
### Install FUSE
23+
24+
**Debian/Ubuntu:**
25+
```bash
26+
sudo apt install fuse libfuse2
27+
```
28+
29+
**Fedora:**
30+
```bash
31+
sudo dnf install fuse fuse-libs
32+
```
33+
34+
**Arch:**
35+
```bash
36+
sudo pacman -S fuse2
37+
```
38+
39+
### Extract Instead
40+
41+
Most AppImages support `--appimage-extract`:
42+
43+
```bash
44+
./app.AppImage --appimage-extract
45+
./squashfs-root/AppRun
46+
```
47+
48+
### Use Type-3 AppImages
49+
50+
Type-3 AppImages don't require FUSE - they use `squashfuse` embedded in the runtime.

‎formats/packages/errors-and-quirks/namespaces.md‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
icon: shield-halved
3+
description: Namespace Issues
4+
---
5+
6+
# Namespaces
7+
8+
Some portable packages use user namespaces for sandboxing, which may be restricted on certain systems.
9+
10+
## Common Errors
11+
12+
```
13+
clone failed: Operation not permitted
14+
```
15+
16+
```
17+
user namespaces are not enabled
18+
```
19+
20+
## Solutions
21+
22+
### Enable User Namespaces
23+
24+
**Check current setting:**
25+
```bash
26+
sysctl kernel.unprivileged_userns_clone
27+
```
28+
29+
**Enable temporarily:**
30+
```bash
31+
sudo sysctl -w kernel.unprivileged_userns_clone=1
32+
```
33+
34+
**Enable permanently:**
35+
```bash
36+
echo 'kernel.unprivileged_userns_clone=1' | sudo tee /etc/sysctl.d/userns.conf
37+
sudo sysctl --system
38+
```
39+
40+
### Debian/Ubuntu Specific
41+
42+
```bash
43+
sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
44+
```
45+
46+
### Use --no-sandbox
47+
48+
Some applications accept `--no-sandbox` flag (use with caution).

‎orgs/pkgforge-dev/README.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
icon: code
3+
description: Development Organization
4+
---
5+
6+
# PkgForge-Dev
7+
8+
[PkgForge-Dev](https://github.com/pkgforge-dev) hosts development and experimental projects.
9+
10+
## Projects
11+
12+
- [Anylinux-AppImages](projects/anylinux-appimages.md) - Portable AppImages for any Linux distro

‎orgs/pkgforge-dev/people.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
icon: users
3+
description: Contributors
4+
---
5+
6+
# People
7+
8+
See [PkgForge Core People](../pkgforge-core/people.md) for the main team.
9+
10+
Additional contributors to pkgforge-dev projects are listed in each project's repository.

‎orgs/pkgforge-dev/projects/README.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
icon: folder
3+
description: Projects
4+
---
5+
6+
# Projects
7+
8+
- [Anylinux-AppImages](anylinux-appimages.md)

‎orgs/pkgforge-dev/projects/anylinux-appimages.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
icon: box
3+
description: Portable AppImages
4+
---
5+
6+
# Anylinux-AppImages
7+
8+
[Anylinux-AppImages](https://github.com/pkgforge-dev/anylinux-appimages) builds AppImages that work on any Linux distribution.
9+
10+
## Features
11+
12+
- Uses static runtime for maximum compatibility
13+
- Works on both glibc and musl systems
14+
- Type-3 AppImages (no FUSE required)
15+
- Automated builds via GitHub Actions
16+
17+
## Repository
18+
19+
[github.com/pkgforge-dev/anylinux-appimages](https://github.com/pkgforge-dev/anylinux-appimages)

0 commit comments

Comments
 (0)