From bbd34e24ec715fb97cfe30c5fee14768ab26d47b Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Tue, 11 Feb 2025 12:55:07 +0100 Subject: [PATCH 01/10] generate db with makefile --- Makefile | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 Makefile diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..123901c --- /dev/null +++ b/Makefile @@ -0,0 +1,27 @@ +help: ## Print the help message + @awk 'BEGIN {FS = ":.*?## "} /^[0-9a-zA-Z._-]+:.*?## / {printf "\033[36m%s\033[0m : %s\n", $$1, $$2}' $(MAKEFILE_LIST) | \ + sort | \ + column -s ':' -t + +articles != find * -type f -name "*.md" + +db.rec: $(articles) + for x in $^ ; do \ + sed -n '2,/^---$$/ {/^---$$/d; p}' "$$x" |\ + tr -d '"[]' ;\ + printf "file: %s\n\n" "$$x" ;\ + done > $@ + +default += db.rec + +.git/info/exclude: $(default) + echo $^ | tr ' ' '\n' > $@ + +default += .git/info/exclude + +.PHONY: database +database: $(default) ## Make a database for recfiles + +.PHONY: clean +clean: + $(RM) $(default) From b7729e5712edacb23219e764ae50fe2d7e8981ab Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Tue, 11 Feb 2025 13:06:37 +0100 Subject: [PATCH 02/10] generate articles with makefile --- Makefile | 10 ++++++++++ new.sh | 27 --------------------------- 2 files changed, 10 insertions(+), 27 deletions(-) delete mode 100755 new.sh diff --git a/Makefile b/Makefile index 123901c..1a07c26 100644 --- a/Makefile +++ b/Makefile @@ -22,6 +22,16 @@ default += .git/info/exclude .PHONY: database database: $(default) ## Make a database for recfiles +.PHONY: article +article: ## Write an article + @path=$$(find . -type d -printf '%P\n' | fzy); \ + read -p "Title: " title; \ + printf '%s\n' '---' >> $$path/$$title.md ; \ + printf 'title: "%s"\n' "$$title" >> $$path/$$title.md ; \ + printf 'tags: [ "%s" ]\n' "$$path" | sed 's#\/#", "#g' >> $$path/$$title.md ; \ + printf '%s\n\n' '---' >> $$path/$$title.md ;\ + $(EDITOR) +5 $$path/$$title.md + .PHONY: clean clean: $(RM) $(default) diff --git a/new.sh b/new.sh deleted file mode 100755 index f9985a8..0000000 --- a/new.sh +++ /dev/null @@ -1,27 +0,0 @@ -#!/bin/sh - -echo Select a category - -category="$(find . -type d -printf '%P\n' | fzy)" - -[ ! -d "$category" ] && mkdir "$category" - -echo Select a name - -read name - -filePath="$category/$(echo $name | sed 's/ /_/g').md" - -tagsList="$(echo \"$category | sed 's#\/#", "#g')\"" - -[ -e "$filePath" ] && $EDITOR "$filePath" && exit 0 - -echo "--- -title: \"$name\" -tags: [ $tagsList ] ---- - -" > "$filePath" - -$EDITOR "$filePath" - From fd850761f347f3c56bcfdf9a259772b38eaa1a47 Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Tue, 11 Feb 2025 13:21:05 +0100 Subject: [PATCH 03/10] add tags --- data/recfiles/Board_Games.md | 2 +- data/soft_https.md | 2 +- system/android.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/data/recfiles/Board_Games.md b/data/recfiles/Board_Games.md index 5556a97..91db4ca 100644 --- a/data/recfiles/Board_Games.md +++ b/data/recfiles/Board_Games.md @@ -1,6 +1,6 @@ --- title: "Board Games" -tags: [ "data", "recfiles" ] +tags: [ "data", "recfiles", "games" ] --- You can play with a board games database from boardgamegeek.com. diff --git a/data/soft_https.md b/data/soft_https.md index 4122f42..23e206b 100644 --- a/data/soft_https.md +++ b/data/soft_https.md @@ -1,6 +1,6 @@ --- title: "Soft Serve through https" -tags: [ "data", "git" ] +tags: [ "data", "git", "lfs" ] --- ## `http` Setup diff --git a/system/android.md b/system/android.md index 51c397f..3a18285 100644 --- a/system/android.md +++ b/system/android.md @@ -1,6 +1,6 @@ --- title: "android" -tags: [ "Documentation", "System" ] +tags: [ "Documentation", "System", "phone" ] --- # mtpfs From 481b34a472b5b25636e977877d3dfa0ee29b7b85 Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Tue, 11 Feb 2025 15:37:55 +0100 Subject: [PATCH 04/10] label make clean --- Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Makefile b/Makefile index 1a07c26..d471726 100644 --- a/Makefile +++ b/Makefile @@ -32,6 +32,6 @@ article: ## Write an article printf '%s\n\n' '---' >> $$path/$$title.md ;\ $(EDITOR) +5 $$path/$$title.md -.PHONY: clean +.PHONY: clean ## Remove all generated files clean: $(RM) $(default) From eeade3cdfbc08b935f6da08817a005076a1ccd09 Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Tue, 11 Feb 2025 18:04:03 +0100 Subject: [PATCH 05/10] automatically show dependencies --- Makefile | 17 ++++++++++++----- distros/arch/basic-install.md | 1 + networking/fail2ban.md | 1 + networking/ssh/sshfs.md | 1 + networking/ssh/tricks.md | 3 ++- 5 files changed, 17 insertions(+), 6 deletions(-) diff --git a/Makefile b/Makefile index d471726..c4e2977 100644 --- a/Makefile +++ b/Makefile @@ -7,10 +7,17 @@ articles != find * -type f -name "*.md" db.rec: $(articles) for x in $^ ; do \ - sed -n '2,/^---$$/ {/^---$$/d; p}' "$$x" |\ - tr -d '"[]' ;\ - printf "file: %s\n\n" "$$x" ;\ + sed -n '2,/^---$$/ {/^---$$/d; p}' "$$x" |\ + sed -e 's/\[ //' -e 's/ \]//' |\ + tr -d '"' ;\ + printf "file: %s\n\n" "$$x" ;\ done > $@ + recsel $@ -e "requires != ''" -CR title,requires |\ + while read title requires; do \ + IFS=', ' && for provider in $$requires; do \ + recset $@ -e "title = '$${provider}'" -f provides -a "$${title}" ;\ + done ;\ + done default += db.rec @@ -32,6 +39,6 @@ article: ## Write an article printf '%s\n\n' '---' >> $$path/$$title.md ;\ $(EDITOR) +5 $$path/$$title.md -.PHONY: clean ## Remove all generated files -clean: +.PHONY: clean +clean: ## Remove all generated files $(RM) $(default) diff --git a/distros/arch/basic-install.md b/distros/arch/basic-install.md index 36ca460..1a610e2 100644 --- a/distros/arch/basic-install.md +++ b/distros/arch/basic-install.md @@ -1,6 +1,7 @@ --- title: "basic-install" tags: [ "Documentation", "arch" ] +requires: [ "partitions", "time" ] --- Keyboard layout changed. diff --git a/networking/fail2ban.md b/networking/fail2ban.md index 0d2ab5b..01ef19d 100644 --- a/networking/fail2ban.md +++ b/networking/fail2ban.md @@ -1,6 +1,7 @@ --- title: "fail2ban" tags: [ "Documentation", "Networking" ] +requires: [ "ssh" ] --- # SSH Daemon Jail diff --git a/networking/ssh/sshfs.md b/networking/ssh/sshfs.md index 7498b17..2a25233 100644 --- a/networking/ssh/sshfs.md +++ b/networking/ssh/sshfs.md @@ -1,6 +1,7 @@ --- title: "sshfs" tags: [ "Documentation", "Networking" ] +requires: [ "ssh" ] --- # Mount diff --git a/networking/ssh/tricks.md b/networking/ssh/tricks.md index 574842e..0b8f575 100644 --- a/networking/ssh/tricks.md +++ b/networking/ssh/tricks.md @@ -1,6 +1,7 @@ --- -title: "ssh tricks" +title: "ssh-tricks" tags: [ "Documentation", "Networking", "ssh", "tricks" ] +requires: [ "ssh" ] --- Mount a remote filesystem locally with fuse-sshfs: From e4be8a852385e78ceaae5ae46be9420d51dbc969 Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Tue, 11 Feb 2025 19:09:37 +0100 Subject: [PATCH 06/10] allow any fuzzy finder --- Makefile | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Makefile b/Makefile index c4e2977..e1d19b9 100644 --- a/Makefile +++ b/Makefile @@ -1,3 +1,6 @@ +FZF != command -v sk || command -v fzy || command -v fzf || \ + { echo install a fuzzy finder && exit 1 ;} + help: ## Print the help message @awk 'BEGIN {FS = ":.*?## "} /^[0-9a-zA-Z._-]+:.*?## / {printf "\033[36m%s\033[0m : %s\n", $$1, $$2}' $(MAKEFILE_LIST) | \ sort | \ @@ -31,7 +34,7 @@ database: $(default) ## Make a database for recfiles .PHONY: article article: ## Write an article - @path=$$(find . -type d -printf '%P\n' | fzy); \ + @path=$$(find . -type d -printf '%P\n' | $(FZF)); \ read -p "Title: " title; \ printf '%s\n' '---' >> $$path/$$title.md ; \ printf 'title: "%s"\n' "$$title" >> $$path/$$title.md ; \ From b81fd55a876cc512a94d2929742872e456f29fca Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Tue, 11 Feb 2025 19:41:02 +0100 Subject: [PATCH 07/10] sort database by title --- Makefile | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Makefile b/Makefile index e1d19b9..ee83608 100644 --- a/Makefile +++ b/Makefile @@ -9,18 +9,21 @@ help: ## Print the help message articles != find * -type f -name "*.md" db.rec: $(articles) + printf '%s\n' '%rec: guide' > $@ + printf '%s\n\n' '%sort: title' >> $@ for x in $^ ; do \ sed -n '2,/^---$$/ {/^---$$/d; p}' "$$x" |\ sed -e 's/\[ //' -e 's/ \]//' |\ tr -d '"' ;\ printf "file: %s\n\n" "$$x" ;\ - done > $@ + done >> $@ recsel $@ -e "requires != ''" -CR title,requires |\ while read title requires; do \ IFS=', ' && for provider in $$requires; do \ recset $@ -e "title = '$${provider}'" -f provides -a "$${title}" ;\ done ;\ done + recfix --sort $@ default += db.rec From d92631c7956608ff0af2fadd4bf45d735afd3d9e Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Tue, 11 Feb 2025 20:38:45 +0100 Subject: [PATCH 08/10] add wordcount to database --- Makefile | 4 ++++ README.md | 8 ++++---- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/Makefile b/Makefile index ee83608..c9e731d 100644 --- a/Makefile +++ b/Makefile @@ -10,6 +10,7 @@ articles != find * -type f -name "*.md" db.rec: $(articles) printf '%s\n' '%rec: guide' > $@ + printf '%s\n' '%type: wordcount int' >> $@ printf '%s\n\n' '%sort: title' >> $@ for x in $^ ; do \ sed -n '2,/^---$$/ {/^---$$/d; p}' "$$x" |\ @@ -17,6 +18,9 @@ db.rec: $(articles) tr -d '"' ;\ printf "file: %s\n\n" "$$x" ;\ done >> $@ + for entry in $^; do \ + recset $@ -e "file = '$${entry}'" -f wordcount --set-add="$$(wc -w < $${entry})" ;\ + done recsel $@ -e "requires != ''" -CR title,requires |\ while read title requires; do \ IFS=', ' && for provider in $$requires; do \ diff --git a/README.md b/README.md index 65b2eca..4ed35a6 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,8 @@ --- -title: "Knowledge Base" +title: "Linux Knowledge Base" --- -# Linux Knowledgebase - -This is a list of quickstart guides for Linux programs, designed to get the user up and running as fast as possible. +The Linux Knowledge-Base provides quick-start guides for working with terminal programs. # Style @@ -79,12 +77,14 @@ ss -tr dst :$PORT - Often presumes you know everything except that one program. - Often written in the 80's, and it shows. - Zero respect for your time. +- Often references `info` pages (yuck). ## curl cheat.sh/ - Doesn't have the programs I like. - Too short to get you started on many programs. - Poor understanding of priority (`git stash` is covered before `git commit`). +- Repetitive # Current State From 9621cfc26a4c397e7b3425276891c04b2fb8b405 Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Tue, 11 Feb 2025 20:39:24 +0100 Subject: [PATCH 09/10] rewrite introduction --- Makefile | 2 +- README.md | 88 +++++++++++++++++++++++++------------------------------ 2 files changed, 41 insertions(+), 49 deletions(-) diff --git a/Makefile b/Makefile index c9e731d..5eefb86 100644 --- a/Makefile +++ b/Makefile @@ -37,7 +37,7 @@ default += db.rec default += .git/info/exclude .PHONY: database -database: $(default) ## Make a database for recfiles +database: $(default) ## Make a recfiles database .PHONY: article article: ## Write an article diff --git a/README.md b/README.md index 4ed35a6..99ce3df 100644 --- a/README.md +++ b/README.md @@ -4,72 +4,64 @@ title: "Linux Knowledge Base" The Linux Knowledge-Base provides quick-start guides for working with terminal programs. +# Setup + +Install `make`, `recutils`, and any fuzzy-finder (i.e. `sk`, `fzy`, or `fzf`). + +Usage: `make` + # Style -## Praxis Only +## No History, No Context -We leave theory alone as much as possible. -The documentation should be of the form 'if you want *X*, type *Y*'. +- Nobody cares about how the project started. +- Nobody wants to read what `ffmpeg` is, because anyone who wants to use it already knows what it is. -We don't need to explain what a program does - anyone looking up 'how to X', already knows what they want to do. -We don't even need to explain which program to use - if someone wants to combine an mp4 and webm video into a single video file, they only care about that result, not about learning `ffmpeg`. +## Be Opinionated -Any interest in these tools only comes after we can use them. +- Guides should not ask the reader to select options half-way through. +- Options for different filesystems, databases, et c., should be written as separate guides. -## Chronological +## Repetition Beats Reference -Entries should read like scripts - everything in the right order, with small notes on what this does. +If a database requires three commands to set up, it's better to repeat those three commands for every program that requires a database than to just link to another file which discusses databases. -The chronology should never branch. -If `gitea` can use three different types of database, the documentation should simply pick one and continue instructions from there. -Repetition works better than a reference - if a database requires three commands to set up, it's better to repeat those three commands for every program that requires a database than to just link to another file which discusses databases. +## Show Arguments as Variables ---- +Look at this line: -### Closing - -Introductory documents should show anything required to cleanly uninstall a program, without leaving bulky configuration files behind. - -## Three Input Types - -There are three types of examples: - -Fixed input: - -```bash -ls +```sh +grep ls --color=always $HISTFILE | less -R ``` -Anything with arbitrary input should be shown as a variable. +What else can go in place of `always`? +Can you say `--color=red`? +Can you put anything? +The answer is not obvious. -```bash -ls $FILE +What about this line: + +```sh +git branch new +git checkout new ``` -Non-commands (e.g. output) should be shown as quoted text: +Do you always use `new`? +Can you use another word here? +The answer is not obvious. -> LK img -> Mail kn -> Projects music - ---- - -# Example - -``` -How to see which websites you're actively accessing: - -` ` `bash -ss -tr dst :$PORT -` ` ` - -> State Recv-Q Send-Q Local Address:Port Peer Address:Port Process -> ESTAB 0 0 192.168.0.14:42476 149.154.167.91:https -> ESTAB 0 0 192.168.0.14:43644 104.17.90.199:https +It's better to make all arbitrary values variables. +```sh +git branch $branch_name +git checkout $branch_name +PAGER='less -R' +grep ls --color=always $HISTFILE | $PAGER ``` -# What's wrong with everything else? +Now we can see what can be changed. + +# What's Wrong with Everything Else? ## Man pages @@ -79,7 +71,7 @@ ss -tr dst :$PORT - Zero respect for your time. - Often references `info` pages (yuck). -## curl cheat.sh/ +## `curl cheat.sh` - Doesn't have the programs I like. - Too short to get you started on many programs. From ef7b4245864537e34cf52e18b67631b4b3ad5377 Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Tue, 11 Feb 2025 20:47:50 +0100 Subject: [PATCH 10/10] remove redundant Documentation tag --- basics/at.md | 2 +- basics/basics.md | 2 +- basics/clock.md | 2 +- basics/conditionals.md | 2 +- basics/cron.md | 2 +- basics/games.md | 2 +- basics/kernel.md | 2 +- basics/kill.md | 2 +- basics/locale.md | 2 +- basics/locating.md | 2 +- basics/processes.md | 2 +- basics/time.md | 2 +- basics/users.md | 2 +- chat/profanity-otr.md | 2 +- chat/profanity.md | 2 +- chat/wgetpaste.md | 2 +- data/backups/archives.md | 2 +- data/backups/unison.md | 2 +- data/base_16.md | 2 +- data/exiftool.md | 2 +- data/git/basics.md | 2 +- data/git/git-lfs.md | 2 +- data/git/hooks.md | 2 +- data/git/subtree.md | 2 +- data/gpg.md | 2 +- data/gpg/basics.md | 2 +- data/gpg/extras.md | 2 +- data/groff.md | 2 +- data/khard.md | 2 +- data/newsboat.md | 2 +- data/pass.md | 2 +- data/pdf-to-txt.md | 2 +- data/pdf_erasure.md | 2 +- data/sc-im.md | 2 +- data/sqlite.md | 2 +- data/taskwarrior/task.md | 2 +- data/taskwarrior/timew.md | 2 +- data/w3m.md | 2 +- distros/arch/arch_pi_install.md | 2 +- distros/arch/autologin.md | 2 +- distros/arch/basic-install.md | 2 +- distros/arch/fonts.md | 2 +- distros/arch/gpu.md | 2 +- distros/arch/pacman.md | 2 +- distros/debian/apt.md | 2 +- distros/void/aeroplanes.md | 2 +- distros/void/autologin.md | 2 +- distros/void/extrace.md | 2 +- distros/void/sv.md | 2 +- distros/void/void_basics.md | 2 +- distros/void/xbps.md | 2 +- hardware/brightness.md | 2 +- hardware/keyboard.md | 2 +- hardware/monitor.md | 2 +- hardware/printers.md | 2 +- networking/fail2ban.md | 2 +- networking/graph-easy.md | 2 +- networking/iptables.md | 2 +- networking/nmap.md | 2 +- networking/pi-hole-server.md | 2 +- networking/rclone.md | 2 +- networking/scraping/youtube-dl.md | 2 +- networking/servers/agate.md | 2 +- networking/ssh/sshfs.md | 2 +- networking/ssh/tricks.md | 2 +- networking/tor.md | 2 +- networking/transmission.md | 2 +- networking/troubleshooting.md | 2 +- networking/website/nginx.md | 2 +- networking/wifi.md | 2 +- networking/wireguard.md | 2 +- networking/wireless.md | 2 +- networking/wpa_supplicant.md | 2 +- sound/basics.md | 2 +- sound/festival.md | 2 +- sound/mpd.md | 2 +- sound/ncmpcpp.md | 2 +- system/android.md | 2 +- system/awk.md | 2 +- system/bash_tricks.md | 2 +- system/character-encoding.md | 2 +- system/default_programs.md | 2 +- system/editors.md | 2 +- system/fstab.md | 2 +- system/kernel.md | 2 +- system/lf.md | 2 +- system/logs.md | 2 +- system/mdadm.md | 2 +- system/monitoring.md | 2 +- system/partitions.md | 2 +- system/snaps.md | 2 +- system/swap.md | 2 +- system/systemd/journal.md | 2 +- system/systemd/making-services.md | 2 +- system/systemd/systemd_basics.md | 2 +- system/tmux.md | 2 +- vim/basic_vim.md | 2 +- vim/navigate.md | 2 +- vim/vim-completion.md | 2 +- vim/vim-search.md | 2 +- vim/vim-windows.md | 2 +- vim/vim_tricks.md | 2 +- virtualization/virtualbox.md | 2 +- virtualization/xen/xen_basics.md | 2 +- vision/QR_Codes.md | 2 +- vision/ffmpeg.md | 2 +- vision/imagemagick.md | 2 +- vision/lowdown.md | 2 +- 108 files changed, 108 insertions(+), 108 deletions(-) diff --git a/basics/at.md b/basics/at.md index 6f1c33b..42cff76 100644 --- a/basics/at.md +++ b/basics/at.md @@ -1,6 +1,6 @@ --- title: "at" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- Install with: diff --git a/basics/basics.md b/basics/basics.md index e744d3d..47a4f2e 100644 --- a/basics/basics.md +++ b/basics/basics.md @@ -1,6 +1,6 @@ --- title: "Basics" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- You need about a dozen commands to move around Linux. diff --git a/basics/clock.md b/basics/clock.md index 6397141..0f36e2a 100644 --- a/basics/clock.md +++ b/basics/clock.md @@ -1,6 +1,6 @@ --- title: "clock" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- Show system time: diff --git a/basics/conditionals.md b/basics/conditionals.md index d900a47..a251456 100644 --- a/basics/conditionals.md +++ b/basics/conditionals.md @@ -1,6 +1,6 @@ --- title: "conditionals" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- # If statements diff --git a/basics/cron.md b/basics/cron.md index b749090..98db527 100644 --- a/basics/cron.md +++ b/basics/cron.md @@ -1,6 +1,6 @@ --- title: "cron" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- # Cronie diff --git a/basics/games.md b/basics/games.md index c0b3c64..a5ac35a 100644 --- a/basics/games.md +++ b/basics/games.md @@ -1,6 +1,6 @@ --- title: "bash games" -tags: [ "Documentation", "Games" ] +tags: [ "Games" ] --- Games are a great way to learn bash. diff --git a/basics/kernel.md b/basics/kernel.md index 43432af..3989904 100644 --- a/basics/kernel.md +++ b/basics/kernel.md @@ -1,6 +1,6 @@ --- title: "kernel" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- ## Living Space diff --git a/basics/kill.md b/basics/kill.md index 8f0c805..49d834a 100644 --- a/basics/kill.md +++ b/basics/kill.md @@ -1,6 +1,6 @@ --- title: "kill" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- If you want to kill a program in a graphical environment, open a terminal and type: diff --git a/basics/locale.md b/basics/locale.md index 69572b5..52014e9 100644 --- a/basics/locale.md +++ b/basics/locale.md @@ -1,6 +1,6 @@ --- title: "locale" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- Your locale tells the computer your location, preferred time-and-date format, standard language, papersize, et c. diff --git a/basics/locating.md b/basics/locating.md index c146a9f..f710007 100644 --- a/basics/locating.md +++ b/basics/locating.md @@ -1,6 +1,6 @@ --- title: "locating" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- # Type diff --git a/basics/processes.md b/basics/processes.md index 9d373a6..393515d 100644 --- a/basics/processes.md +++ b/basics/processes.md @@ -1,6 +1,6 @@ --- title: "processes" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- # Proccesses diff --git a/basics/time.md b/basics/time.md index f99bf89..157bc19 100644 --- a/basics/time.md +++ b/basics/time.md @@ -1,6 +1,6 @@ --- title: "time" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- # systemd diff --git a/basics/users.md b/basics/users.md index 3c09172..f45ab45 100644 --- a/basics/users.md +++ b/basics/users.md @@ -1,6 +1,6 @@ --- title: "users" -tags: [ "Documentation", "Basics" ] +tags: [ "Basics" ] --- # Basic Information diff --git a/chat/profanity-otr.md b/chat/profanity-otr.md index 236254b..2f8bf6c 100644 --- a/chat/profanity-otr.md +++ b/chat/profanity-otr.md @@ -1,6 +1,6 @@ --- title: "profanity" -tags: [ "Documentation", "Chat", "OTR" ] +tags: [ "Chat", "OTR" ] --- # otr diff --git a/chat/profanity.md b/chat/profanity.md index 8e484e8..1c2554a 100644 --- a/chat/profanity.md +++ b/chat/profanity.md @@ -1,6 +1,6 @@ --- title: "profanity" -tags: [ "Documentation", "Chat", "omemo" ] +tags: [ "Chat", "omemo" ] --- # Setup (Commands) diff --git a/chat/wgetpaste.md b/chat/wgetpaste.md index 9d85b5e..60fa074 100644 --- a/chat/wgetpaste.md +++ b/chat/wgetpaste.md @@ -1,6 +1,6 @@ --- title: "wgetpaste" -tags: [ "Documentation", "Chat" ] +tags: [ "Chat" ] --- See available pastebins: diff --git a/data/backups/archives.md b/data/backups/archives.md index e5e5129..98a9c7e 100644 --- a/data/backups/archives.md +++ b/data/backups/archives.md @@ -1,6 +1,6 @@ --- title: "Archives" -tags: [ "Documentation", "tar", "backups" ] +tags: [ "tar", "backups" ] --- # `tar` diff --git a/data/backups/unison.md b/data/backups/unison.md index e32108d..262b64f 100644 --- a/data/backups/unison.md +++ b/data/backups/unison.md @@ -1,6 +1,6 @@ --- title: "unison" -tags: [ "Documentation", "Backups" ] +tags: [ "Backups" ] --- Install unison on both machines, and make sure both have the same version of unison, with the same version of the ocaml compiler (the smallest difference will cause problems). diff --git a/data/base_16.md b/data/base_16.md index 7686ca5..b283c4c 100644 --- a/data/base_16.md +++ b/data/base_16.md @@ -1,6 +1,6 @@ --- title: "Base 16" -tags: [ "Documentation", "Data" ] +tags: [ "Data" ] --- ```bash diff --git a/data/exiftool.md b/data/exiftool.md index 86cb6bf..6040c4e 100644 --- a/data/exiftool.md +++ b/data/exiftool.md @@ -1,6 +1,6 @@ --- title: "exiftool" -tags: [ "Documentation", "Metadata" ] +tags: [ "Metadata" ] --- Find metadata. diff --git a/data/git/basics.md b/data/git/basics.md index f3e8d40..fc27897 100644 --- a/data/git/basics.md +++ b/data/git/basics.md @@ -1,6 +1,6 @@ --- title: "git" -tags: [ "Documentation", "data" ] +tags: [ "data" ] --- # Starting diff --git a/data/git/git-lfs.md b/data/git/git-lfs.md index 52e7a74..604eca5 100644 --- a/data/git/git-lfs.md +++ b/data/git/git-lfs.md @@ -1,6 +1,6 @@ --- title: "git-lfs" -tags: [ "Documentation", "data" ] +tags: [ "data" ] --- Install, and add with diff --git a/data/git/hooks.md b/data/git/hooks.md index 652b61c..de09c2b 100644 --- a/data/git/hooks.md +++ b/data/git/hooks.md @@ -1,6 +1,6 @@ --- title: "git hooks" -tags: [ "Documentation", "data", "git" ] +tags: [ "data", "git" ] --- Check out the sample hooks: diff --git a/data/git/subtree.md b/data/git/subtree.md index d077680..b467954 100644 --- a/data/git/subtree.md +++ b/data/git/subtree.md @@ -1,6 +1,6 @@ --- title: "git" -tags: [ "Documentation", "data", "git", "subtree" ] +tags: [ "data", "git", "subtree" ] --- ## Pulling a Subtree from an existing git diff --git a/data/gpg.md b/data/gpg.md index b00a719..3f0bd28 100644 --- a/data/gpg.md +++ b/data/gpg.md @@ -1,6 +1,6 @@ --- title: "gpg" -tags: [ "Documentation", "data", "GPG" ] +tags: [ "data", "GPG" ] --- - [Setup](gpg/basics.md) diff --git a/data/gpg/basics.md b/data/gpg/basics.md index 96ddbbf..ecc0f8d 100644 --- a/data/gpg/basics.md +++ b/data/gpg/basics.md @@ -1,6 +1,6 @@ --- title: "GPG Basics" -tags: [ "Documentation", "data", "GPG" ] +tags: [ "data", "GPG" ] --- # Making keys diff --git a/data/gpg/extras.md b/data/gpg/extras.md index 47980b7..a36297d 100644 --- a/data/gpg/extras.md +++ b/data/gpg/extras.md @@ -1,6 +1,6 @@ --- title: "gpg" -tags: [ "Documentation", "vim", "data", "GPG" ] +tags: [ "vim", "data", "GPG" ] --- The `vim-gnupg` plugin lets vim edit gpg-encrypted files as if they were unencrypted. diff --git a/data/groff.md b/data/groff.md index b5a6290..452ffc3 100644 --- a/data/groff.md +++ b/data/groff.md @@ -1,6 +1,6 @@ --- title: "groff" -tags: [ "Documentation", "Data" ] +tags: [ "Data" ] --- # Basic Documents diff --git a/data/khard.md b/data/khard.md index 30cb84d..9c9fa59 100644 --- a/data/khard.md +++ b/data/khard.md @@ -1,6 +1,6 @@ --- title: "khard" -tags: [ "Documentation", "Data" ] +tags: [ "Data" ] --- Get the basic config: diff --git a/data/newsboat.md b/data/newsboat.md index bcab08e..7bca831 100644 --- a/data/newsboat.md +++ b/data/newsboat.md @@ -1,6 +1,6 @@ --- title: "newsboat" -tags: [ "Documentation", "RSS" ] +tags: [ "RSS" ] --- Create the configuration directory before you start, and add at least 1 URL. diff --git a/data/pass.md b/data/pass.md index 1d1b9b8..c10a847 100644 --- a/data/pass.md +++ b/data/pass.md @@ -1,6 +1,6 @@ --- title: "pass" -tags: [ "Documentation", "data" ] +tags: [ "data" ] --- [Video instructions](https://www.hooktube.com/watch?v=hlRQTj1D9LA) diff --git a/data/pdf-to-txt.md b/data/pdf-to-txt.md index cbc4fc8..2367cef 100644 --- a/data/pdf-to-txt.md +++ b/data/pdf-to-txt.md @@ -1,6 +1,6 @@ --- title: "pdf to txt" -tags: [ "Documentation", "data", "pdf", "ocr" ] +tags: [ "data", "pdf", "ocr" ] --- How to translate pdf book images to text (results are very poor, and will need lots of corrections). diff --git a/data/pdf_erasure.md b/data/pdf_erasure.md index 2f3947d..8329fa2 100644 --- a/data/pdf_erasure.md +++ b/data/pdf_erasure.md @@ -1,6 +1,6 @@ --- title: "PDF Metadata Erasure" -tags: [ "Documentation", "Metadata", "Ghost Script" ] +tags: [ "Metadata", "Ghost Script" ] --- Make a text file called 'pdfmark.txt'. diff --git a/data/sc-im.md b/data/sc-im.md index 1b457ed..4ff1a83 100644 --- a/data/sc-im.md +++ b/data/sc-im.md @@ -1,6 +1,6 @@ --- title: "sc-im" -tags: [ "Documentation", "TUI", "data" ] +tags: [ "TUI", "data" ] --- - [Sample file](sc-im/sample.sc) diff --git a/data/sqlite.md b/data/sqlite.md index 77d3eb7..fcaa060 100644 --- a/data/sqlite.md +++ b/data/sqlite.md @@ -1,6 +1,6 @@ --- title: "sqlite" -tags: [ "Documentation", "data" ] +tags: [ "data" ] --- Work with a database: diff --git a/data/taskwarrior/task.md b/data/taskwarrior/task.md index 01eee0a..5ab0ea8 100644 --- a/data/taskwarrior/task.md +++ b/data/taskwarrior/task.md @@ -1,6 +1,6 @@ --- title: "task" -tags: [ "Documentation", "Organization" ] +tags: [ "Organization" ] --- Set up the configuration file: diff --git a/data/taskwarrior/timew.md b/data/taskwarrior/timew.md index aa1e4d1..bc4e229 100644 --- a/data/taskwarrior/timew.md +++ b/data/taskwarrior/timew.md @@ -1,6 +1,6 @@ --- title: "timew" -tags: [ "Documentation", "Data" ] +tags: [ "Data" ] --- # Summaries diff --git a/data/w3m.md b/data/w3m.md index c322eb2..3807769 100644 --- a/data/w3m.md +++ b/data/w3m.md @@ -1,6 +1,6 @@ --- title: "w3m" -tags: [ "Documentation", "browsers" ] +tags: [ "browsers" ] --- Open a search tab: diff --git a/distros/arch/arch_pi_install.md b/distros/arch/arch_pi_install.md index 9eb6535..cedd69c 100644 --- a/distros/arch/arch_pi_install.md +++ b/distros/arch/arch_pi_install.md @@ -1,6 +1,6 @@ --- title: "Arch on a Raspberry Pi 4" -tags: [ "Documentation", "distros", "raspberry pi", "rpi" ] +tags: [ "distros", "raspberry pi", "rpi" ] --- The [Official Instructions](https://archlinuxarm.org/platforms/armv8/broadcom/raspberry-pi-4) for a Raspberry pi 4 do not allow for working sound from the headphone jack, unless you use the aarch64 Installation. diff --git a/distros/arch/autologin.md b/distros/arch/autologin.md index d937aec..c2fab61 100644 --- a/distros/arch/autologin.md +++ b/distros/arch/autologin.md @@ -1,6 +1,6 @@ --- title: "autologin" -tags: [ "Documentation", "Distros", "Arch" ] +tags: [ "Distros", "Arch" ] --- # Automatic Login diff --git a/distros/arch/basic-install.md b/distros/arch/basic-install.md index 1a610e2..bc894f9 100644 --- a/distros/arch/basic-install.md +++ b/distros/arch/basic-install.md @@ -1,6 +1,6 @@ --- title: "basic-install" -tags: [ "Documentation", "arch" ] +tags: [ "arch" ] requires: [ "partitions", "time" ] --- Keyboard layout changed. diff --git a/distros/arch/fonts.md b/distros/arch/fonts.md index 9e99e11..9fef2f7 100644 --- a/distros/arch/fonts.md +++ b/distros/arch/fonts.md @@ -1,6 +1,6 @@ --- title: "fonts" -tags: [ "Documentation", "distros" ] +tags: [ "distros" ] --- # Basics diff --git a/distros/arch/gpu.md b/distros/arch/gpu.md index af74d47..33b7e94 100644 --- a/distros/arch/gpu.md +++ b/distros/arch/gpu.md @@ -1,6 +1,6 @@ --- title: "fonts" -tags: [ "Documentation", "distros" ] +tags: [ "distros" ] --- # Step 1: Multilib diff --git a/distros/arch/pacman.md b/distros/arch/pacman.md index 2514cee..a286142 100644 --- a/distros/arch/pacman.md +++ b/distros/arch/pacman.md @@ -1,6 +1,6 @@ --- title: "pacman" -tags: [ "Documentation", "distros" ] +tags: [ "distros" ] --- Packages are kept in /var/cache/pacman/pkg. diff --git a/distros/debian/apt.md b/distros/debian/apt.md index 497033f..4a972fe 100644 --- a/distros/debian/apt.md +++ b/distros/debian/apt.md @@ -1,6 +1,6 @@ --- title: "apt" -tags: [ "Documentation", "distros" ] +tags: [ "distros" ] --- ## apt diff --git a/distros/void/aeroplanes.md b/distros/void/aeroplanes.md index 6215e85..8e25a17 100644 --- a/distros/void/aeroplanes.md +++ b/distros/void/aeroplanes.md @@ -1,6 +1,6 @@ --- title: "Aeroplane Mode in Void" -tags: [ "Documentation", "Void" ] +tags: [ "Void" ] --- Put your device in 'aeroplane' mode (e.g. where no trace of signal leaves it) by turning off Wi-Fi and blue-tooth. diff --git a/distros/void/autologin.md b/distros/void/autologin.md index d2b6e8b..c2a3b52 100644 --- a/distros/void/autologin.md +++ b/distros/void/autologin.md @@ -1,6 +1,6 @@ --- title: "Void Autologin" -tags: [ "Documentation", "Void" ] +tags: [ "Void" ] --- Make the autologin service: diff --git a/distros/void/extrace.md b/distros/void/extrace.md index ff0dd94..d5b5bd0 100644 --- a/distros/void/extrace.md +++ b/distros/void/extrace.md @@ -1,6 +1,6 @@ --- title: "extrace" -tags: [ "Documentation", "Void" ] +tags: [ "Void" ] --- Monitor all processes: diff --git a/distros/void/sv.md b/distros/void/sv.md index fe230bd..c8ae1bb 100644 --- a/distros/void/sv.md +++ b/distros/void/sv.md @@ -1,6 +1,6 @@ --- title: "sv" -tags: [ "Documentation", "Void" ] +tags: [ "Void" ] --- # List Services diff --git a/distros/void/void_basics.md b/distros/void/void_basics.md index fdb890d..c7194a2 100644 --- a/distros/void/void_basics.md +++ b/distros/void/void_basics.md @@ -1,6 +1,6 @@ --- title: "Void Linux Basics" -tags: [ "Documentation", "Void" ] +tags: [ "Void" ] --- # Updates diff --git a/distros/void/xbps.md b/distros/void/xbps.md index 3c78f59..c4340b5 100644 --- a/distros/void/xbps.md +++ b/distros/void/xbps.md @@ -1,6 +1,6 @@ --- title: "xbps" -tags: [ "Documentation", "Void" ] +tags: [ "Void" ] --- ## Search diff --git a/hardware/brightness.md b/hardware/brightness.md index c13f430..0f01137 100644 --- a/hardware/brightness.md +++ b/hardware/brightness.md @@ -1,6 +1,6 @@ --- title: "brightness" -tags: [ "Documentation", "hardware" ] +tags: [ "hardware" ] --- # Brightness diff --git a/hardware/keyboard.md b/hardware/keyboard.md index 4f93722..b4a6a88 100644 --- a/hardware/keyboard.md +++ b/hardware/keyboard.md @@ -1,6 +1,6 @@ --- title: "keyboard" -tags: [ "Documentation", "keyboard", "vim" ] +tags: [ "keyboard", "vim" ] --- # System-Wide Capslock and Escape Swap diff --git a/hardware/monitor.md b/hardware/monitor.md index a01d92e..98a46ac 100644 --- a/hardware/monitor.md +++ b/hardware/monitor.md @@ -1,6 +1,6 @@ --- title: "monitor" -tags: [ "Documentation", "hardware" ] +tags: [ "hardware" ] --- See screen size diff --git a/hardware/printers.md b/hardware/printers.md index f390dc7..b3b59c3 100644 --- a/hardware/printers.md +++ b/hardware/printers.md @@ -1,6 +1,6 @@ --- title: "printers" -tags: [ "Documentation", "hardware" ] +tags: [ "hardware" ] --- # Cups: The Common Unix Printing System diff --git a/networking/fail2ban.md b/networking/fail2ban.md index 01ef19d..c7866d1 100644 --- a/networking/fail2ban.md +++ b/networking/fail2ban.md @@ -1,6 +1,6 @@ --- title: "fail2ban" -tags: [ "Documentation", "Networking" ] +tags: [ "Networking" ] requires: [ "ssh" ] --- # SSH Daemon Jail diff --git a/networking/graph-easy.md b/networking/graph-easy.md index f018cc3..8aab816 100644 --- a/networking/graph-easy.md +++ b/networking/graph-easy.md @@ -1,6 +1,6 @@ --- title: "Easy Network Graph" -tags: [ "Documentation", "Networking" ] +tags: [ "Networking" ] --- Set up a file like this, called `troubleshooting.txt`. diff --git a/networking/iptables.md b/networking/iptables.md index 04805b9..302a0fe 100644 --- a/networking/iptables.md +++ b/networking/iptables.md @@ -1,6 +1,6 @@ --- title: "iptables" -tags: [ "Documentation", "Networking" ] +tags: [ "Networking" ] --- # Intro diff --git a/networking/nmap.md b/networking/nmap.md index 377f9ec..98927f1 100644 --- a/networking/nmap.md +++ b/networking/nmap.md @@ -1,6 +1,6 @@ --- title: "nmap" -tags: [ "Documentation", "Networking" ] +tags: [ "Networking" ] --- Example: diff --git a/networking/pi-hole-server.md b/networking/pi-hole-server.md index 6da73ff..0044d28 100644 --- a/networking/pi-hole-server.md +++ b/networking/pi-hole-server.md @@ -1,6 +1,6 @@ --- title: "pi-hole-server" -tags: [ "Documentation", "Distros" ] +tags: [ "Distros" ] --- # Installation diff --git a/networking/rclone.md b/networking/rclone.md index cad738c..ad90260 100644 --- a/networking/rclone.md +++ b/networking/rclone.md @@ -1,6 +1,6 @@ --- title: "rclone" -tags: [ "Documentation", "Networking" ] +tags: [ "Networking" ] --- The manpage's 'Synopsis' provides a fast reference. ``` diff --git a/networking/scraping/youtube-dl.md b/networking/scraping/youtube-dl.md index 6947ed1..c42d2e5 100644 --- a/networking/scraping/youtube-dl.md +++ b/networking/scraping/youtube-dl.md @@ -1,6 +1,6 @@ --- title: "Download videos" -tags: [ "Documentation", "Scraping" ] +tags: [ "Scraping" ] --- Install `yt-dlp`. diff --git a/networking/servers/agate.md b/networking/servers/agate.md index 1924850..a082584 100644 --- a/networking/servers/agate.md +++ b/networking/servers/agate.md @@ -1,6 +1,6 @@ --- title: "Agate on Arch Linux" -tags: [ "Documentation", "Networking", "Arch", "Gemini" ] +tags: [ "Networking", "Arch", "Gemini" ] --- Docs are [here](https://github.com/mbrubeck/agate). diff --git a/networking/ssh/sshfs.md b/networking/ssh/sshfs.md index 2a25233..e6cc426 100644 --- a/networking/ssh/sshfs.md +++ b/networking/ssh/sshfs.md @@ -1,6 +1,6 @@ --- title: "sshfs" -tags: [ "Documentation", "Networking" ] +tags: [ "Networking" ] requires: [ "ssh" ] --- # Mount diff --git a/networking/ssh/tricks.md b/networking/ssh/tricks.md index 0b8f575..d2f148f 100644 --- a/networking/ssh/tricks.md +++ b/networking/ssh/tricks.md @@ -1,6 +1,6 @@ --- title: "ssh-tricks" -tags: [ "Documentation", "Networking", "ssh", "tricks" ] +tags: [ "Networking", "ssh", "tricks" ] requires: [ "ssh" ] --- diff --git a/networking/tor.md b/networking/tor.md index 1d03a6a..ac71971 100644 --- a/networking/tor.md +++ b/networking/tor.md @@ -1,6 +1,6 @@ --- title: "tor" -tags: [ "Documentation", "Networking" ] +tags: [ "Networking" ] --- # Get a hostname diff --git a/networking/transmission.md b/networking/transmission.md index 7b38242..db3563f 100644 --- a/networking/transmission.md +++ b/networking/transmission.md @@ -1,6 +1,6 @@ --- title: "transmission" -tags: [ "Documentation", "Networking", "Torrenting" ] +tags: [ "Networking", "Torrenting" ] --- # Torrench diff --git a/networking/troubleshooting.md b/networking/troubleshooting.md index 8c9f51d..6a6bb92 100644 --- a/networking/troubleshooting.md +++ b/networking/troubleshooting.md @@ -1,6 +1,6 @@ --- title: "troubleshooting" -tags: [ "Documentation", "Networking" ] +tags: [ "Networking" ] --- # Do you have an IP? diff --git a/networking/website/nginx.md b/networking/website/nginx.md index 680f500..7c144e6 100644 --- a/networking/website/nginx.md +++ b/networking/website/nginx.md @@ -1,6 +1,6 @@ --- title: "nginx" -tags: [ "Documentation", "Networking" ] +tags: [ "Networking" ] --- Install nginx: diff --git a/networking/wifi.md b/networking/wifi.md index 9db41ac..86481c2 100644 --- a/networking/wifi.md +++ b/networking/wifi.md @@ -1,6 +1,6 @@ --- title: "wifi" -tags: [ "Documentation", "Networking" ] +tags: [ "Networking" ] --- # Netstat Stuff diff --git a/networking/wireguard.md b/networking/wireguard.md index 7d58910..68987c7 100644 --- a/networking/wireguard.md +++ b/networking/wireguard.md @@ -1,6 +1,6 @@ --- title: "wireguard" -tags: [ "Documentation", "Networking", "VPN" ] +tags: [ "Networking", "VPN" ] ---