Unnamed repository; edit this file 'description' to name the repository.
Documentation: Convert links in the `.desktop` file to absolute paths (#11115)
David Else 2024-07-12
parent 2d1ac0f · commit 501af93
-rw-r--r--book/src/building-from-source.md6
1 files changed, 6 insertions, 0 deletions
diff --git a/book/src/building-from-source.md b/book/src/building-from-source.md
index 666917ea..42ed57a2 100644
--- a/book/src/building-from-source.md
+++ b/book/src/building-from-source.md
@@ -148,6 +148,12 @@ provided `.desktop` and icon files to their correct folders:
cp contrib/Helix.desktop ~/.local/share/applications
cp contrib/helix.png ~/.icons # or ~/.local/share/icons
```
+It is recommended to convert the links in the `.desktop` file to absolute paths to avoid potential problems:
+
+```sh
+sed -i -e "s|Exec=hx %F|Exec=$(readlink -f ~/.cargo/bin/hx) %F|g" \
+ -e "s|Icon=helix|Icon=$(readlink -f ~/.icons/helix.png)|g" ~/.local/share/applications/Helix.desktop
+```
To use another terminal than the system default, you can modify the `.desktop`
file. For example, to use `kitty`: