summaryrefslogtreecommitdiff
path: root/content/guide
diff options
context:
space:
mode:
Diffstat (limited to 'content/guide')
-rw-r--r--content/guide/clean_your_home.md26
1 files changed, 17 insertions, 9 deletions
diff --git a/content/guide/clean_your_home.md b/content/guide/clean_your_home.md
index ec802a0..194596f 100644
--- a/content/guide/clean_your_home.md
+++ b/content/guide/clean_your_home.md
@@ -14,13 +14,19 @@ table: true
The [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir/latest/) (let's abbreviate it to XDG-BDS to be short) defines base directories.
-For example, you noticed that Neovim clones the plugin in `$XDG_DATA_HOME` which translates by default to `$HOME/.local/share/`. Thanks to this specification, there is a convention for apps to use specific folders to store or look for data. Neovim (and Helix, and your terminal emulator and so on) use `$XDG_CONFIG_HOME` to look for your configuration files.
+For example, you probably noticed that Neovim clones plugins in `$XDG_DATA_HOME` which translates by default to `$HOME/.local/share/`.
+
+Thanks to this specification, there is a convention for apps to use specific folders to store or look for data. For example, Neovim (and Helix, and your terminal emulator and so on) use `$XDG_CONFIG_HOME` to look for your configuration files.
### The problem
-There is tons of app who doesn't use the XDG BDS and so they kind of pick the place they like to put the cache of their app, or the userdata. And this is annoying. It's funny how the more time goes by the more dotfiles there is in your `$HOME`.
+There is tons of app who doesn't use the XDG BDS, and so they kind of pick the place they like to put the cache or the userdate of their app (and this is annoying).
+
+Just look at how the more time goes by, the more dotfiles there is in your `$HOME`.
-For example, if you use a firefox based browser your have `.mozilla`, you use adb ? `.android`, all your shell's config files like `.zshrc` are in your `$HOME` too.
+For example, if you use a firefox based browser you have `.mozilla`. You use adb ? Here is your `~/.android`. And of course all of your shell's config files like `.zshrc` are in your `$HOME` too.
+
+### Quick verification
Look at your `$HOME` :
@@ -34,15 +40,15 @@ Doesn't it look messy ? Pipe it into word count :
ls -a ~/ | wc -l
```
-I have 31 files in my `$HOME`. And I clean it regularly.
+I have 31 files in my `$HOME`. And I clean it regularly. I would really like to have only my XDG Base Directories in my HOME, but as I said, some apps don't support XDG BDS.
-But hopefully, there's some kind of fix for that.
+But fortunately, there are some programs like zsh, or git that do support XDG BDS, they just (by default) look for/create files in $HOME.
## xdg-ninja
-[xdg-ninja](https://github.com/b3nj5m1n/xdg-ninja) is a shell script that checks if the files in your home directory support XDG BDS
+[xdg-ninja](https://github.com/b3nj5m1n/xdg-ninja) is a shell script that checks if the files in your home directory support XDG BDS.
-Running the command gives you a list of files that have XDG compliance, you have instructions about **how to** move them. If a file doesn't support XDG compliance, `xdg-ninja` returns a link to the issue being discussed.
+Running the script gives you a list of files that have XDG compliance, you have instructions about **how to** remove them from your HOME. And if a file doesn't support XDG compliance, `xdg-ninja` returns a link to the issue being discussed on the internet.
### Installation
@@ -80,12 +86,14 @@ And now for each file they talk about I have to follow the instruction.
For example they tell me that the `$HOME/.gitconfig` can be moved in `~/.config/git/config`
+And you only have to do this for every file they list.
+
### Post cleaning
Now I have 20 folders in my home directory, that's better.
## Links
-- [List of programs supporting (or not) XDG BDS](https://wiki.archlinux.org/title/XDG_Base_Directory)
-- [Luke Smith video](https://www.youtube.com/watch?v=yy8RoDSdhIQ)
+- [List of programs supporting (or not) the XDG Base Directory Specification](https://wiki.archlinux.org/title/XDG_Base_Directory)
+- [Luke Smith video](https://videos.lukesmith.xyz/w/t5WcCYv58zDur45LRC1KFE)