Skip to content

Commit 7b0e06f

Browse files
committed
fix format
1 parent aa5188c commit 7b0e06f

4 files changed

Lines changed: 37 additions & 12 deletions

File tree

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
icon: triangle-exclamation
3-
description: Common Issues
3+
description: Common Issues with Portable Packages
44
---
55

66
# Errors & Quirks
77

88
Common issues when running portable packages:
99

10-
- [FUSE](fuse.md) - Filesystem in Userspace issues
11-
- [Fonts](fonts.md) - Font rendering problems
12-
- [Namespaces](namespaces.md) - User namespace restrictions
10+
* [**Fuse**](fuse.md): Required for mounting Filesystems & Images
11+
* [**Fonts**](fonts.md): Required to display/render Non-English Chars, Emojis, Symbols etc.
12+
* [**Kernel User NameSpaces**](namespaces.md): Required for Sandboxing, Security & Performance

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

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,40 @@
11
---
22
icon: font
3-
description: Font Issues
3+
description: Required to display/render Non-English Chars, Emojis, Symbols etc.
44
---
55

66
# Fonts
77

8+
{% hint style="info" %}
9+
Required to display/render Non-English Chars, Emojis, Symbols etc.
10+
{% endhint %}
11+
812
Portable packages may have font rendering issues due to missing fonts or fontconfig.
913

1014
## Common Issues
1115

1216
- Missing fonts (squares or boxes instead of characters)
1317
- Wrong font fallbacks
1418
- CJK characters not rendering
19+
- Emojis showing as boxes
1520

1621
## Solutions
1722

1823
### Install Common Fonts
1924

2025
**Debian/Ubuntu:**
2126
```bash
22-
sudo apt install fonts-noto fonts-liberation
27+
sudo apt install fonts-noto fonts-liberation fonts-noto-color-emoji
2328
```
2429

2530
**Fedora:**
2631
```bash
27-
sudo dnf install google-noto-fonts-common liberation-fonts
32+
sudo dnf install google-noto-fonts-common liberation-fonts google-noto-emoji-fonts
2833
```
2934

3035
**Arch:**
3136
```bash
32-
sudo pacman -S noto-fonts ttf-liberation
37+
sudo pacman -S noto-fonts noto-fonts-emoji ttf-liberation
3338
```
3439

3540
### Set Font Environment

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

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,16 @@
11
---
22
icon: hard-drive
3-
description: FUSE Issues
3+
description: Required for mounting Filesystems & Images
44
---
55

66
# FUSE
77

8+
{% hint style="info" %}
9+
Required for mounting Filesystems & Images
10+
11+
Can still be run with `--appimage-extract-and-run` | `APPIMAGE_EXTRACT_AND_RUN=1`
12+
{% endhint %}
13+
814
AppImages and similar formats use FUSE (Filesystem in Userspace) to mount themselves.
915

1016
## Common Errors
@@ -38,8 +44,18 @@ sudo pacman -S fuse2
3844

3945
### Extract Instead
4046

41-
Most AppImages support `--appimage-extract`:
47+
Most AppImages support extraction as fallback:
48+
49+
```bash
50+
./app.AppImage --appimage-extract-and-run
51+
```
52+
53+
Or set the environment variable:
54+
```bash
55+
APPIMAGE_EXTRACT_AND_RUN=1 ./app.AppImage
56+
```
4257

58+
Manual extraction:
4359
```bash
4460
./app.AppImage --appimage-extract
4561
./squashfs-root/AppRun

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

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,13 @@
11
---
22
icon: shield-halved
3-
description: Namespace Issues
3+
description: Required for Sandboxing, Security & Performance
44
---
55

6-
# Namespaces
6+
# Kernel User NameSpaces
7+
8+
{% hint style="info" %}
9+
Required for Sandboxing, Security & Performance
10+
{% endhint %}
711

812
Some portable packages use user namespaces for sandboxing, which may be restricted on certain systems.
913

0 commit comments

Comments
 (0)