Add more icon mappings and style improvements

Author: SimonSchubert

assets/basics/backupimaging.md

@@ -12,7 +12,7 @@ A good backup follows the **3-2-1 rule**: keep **3** copies of your data, on **2
 | **Push to cloud storage** | `[rclone](/man/rclone)` |
 | **Snapshot a live filesystem** | `[lvm](/man/lvm)`, `[btrfs](/man/btrfs)`, `[zfs](/man/zfs)` |
 
-> A backup you have never restored is only a hope. Test your restores regularly.
+**Test your restores regularly** - a backup you have never restored is only a hope.
 
 ## File Backups with rsync
 `rsync` copies only the differences between source and destination, which makes repeat backups fast. The `-a` (archive) flag preserves permissions, timestamps, symlinks, and ownership.
@@ -35,7 +35,7 @@ A trailing slash on the source matters: `src/` copies the **contents** of src, w
 | **--exclude** | Skip matching paths |
 | **--progress** | Show per-file progress |
 
-> Always do a `--dry-run` first when using `--delete`, so you can confirm nothing important will be wiped.
+**Always dry-run first:** when using `--delete`, do a `--dry-run` so you can confirm nothing important will be wiped.
 
 ## Backups over SSH
 When either side of an `rsync` is `user@host:path`, the transfer runs over SSH automatically, still copying only changes. Add `-z` to compress on slow links.
@@ -71,7 +71,7 @@ To restore, extract the full archive first, then each incremental in order.
 Stream an archive straight to a remote host without a temporary file.
 ```[tar](/man/tar) czf - /data | [ssh](/man/ssh) user@host "cat > /backup/data.tar.gz"```
 
-> See the **Compression & Archiving** basics page for the full set of `tar`, `gzip`, `xz`, and `zstd` options.
+See the **Compression & Archiving** basics page for the full set of `tar`, `gzip`, `xz`, and `zstd` options.
 
 ## Snapshot & Dedup Tools
 Dedicated backup programs add deduplication, encryption, compression, and retention policies on top of plain copies. They store each file's blocks once, so re-running a backup is cheap.
@@ -101,7 +101,7 @@ Test a restore by extracting a snapshot to a scratch directory, or mount the rep
 ```[restic](/man/restic) -r /mnt/backup/repo restore latest --target /tmp/restore-test```
 ```[borg](/man/borg) mount /mnt/backup/repo /mnt/restore```
 
-> If the repository is encrypted, the backup is only as safe as the key and passphrase. Export the key and store it somewhere that is not inside the backup.
+**If the repository is encrypted, the backup is only as safe as the key and passphrase.** Export the key and store it somewhere that is not inside the backup.
 
 ## Databases & Live Data
 Copying a running database's files mid-write produces a corrupt backup. Dump to a consistent snapshot first, then back up the dump like any other file.
@@ -122,7 +122,7 @@ Save a partition to a compressed image file instead of another disk.
 Restore an image back onto a device.
 ```[gunzip](/man/gunzip) -c sda1.img.gz | [dd](/man/dd) of=/dev/sda1 bs=4M status=progress```
 
-> `dd` writes wherever you point it with no confirmation. A wrong `of=` value will destroy data instantly. Check the device name twice, then once more. Image only **unmounted** partitions, an image of a filesystem that is changing underneath you is inconsistent.
+**Careful:** `dd` writes wherever you point it with no confirmation. A wrong `of=` value will destroy data instantly. Check the device name twice, then once more. Image only **unmounted** partitions: an image of a filesystem that is changing underneath you is inconsistent.
 
 | Option | Description |
 |-----|-------------|
@@ -156,7 +156,7 @@ When a drive is failing, use `ddrescue` instead of `dd`: it retries bad sectors,
 `clonezilla` wraps these tools into a guided disk-cloning environment for bare-metal backups.
 ```[clonezilla](/man/clonezilla)```
 
-> For repairing a system that no longer boots, recovering deleted files with `testdisk` and `photorec`, and reading SMART health, see the **System Recovery** basics page.
+For repairing a system that no longer boots, recovering deleted files with `testdisk` and `photorec`, and reading SMART health, see the **System Recovery** basics page.
 
 ## Filesystem-level Snapshots
 Modern filesystems and volume managers can snapshot a live system instantly, giving you a stable, consistent view to back up from.
@@ -181,7 +181,7 @@ Btrfs and ZFS snapshots are even cheaper, create them read-only (`-r`) so the ba
 ```[snapper](/man/snapper) create --description "before upgrade"```
 ```[timeshift](/man/timeshift) --create```
 
-> Snapshots live on the same disk and are not a backup by themselves. Copy them somewhere else.
+**Snapshots live on the same disk and are not a backup by themselves.** Copy them somewhere else.
 
 ## Cloud & Remote Sync
 `rclone` syncs files to dozens of cloud providers (S3, Backblaze, Google Drive, and more) after a one-time `rclone config`.
@@ -193,7 +193,7 @@ Check what would change without transferring, verify a finished backup, or mount
 ```[rclone](/man/rclone) check /data remote:backup/data```
 ```[rclone](/man/rclone) mount remote:backup /mnt/remote```
 
-> Like `rsync --delete`, `rclone sync` makes the destination match the source, including deletions. Use `copy` when you only want to add files.
+**Careful:** like `rsync --delete`, `rclone sync` makes the destination match the source, including deletions. Use `copy` when you only want to add files.
 
 ## Verify & Automate
 A backup is only good if it is intact. Record checksums when you make a backup, then verify them on restore.
@@ -204,4 +204,4 @@ Schedule backups so they actually happen. Edit your crontab and add a nightly jo
 ```[crontab](/man/crontab) -e```
 ```0 2 * * * [rsync](/man/rsync) -a --delete /data/ /mnt/backup/data/```
 
-> Automate the backup, but verify restores by hand on a schedule. The only proven backup is one you have successfully restored.
+**Automate the backup, but verify restores by hand on a schedule.** The only proven backup is one you have successfully restored.

assets/basics/compressionarchiving.md

@@ -33,7 +33,7 @@ List the contents before extracting an archive from an untrusted source, and ext
 ```[tar](/man/tar) tf archive.tar.gz```
 ```[tar](/man/tar) xf archive.tar.gz path/inside/archive.txt```
 
-> A well-behaved archive contains a single top-level directory. If **tar tf** shows loose files instead, extract into a fresh directory with **-C** to avoid littering your current one.
+A well-behaved archive contains a single top-level directory. If **tar tf** shows loose files instead, extract into a fresh directory with **-C** to avoid littering your current one.
 
 ## Choosing a Compressor
 All compressors trade speed against ratio. As a rule of thumb: **zstd** is the modern default, **gzip** is the universal lowest common denominator, **xz** squeezes hardest when time does not matter.
@@ -61,7 +61,7 @@ Each has a matching decompressor.
 ```[unxz](/man/unxz) [file].xz```
 ```[unzstd](/man/unzstd) [file].zst```
 
-> These tools compress single files only. To compress a directory, **tar** it first or use **zip**.
+These tools compress single files only. To compress a directory, **tar** it first or use **zip**.
 
 On multi-core machines, **xz -T0** and **zstd -T0** use all cores, and **pigz** is a parallel drop-in for gzip.
 ```[xz](/man/xz) -T0 [file]```
@@ -90,7 +90,7 @@ Extract with **unzip**, into a specific directory with **-d**, or just inspect t
 ```[unzip](/man/unzip) -l archive.zip```
 ```[zipinfo](/man/zipinfo) archive.zip```
 
-> Zip does not preserve full Unix ownership and permissions. For system backups, stick to **tar**.
+Zip does not preserve full Unix ownership and permissions. For system backups, stick to **tar**.
 
 ## 7-Zip Archives
 **7z** offers very high compression ratios and strong AES-256 encryption. **a** adds to an archive, **x** extracts with full paths, **l** lists.
@@ -99,7 +99,7 @@ Extract with **unzip**, into a specific directory with **-d**, or just inspect t
 ```[7z](/man/7z) x archive.7z```
 ```[7z](/man/7z) l archive.7z```
 
-> Use **x** to extract, not **e**: the **e** command flattens all files into the current directory, discarding their paths.
+Use **x** to extract, not **e**: the **e** command flattens all files into the current directory, discarding their paths.
 
 ## Rar Archives
 Rar is a proprietary format; **unrar** extracts it.

assets/basics/emacstexteditor.md

@@ -14,7 +14,7 @@ Emacs keybindings use a shorthand notation: **C-** means hold Ctrl, and **M-** m
 | **C-g** | Cancel current command or operation |
 | **C-/** | Undo last change (also **C-x u**) |
 
-> Stuck in a command you did not mean to start? **C-g** cancels almost anything. The built-in interactive tutorial is at **C-h t**.
+Stuck in a command you did not mean to start? **C-g** cancels almost anything. The built-in interactive tutorial is at **C-h t**.
 
 ## Navigation
 Movement commands come in pairs: **C-** moves by small units, **M-** moves by larger units.
@@ -59,7 +59,7 @@ Mark a region with **C-SPC** to set the start point, then move the cursor to sel
 | **C-x C-+** | Increase text size |
 | **C-x C--** | Decrease text size |
 
-> Killed text accumulates in the **kill ring**, not just a single clipboard. Press **C-y** then repeat **M-y** to step back through everything you killed recently.
+Killed text accumulates in the **kill ring**, not just a single clipboard. Press **C-y** then repeat **M-y** to step back through everything you killed recently.
 
 ## Search and Replace
 Emacs uses incremental search: results appear as you type. Press **C-s** again to jump to the next match, **Enter** to stop at the current one, or **C-g** to cancel and return to where you started.
@@ -70,7 +70,7 @@ Emacs uses incremental search: results appear as you type. Press **C-s** again t
 | **C-r** | Search backward (incremental) |
 | **M-%** | Search and replace (query mode) |
 
-> In query replace, answer **y** to replace, **n** to skip, **!** to replace all remaining, **q** to stop.
+In query replace, answer **y** to replace, **n** to skip, **!** to replace all remaining, **q** to stop.
 
 ## Buffers and Windows
 Every open file lives in a **buffer**. Emacs can split the screen into multiple windows, each showing a buffer.

assets/basics/filesfolders.md

@@ -1,44 +1,54 @@
 # Files & Folders
 
 ## Navigating
-**pwd** shows where you are, **cd** moves you somewhere else.
+**pwd** prints the directory you're currently in.
 ```[pwd](/man/pwd)```
+
+**cd** moves you to another directory: give it a path, or use a shortcut.
 ```[cd](/man/cd) [path]```
+
+Go up one level, to the parent directory.
 ```[cd](/man/cd) ..```
+
+Go to your home directory (plain **cd** does the same).
 ```[cd](/man/cd) ~```
-```[cd](/man/cd) -```
 
-> **cd ..** goes to the parent directory, **cd ~** (or plain **cd**) to your home directory, and **cd -** back to wherever you were before.
+Jump back to the directory you were in before.
+```[cd](/man/cd) -```
 
 ## Listing Contents
 **ls** lists a directory. **-l** shows details, **-a** includes hidden files (names starting with a dot), **-h** prints human-readable sizes.
 ```[ls](/man/ls)```
 ```[ls](/man/ls) -lah```
+
+Sort by modification time, newest first. Add **-r** to reverse any sort order.
 ```[ls](/man/ls) -lt```
+
+Show nested directories as a tree.
 ```[tree](/man/tree)```
 
 Modern replacements add colors, icons, and git status.
 ```[eza](/man/eza) -la```
 ```[lsd](/man/lsd) -la```
 
-> **ls -lt** sorts by modification time, newest first. Add **-r** to reverse any sort order.
-
 ## Viewing Files
 **cat** prints a whole file, **less** lets you scroll and search through it (press **q** to quit, **/** to search). **bat** is a cat clone with syntax highlighting.
 ```[cat](/man/cat) [fileName]```
 ```[less](/man/less) [fileName]```
 ```[bat](/man/bat) [fileName]```
 
-Show only the beginning or end of a file. **tail -f** keeps following a file as it grows, ideal for logs.
+Show only the beginning or end of a file.
 ```[head](/man/head) -n 20 [fileName]```
 ```[tail](/man/tail) -n 20 [fileName]```
+
+**-f** keeps following a file as it grows, ideal for logs.
 ```[tail](/man/tail) -f [logFile]```
 
-Inspect what a file is and how big it is.
+Identify what kind of file something is.
 ```[file](/man/file) [fileName]```
-```[wc](/man/wc) [fileName]```
 
-> **wc** prints lines, words, and bytes. Use **wc -l** for just the line count.
+Count lines, words, and bytes. Use **-l** for just the line count.
+```[wc](/man/wc) [fileName]```
 
 ## Creating
 **touch** creates an empty file (or updates the timestamp of an existing one). **mkdir -p** creates nested directories in one step and does not complain if they already exist.
@@ -48,36 +58,42 @@ Inspect what a file is and how big it is.
 ```> [fileName]```
 
 ## Copying, Moving, Renaming
-**cp** copies, **mv** moves and renames (there is no separate rename command). Use **-r** to copy directories recursively.
+**cp** copies a file. Use **-r** to copy a directory and everything in it.
 ```[cp](/man/cp) [fileName] [newFileName]```
 ```[cp](/man/cp) -r [folder] [folderCopy]```
+
+**mv** both moves and renames; there is no separate rename command.
 ```[mv](/man/mv) [oldName] [newName]```
 ```[mv](/man/mv) [fileName] [targetFolder]/```
 
-> Both **cp** and **mv** overwrite existing targets without asking. Add **-i** to be prompted, or **-n** to never overwrite.
+**Careful:** both **cp** and **mv** overwrite existing targets without asking. Add **-i** to be prompted first, or **-n** to never overwrite.
 
 ## Deleting
-**rm** removes files, **-r** removes directories with everything in them. There is no undo.
+**rm** removes files. **-r** removes a directory and everything in it. **There is no undo** - deletion is permanent and immediate, so double-check first. Use **rm -ri** to confirm each deletion when unsure.
 ```[rm](/man/rm) [fileName]```
 ```[rm](/man/rm) -r [folderName]```
-```[rmdir](/man/rmdir) [emptyFolderName]```
 
-> **rm** deletes permanently and immediately. For anything you are not sure about, use the trash instead, or at least run **rm -ri** to confirm each deletion.
+**rmdir** removes a directory only if it is already empty.
+```[rmdir](/man/rmdir) [emptyFolderName]```
 
-Move files to the desktop trash instead of deleting them outright.
+Safer than **rm**: move files to the desktop trash, where they can be restored.
 ```[gio](/man/gio) trash [file]```
 ```[trash-put](/man/trash-put) [file]```
+
+List or empty the trash.
 ```[trash-list](/man/trash-list)```
 ```[trash-empty](/man/trash-empty)```
 ```[gio](/man/gio) trash --empty```
 
 ## Links
-A **symbolic link** is a pointer to a path; it breaks if the target moves. A **hard link** is a second name for the same file content and keeps working until all names are deleted.
+A **symbolic link** points to a path. It breaks if the target moves, but it's what you want in almost all cases.
 ```[ln](/man/ln) -s [target] [linkName]```
+
+A **hard link** is a second name for the same file content, working until all names are deleted. Hard links can't span filesystems or point at directories.
 ```[ln](/man/ln) [target] [linkName]```
-```[readlink](/man/readlink) -f [linkName]```
 
-> Symbolic links (**ln -s**) are what you want in almost all cases. Hard links cannot span filesystems or point at directories.
+Resolve a link to the real path it points at.
+```[readlink](/man/readlink) -f [linkName]```
 
 ## Permissions & Ownership
 Every file has an owner, a group, and permission bits for owner/group/others. **ls -l** shows them, **stat** shows everything.
@@ -108,7 +124,7 @@ Every file has an owner, a group, and permission bits for owner/group/others. **
 ```[grep](/man/grep) -rn "phrase" [folder]```
 ```[rg](/man/rg) "phrase"```
 
-> To find files by name, size, or age, see the **Search & Find** basics page.
+To find files by name, size, or age instead, see the **Search & Find** basics page.
 
 ## Comparing Files
 **diff -u** shows differences in the familiar patch format.

assets/basics/git.md

@@ -16,12 +16,13 @@ Changes move in two steps: **add** puts them in the staging area, **commit** tur
 ```[git](/man/git) add .```
 ```[git](/man/git) commit -m "describe the change"```
 
-Exchange commits with the remote repository.
+Stage interactively, hunk by hunk: ideal for committing only part of your changes.
+```[git](/man/git) add -p```
+
+Exchange commits with the remote repository. **pull** is **fetch** (download) plus **merge** in one step.
 ```[git](/man/git) push```
 ```[git](/man/git) pull```
 
-> **git add -p** stages interactively, hunk by hunk: ideal for committing only part of your changes. **git pull** is **fetch** (download) plus **merge** in one step.
-
 ## Branches
 Branches are cheap pointers to commits. **switch** changes branches, **-c** creates one; **checkout** is the older command that does both jobs.
 ```[git](/man/git) branch```
@@ -62,7 +63,7 @@ Fix the most recent commit (message or forgotten files), or undo a commit safely
 ```[git](/man/git) reset --soft HEAD~1```
 ```[git](/man/git) reset --hard HEAD~1```
 
-> **revert** is safe on shared branches because it only adds a commit. **reset --hard** and **--amend** rewrite history: avoid them on commits you have already pushed.
+**revert** is safe on shared branches because it only adds a commit. **reset --hard** and **--amend** rewrite history: avoid them on commits you have already pushed.
 
 Stop tracking files that are now in .gitignore but were committed earlier.
 ```[git](/man/git) rm -r --cached .```
@@ -76,7 +77,7 @@ Put uncommitted work aside to get a clean working directory, then bring it back
 ```[git](/man/git) stash pop```
 ```[git](/man/git) stash apply```
 
-> **pop** applies the stash and removes it from the list; **apply** keeps it around, useful when applying the same work to several branches.
+**pop** applies the stash and removes it from the list; **apply** keeps it around, useful when applying the same work to several branches.
 
 ## Tags
 Tags mark specific commits, typically releases. Annotated tags (**-a**) store author, date, and a message.
@@ -85,25 +86,25 @@ Tags mark specific commits, typically releases. Annotated tags (**-a**) store au
 ```[git](/man/git) tag -d [tagName]```
 ```[git](/man/git) push --tags```
 
-> Tags are not pushed by default. Push them explicitly with **--tags** or **git push origin [tagName]**.
+Tags are not pushed by default. Push them explicitly with **--tags** or **git push origin [tagName]**.
 
 ## Remotes
 A remote is a named URL of another copy of the repository; **origin** is the conventional name for the main one.
 ```[git](/man/git) remote -v```
 ```[git](/man/git) remote add [remoteName] [remoteURL]```
 ```[git](/man/git) fetch [remoteName]```
 ```[git](/man/git) pull [remoteName] [branchName]```
-```[git](/man/git) push -u [remoteName] [branchName]```
 
-> **push -u** links the local branch to the remote one, so future **git push** and **git pull** work without arguments.
+**push -u** links the local branch to the remote one, so future **git push** and **git pull** work without arguments.
+```[git](/man/git) push -u [remoteName] [branchName]```
 
 ## Rewriting History
 **rebase** replays your commits on top of another branch for a linear history; **cherry-pick** copies a single commit onto the current branch.
 ```[git](/man/git) rebase [branchName]```
 ```[git](/man/git) rebase -i HEAD~3```
 ```[git](/man/git) cherry-pick [commitHash]```
 
-> Interactive rebase (**-i**) lets you reorder, squash, and reword commits. As with **reset**, never rebase commits that others may already have pulled.
+Interactive rebase (**-i**) lets you reorder, squash, and reword commits. As with **reset**, never rebase commits that others may already have pulled.
 
 ## Getting Help
 ```[git](/man/git) help [command]```