From d389e91a310ee0efeb68251b917fe9f9a08a5a84 Mon Sep 17 00:00:00 2001 From: TharukRenuja Date: Mon, 25 May 2026 13:22:55 +0530 Subject: [PATCH 1/6] Nuked ``Common Errors and Source Workflow Reference`` --- SOURCE_WORKFLOW_REFERENCE.yml | 31 -- docs/common-errors.html | 630 ---------------------------------- sitemap.xml | 14 +- 3 files changed, 1 insertion(+), 674 deletions(-) delete mode 100644 SOURCE_WORKFLOW_REFERENCE.yml delete mode 100644 docs/common-errors.html diff --git a/SOURCE_WORKFLOW_REFERENCE.yml b/SOURCE_WORKFLOW_REFERENCE.yml deleted file mode 100644 index 2d1d4df..0000000 --- a/SOURCE_WORKFLOW_REFERENCE.yml +++ /dev/null @@ -1,31 +0,0 @@ -# Place this file in your SOURCE repo at: -# .github/workflows/docs-updated.yml -# -# Replace USERNAME/REPO with the actual source repo path. -# The WEB_REPO_PAT must be a classic PAT with `repo` scope, -# stored as a secret in the source repo's Settings → Secrets → Actions. - -on: - push: - branches: [main] - paths: - - 'docs/content/**' - - 'mkdocs.yml' # optional — trigger on config changes too - -jobs: - dispatch: - runs-on: ubuntu-latest - steps: - - uses: actions/github-script@v7 - with: - github-token: ${{ secrets.WEB_REPO_PAT }} - script: | - await github.rest.repos.createDispatchEvent({ - owner: 'droidspaces', - repo: 'droidspaces.github.io', - event_type: 'docs-updated', - client_payload: { - ref: context.ref, - sha: context.sha - } - }); diff --git a/docs/common-errors.html b/docs/common-errors.html deleted file mode 100644 index 0f9cf99..0000000 --- a/docs/common-errors.html +++ /dev/null @@ -1,630 +0,0 @@ - - - - - - - - Common Errors - Droidspaces Docs - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- -
-

Common Errors & Solutions

-

A comprehensive collection of known errors, their causes, and fixes for Droidspaces.

-
-

Installation & Setup Errors

-

GrapheneOS Not Supported

-

Error: Droidspaces fails to run on GrapheneOS.

-

Cause: GrapheneOS blocks critical syscalls needed for namespace isolation and containerization, making it impossible to run a userspace runtime like Droidspaces even with root access.

-

Solution: GrapheneOS is not supported. Use a different ROM or device.

-
-

SuSFS Conflicts

-

Error: Containers fail to boot when SuSFS is installed.

-

Cause: SuSFS interferes with Droidspaces' filesystem operations.

-

Solution: Ensure "HIDE SUS MOUNTS FOR ALL PROCESSES" is disabled in your SuSFS4KSU settings. Do not report bugs when using SuSFS.

-
-

"Required key not available" (ENOKEY)

-

Symptoms: Container crashes or filesystem operations fail with "Required key not available" errors. Most common on Android devices with File-Based Encryption (FBE).

-

Cause: systemd services inside the container attempt to create new session keyrings, causing the process to lose access to Android's FBE encryption keys.

-

Affected kernels: 3.18, 4.4, 4.9, 4.14, 4.19

-

Solution: - Update Droidspaces to v4.2.4+ - Run droidspaces check to verify seccomp support - Ensure CONFIG_SECCOMP=y and CONFIG_SECCOMP_FILTER=y in your kernel - Switch to rootfs.img mode (recommended on Android) - Advanced: Decrypt /data by editing fstab in boot partitions

-
-

Mount Errors on Kernel 4.14

-

Symptoms: First container start after stopping fails with a mount error, but retry succeeds.

-

Cause: On kernel 4.14, loop device cleanup is asynchronous. After unmounting a rootfs image, the loop device may not be fully released.

-

Solution: Droidspaces v4.2.3+ handles this automatically with a 3-attempt retry loop. If still experiencing issues: - Update to the latest version - Wait a few seconds between stop and start - Use sync before restarting

-
-

OverlayFS Not Supported (f2fs)

-

Symptoms: --volatile mode fails with an error about OverlayFS not supporting f2fs.

-

Cause: Most Android devices use f2fs for /data. OverlayFS on many Android kernels does not support f2fs as a lower directory.

-

Solution: Use a rootfs image instead of a directory:

-
# Will fail on f2fs:
-droidspaces --rootfs=/data/rootfs --volatile start
-
-# Will work:
-droidspaces --name=test --rootfs-img=/data/rootfs.img --volatile start
-
-
-

Runtime Errors

-

Container Name Conflicts

-

Symptoms: Starting a container fails because a container with the same name is already running, or PID file conflicts occur.

-

Solution: 1. Check running containers: droidspaces show 2. Clean up stale state: droidspaces scan 3. Use a different name: droidspaces --name=mycontainer-2 start

-
-

Systemd Hangs on Older Kernels

-

Symptoms: systemd hangs or becomes unresponsive on legacy kernels (3.18, 4.4, 4.9, 4.14, 4.19).

-

Cause: systemd's service sandboxing triggers a race condition in the kernel's VFS grab_super path.

-

Solution: Enable the Deadlock Shield in the app or use --block-nested-namespaces in CLI, hard reboot, and try again.

-
-

Container Won't Stop

-

Symptoms: droidspaces stop takes more than 15 seconds and eventually fails.

-

Cause: Same as systemd hangs on older kernels — VFS deadlock.

-

Solution: Enable the Deadlock Shield, hard reboot, and try again.

-
-

Modern Distros Fail on Legacy Kernels

-

Symptoms: Arch Linux, Fedora, or openSUSE fail to boot with "Unsupported Kernel" or hang during systemctl commands.

-

Cause: Modern systemd (v258+) requires kernel features not present in kernels older than 5.4.

-

Solution: - Use distributions with OpenRC, runit, or s6 - Use Ubuntu 22.04/24.04/25.04 or Debian 12/13 (older systemd) - Use Alpine Linux (OpenRC-based)

-
-

Networking Errors

-

Ping Fails with "socket: permission denied"

-

Cause: Android Paranoid Networking — the kernel restricts socket creation to specific GIDs (AID_INET 3003, AID_NET_RAW 3004, AID_NET_ADMIN 3005).

-

Solution: - Kernel level: Set CONFIG_ANDROID_PARANOID_NETWORK=n - Userland: Use our pre-patched rootfs tarballs

-
-

DNS / Name Resolution Issues

-

Symptoms: Internet works (can ping IPs), but domain names fail to resolve.

-

Cause: Some ISPs block common DNS servers like 8.8.8.8 and 1.1.1.1.

-

Solution: Use your ISP's DNS servers:

-
dumpsys connectivity | sed 's/}}/\n/g' | grep 'InterfaceName: wlan0' | grep -o 'DnsAddresses: \[[^]]*\]' | grep -o '/[0-9]*\.[0-9]*\.[0-9]*\.[0-9]*' | tr -d '/'
-
-

Add the results as DNS servers in the container configuration.

-
-

WiFi/Mobile Data Disconnects

-

Symptoms: WiFi or mobile data stops working on the host during container start/stop.

-

Cause: systemd-networkd inside the container conflicts with Android's network management.

-

Solution: - Mask systemd-networkd inside the container:

-
sudo systemctl mask systemd-networkd
-
-
    -
  • Use isolated NAT mode (--net=nat)
    • -
-
-

Wi-Fi Power Save Causes Sluggish Networking

-

Symptoms: Slow networking when the device screen is off.

-

Solution: Create a watchdog container to keep Wi-Fi power save disabled:

-
# Install iw
-apk add iw  # Alpine
-apt install iw  # Debian/Ubuntu
-
-# Create watchdog script at /usr/local/bin/wifi-watchdog.sh
-while true; do
-    if iw dev wlan0 get power_save 2>/dev/null | grep -q "on"; then
-        iw dev wlan0 set power_save off
-    fi
-    sleep 60
-done
-
-

Set up as an OpenRC or systemd service. Requires host networking mode (--net=host).

-
-

Filesystem & Storage Errors

-

SELinux-Induced Rootfs Corruption (Directory Mode)

-

Symptoms: Symbolic link sizes changing unexpectedly, library load failures, or random binary crashes.

-

Cause: Android's SELinux policy assigns a generic context to /data/local/Droidspaces/Containers, interfering with filesystem operations in directory mode.

-

Solution: Switch to rootfs.img mode (--rootfs-img=/path/to/rootfs.img). This encapsulates the filesystem inside an ext4 image, preventing SELinux from relabeling individual files.

-
-

Rootfs Image I/O Errors on Android

-

Symptoms: Loop-mounting a rootfs image silently fails.

-

Cause: The SELinux context of the .img file prevents the loop driver from performing I/O.

-

Solution: Droidspaces v4.3.0+ applies the correct SELinux context automatically. For older versions:

-
chcon u:object_r:vold_data_file:s0 /path/to/rootfs.img
-
-
-

Reclaiming Storage After Deletion (Sparse Image)

-

Symptoms: rootfs.img doesn't shrink after deleting files inside the container.

-

Cause: The host filesystem can't detect when blocks are freed inside the ext4 image.

-

Solution: Run fstrim inside the container:

-
sudo fstrim -av
-
-
-

Systemd Service Errors

-

Systemd Service Sandboxing Conflicts (Legacy Kernels)

-

Symptoms: Services like redis, mysql, or apache fail with exit-code or status=226/NAMESPACE.

-

Cause: Modern systemd sandboxing directives conflict with Droidspaces' Adaptive Seccomp Shield on legacy kernels.

-

Solution: Create a service override:

-
sudo systemctl edit 
-
-

Add:

-
[Service]
-PrivateTmp=no
-PrivateDevices=no
-ProtectSystem=no
-ProtectHome=no
-RestrictNamespaces=no
-MemoryDenyWriteExecute=no
-NoNewPrivileges=no
-CapabilityBoundingSet=
-
-

Then:

-
sudo systemctl daemon-reload
-sudo systemctl restart 
-
-
-

Getting Help

-

If your issue isn't listed here:

-
    -
  1. Run droidspaces check and note any failures
    2. -
  2. Check container logs: droidspaces --name=mycontainer run journalctl -n 100
    3. -
  3. Try foreground mode: droidspaces --name=mycontainer --rootfs=/path/to/rootfs --foreground start
    4. -
  4. Join the Telegram channel for community support
    5. -
  5. Open an issue on the GitHub repository
    6. -
-
← TroubleshootingSupported Devices →
-

© 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors -

-
-
- - - - \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index 37bd626..3b6be08 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -18,17 +18,11 @@ monthly 0.1 - - https://www.droidspaces.org/docs/getting-started.html - 2026-05-23 - monthly - 0.9 - https://www.droidspaces.org/docs/installation-android.html 2026-05-23 monthly - 0.8 + 0.9 https://www.droidspaces.org/docs/installation-linux.html @@ -72,12 +66,6 @@ monthly 0.6 - - https://www.droidspaces.org/docs/common-errors.html - 2026-05-23 - monthly - 0.6 - https://www.droidspaces.org/docs/troubleshooting.html 2026-05-23 From c0a983bcd3a6d7c84ccc0a8c2a5e20347a31fd94 Mon Sep 17 00:00:00 2001 From: TharukRenuja Date: Mon, 25 May 2026 14:00:16 +0530 Subject: [PATCH 2/6] Fixed Mobile overflow issues & Adjusted Docs layout utilize full width on Desktop. --- .github/scripts/build-docs.py | 7 +++++-- docs/community-supported-devices.html | 6 ++++-- docs/cool-things-you-can-do.html | 6 ++++-- docs/features.html | 6 ++++-- docs/gpu-acceleration.html | 6 ++++-- docs/installation-android.html | 6 ++++-- docs/installation-linux.html | 6 ++++-- docs/kernel-configuration.html | 7 +++++-- docs/linux-cli.html | 6 ++++-- docs/nix-nixos.html | 6 ++++-- docs/troubleshooting.html | 6 ++++-- docs/uninstallation.html | 6 ++++-- docs/usage-android-app.html | 6 ++++-- 13 files changed, 54 insertions(+), 26 deletions(-) diff --git a/.github/scripts/build-docs.py b/.github/scripts/build-docs.py index 75ec681..11269e4 100644 --- a/.github/scripts/build-docs.py +++ b/.github/scripts/build-docs.py @@ -466,7 +466,7 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= .sidebar-content {{ flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; }} .sidebar-content h1 {{ font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -497,12 +497,14 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= .sidebar-content strong {{ color: var(--text); }} .sidebar-content a {{ color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; }} .sidebar-content a:hover {{ text-decoration: underline; }} .sidebar-content code {{ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; }} .sidebar-content pre {{ background: var(--bg2); border: 1px solid var(--border); @@ -566,7 +568,8 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; }} .sidebar-content td {{ padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index 0bfe9a3..93e12a1 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/cool-things-you-can-do.html b/docs/cool-things-you-can-do.html index f0f4738..bded2f2 100644 --- a/docs/cool-things-you-can-do.html +++ b/docs/cool-things-you-can-do.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/features.html b/docs/features.html index 2f12203..4170c06 100644 --- a/docs/features.html +++ b/docs/features.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html index c038d61..5e1e258 100644 --- a/docs/gpu-acceleration.html +++ b/docs/gpu-acceleration.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/installation-android.html b/docs/installation-android.html index a3f6f3b..a799fd3 100644 --- a/docs/installation-android.html +++ b/docs/installation-android.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/installation-linux.html b/docs/installation-linux.html index 54f700c..d361c0f 100644 --- a/docs/installation-linux.html +++ b/docs/installation-linux.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/kernel-configuration.html b/docs/kernel-configuration.html index 1bd9922..9ecde5f 100644 --- a/docs/kernel-configuration.html +++ b/docs/kernel-configuration.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,12 +95,14 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); @@ -164,7 +166,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/linux-cli.html b/docs/linux-cli.html index 4cc5bed..d50d4b6 100644 --- a/docs/linux-cli.html +++ b/docs/linux-cli.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/nix-nixos.html b/docs/nix-nixos.html index 9ad4a82..fcbb347 100644 --- a/docs/nix-nixos.html +++ b/docs/nix-nixos.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index 7a8a524..156a06a 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/uninstallation.html b/docs/uninstallation.html index bc70fa9..50aff8a 100644 --- a/docs/uninstallation.html +++ b/docs/uninstallation.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/usage-android-app.html b/docs/usage-android-app.html index 87f712e..b195cc9 100644 --- a/docs/usage-android-app.html +++ b/docs/usage-android-app.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); From 342e2e28d56961dd454b271332b4f54af148dbff Mon Sep 17 00:00:00 2001 From: TharukRenuja Date: Wed, 27 May 2026 12:01:40 +0530 Subject: [PATCH 3/6] Fixed Some Issues --- .github/scripts/build-docs.py | 260 ++++++++++++++++---------- docs/community-supported-devices.html | 10 +- docs/cool-things-you-can-do.html | 10 +- docs/features.html | 10 +- docs/gpu-acceleration.html | 10 +- docs/installation-android.html | 10 +- docs/installation-linux.html | 10 +- docs/kernel-configuration.html | 11 +- docs/linux-cli.html | 10 +- docs/nix-nixos.html | 10 +- docs/troubleshooting.html | 10 +- docs/uninstallation.html | 10 +- docs/usage-android-app.html | 10 +- 13 files changed, 232 insertions(+), 149 deletions(-) diff --git a/.github/scripts/build-docs.py b/.github/scripts/build-docs.py index 11269e4..09f95a6 100644 --- a/.github/scripts/build-docs.py +++ b/.github/scripts/build-docs.py @@ -29,6 +29,69 @@ def save_code(m): text = text.replace(f'\x00CODE{i}\x00', f'{cs}') return text +def normalize_hyphenated_links(item_html): + if not re.fullmatch(r'(?:]*>.*?)(?:\s*-\s*]*>.*?)+', item_html): + return item_html + parts = re.findall(r']*>.*?', item_html) + return '
'.join(parts) + +def parse_list_block(lines, i, parent_indent=0): + if i >= len(lines): + return '', i + line = lines[i] + stripped = line.lstrip() + indent = len(line) - len(stripped) + if re.match(r'^[-*+]\s+', stripped): + list_tag = 'ul' + marker_re = r'^[-*+]\s+' + else: + olm = re.match(r'^\d+\.\s+', stripped) + if olm: + list_tag = 'ol' + marker_re = r'^\d+\.\s+' + else: + return '', i + + base_indent = indent + items = [] + while i < len(lines): + line = lines[i] + stripped = line.lstrip() + if stripped == '': + i += 1 + continue + indent = len(line) - len(stripped) + if indent < base_indent: + break + if not re.match(marker_re, stripped): + break + item_text = re.sub(marker_re, '', stripped) + item_html = inline_format(item_text) + i += 1 + + nested_html_parts = [] + while i < len(lines): + next_line = lines[i] + stripped2 = next_line.lstrip() + if stripped2 == '': + i += 1 + continue + indent2 = len(next_line) - len(stripped2) + if indent2 <= base_indent: + break + nested_block, new_i = parse_list_block(lines, i, parent_indent=indent2) + if nested_block: + nested_html_parts.append(nested_block) + i = new_i + continue + nested_html_parts.append(f'

{inline_format(stripped2)}

') + i += 1 + + nested_html = ''.join(nested_html_parts) + items.append(f'
  • {item_html}{nested_html}
    • ') + + return f'<{list_tag}>\n' + '\n'.join(items) + f'\n', i + def consume_code(lines, i): lang = lines[i].lstrip()[3:].strip() indent = len(lines[i]) - len(lines[i].lstrip()) @@ -139,71 +202,15 @@ def md_to_html(md): continue # Ordered lists - olm = re.match(r'^\s*\d+\.\s+(.+)$', line) - if olm: - items = [] - while i < len(lines) and re.match(r'^\s*\d+\.\s+', lines[i]): - item_text = re.sub(r'^\s*\d+\.\s+', '', lines[i]) - item_html = inline_format(item_text) - i += 1 - extra = [] - while i < len(lines): - s = lines[i].lstrip() - indent = len(lines[i]) - len(s) - if indent >= 3 and s.startswith('```'): - ch, i = consume_code(lines, i) - extra.append(ch) - elif indent >= 3 and s.startswith('> '): - extra.append(f'
    {inline_format(s[2:])}
    ') - i += 1 - elif lines[i].strip() == '': - i += 1 - continue - elif indent >= 3 and s.strip(): - extra.append(inline_format(s)) - i += 1 - else: - break - items.append(f'
  • {" ".join(extra) if item_html == "" else item_html}{"".join(extra) if item_html != "" else ""}
    • ') - # Fix: combine item_html with extra - fixed_items = [] - for item in items: - fixed_items.append(item) - html.append('
      \n' + '\n'.join(items) + '\n
    ') + if re.match(r'^\s*\d+\.\s+', line): + list_html, i = parse_list_block(lines, i) + html.append(list_html) continue # Unordered lists - ulm = re.match(r'^[\s]*[-*+]\s+', line) - if ulm: - items = [] - while i < len(lines) and re.match(r'^[\s]*[-*+]\s+', lines[i]): - item_text = re.sub(r'^[\s]*[-*+]\s+', '', lines[i]) - item_html = inline_format(item_text) - i += 1 - extra = [] - while i < len(lines): - s = lines[i].lstrip() - indent = len(lines[i]) - len(s) - if indent >= 3 and s.startswith('```'): - ch, i = consume_code(lines, i) - extra.append(ch) - elif indent >= 3 and s.startswith('> '): - extra.append(f'
    {inline_format(s[2:])}
    ') - i += 1 - elif lines[i].strip() == '': - i += 1 - continue - elif indent >= 3 and s.strip(): - extra.append(inline_format(s)) - i += 1 - else: - break - items.append(f'
  • {" ".join(extra) if item_html == "" else item_html}{"".join(extra) if item_html != "" else ""}
    • ') - # Fix the combine - combined = [] - for item in items: - combined.append(item) - html.append('
      \n' + '\n'.join(items) + '\n
    ') + if re.match(r'^[\s]*[-*+]\s+', line): + list_html, i = parse_list_block(lines, i) + html.append(list_html) continue # Paragraph @@ -497,14 +504,12 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= .sidebar-content strong {{ color: var(--text); }} .sidebar-content a {{ color: var(--accent2); text-decoration: none; - word-break: break-word; overflow-wrap: anywhere; }} .sidebar-content a:hover {{ text-decoration: underline; }} .sidebar-content code {{ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); - word-break: break-word; overflow-wrap: anywhere; }} .sidebar-content pre {{ background: var(--bg2); border: 1px solid var(--border); @@ -535,6 +540,11 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= }} @media (max-width: 768px) {{ .copy-btn {{ opacity: 1; }} + .sidebar-content a {{ word-break: break-word; }} + .sidebar-content code {{ word-break: break-word; }} + .table-wrap {{ overflow-x: auto; -webkit-overflow-scrolling: touch; }} + .sidebar-content th {{ white-space: normal; word-break: break-word; }} + .sidebar-content td {{ word-break: break-word; }} }} .sidebar-content ul, .sidebar-content ol {{ color: var(--muted); line-height: 1.7; @@ -568,13 +578,11 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: normal; - word-break: break-word; overflow-wrap: anywhere; + white-space: nowrap; }} .sidebar-content td {{ padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); - word-break: break-word; }} .sidebar-content img {{ max-width: 100%; border-radius: 8px; border: 1px solid var(--border); @@ -703,6 +711,11 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= padding: 0.5rem 0.5rem; font-size: 0.78rem; }} + .sidebar-content a {{ word-break: break-word; }} + .sidebar-content code {{ word-break: break-word; }} + .table-wrap {{ overflow-x: auto; -webkit-overflow-scrolling: touch; }} + .sidebar-content th {{ white-space: normal; word-break: break-word; }} + .sidebar-content td {{ word-break: break-word; }} }}