feature: markdown link check

.pre-commit-config.yaml

@@ -51,3 +51,9 @@ repos:
     rev: v0.12.0
     hooks:
       - id: markdownlint
+  - repo: https://github.com/tcort/markdown-link-check
+    rev: v3.11.2
+    hooks:
+      - id: markdown-link-check
+        args:
+          - -q

knowledge base/asdf.md

@@ -155,4 +155,4 @@ The versions listed in such file can be:
 [plugins list]: https://github.com/asdf-vm/asdf-plugins
 
 <!-- Files -->
-[.tool-versions example]: ../examples/.tool-versions
+[.tool-versions example]: ../examples/dotfiles/.tool-versions

knowledge base/bash.md

@@ -391,7 +391,7 @@ All the references in the [further readings] section, plus the following:
 [6 bash tricks you can use daily]: https://medium.com/for-linux-users/6-bash-tricks-you-can-use-daily-a32abdd8b13
 [bash startup files loading order]: https://youngstone89.medium.com/unix-introduction-bash-startup-files-loading-order-562543ac12e9
 [how to detect if a script is being sourced]: https://stackoverflow.com/questions/2683279/how-to-detect-if-a-script-is-being-sourced#28776166
-[speed up your command line navigation]: https://blog.jread.com/speed-up-your-command-line-navigation-d4050207f02c
+[speed up your command line navigation]: https://blog.jread.com/posts/speed-up-your-command-line-navigation-part-1/
 [the bash trap command]: https://www.linuxjournal.com/content/bash-trap-command
 [the essential bash cheat sheet]: https://betterprogramming.pub/the-essential-bash-cheat-sheet-e1c3df06560
 [upper- or lower-casing strings]: https://scriptingosx.com/2019/12/upper-or-lower-casing-strings-in-bash-and-zsh/

knowledge base/best practices.md

@@ -66,7 +66,7 @@ Based on experience.
 
 <!-- Knowledge base -->
 [safe]: safe.placeholder
-[the automation paradox]: the%20automation%20paradox.placeholder
+[the automation paradox]: the%20automation%20paradox.md
 
 <!-- Others -->
 [a case against "platform teams"]: https://kislayverma.com/organizations/a-case-against-platform-teams/

knowledge base/cloud-init.md

@@ -173,12 +173,12 @@ All the references in the [further readings] section, plus the following:
   -->
 
 <!-- Upstream -->
-[debugging cloud-init]: https://cloudinit.readthedocs.io/en/latest/topics/debugging.html
+[debugging cloud-init]: https://canonical-cloud-init.readthedocs-hosted.com/en/latest/howto/debugging.html
 [examples]: https://cloudinit.readthedocs.io/en/latest/topics/examples.html
-[merging user-data sections]: https://cloudinit.readthedocs.io/en/latest/topics/merging.html
+[merging user-data sections]: https://canonical-cloud-init.readthedocs-hosted.com/en/latest/reference/merging.html
 [modules]: https://cloudinit.readthedocs.io/en/latest/topics/modules.html
 [mime multi part archive]: https://cloudinit.readthedocs.io/en/latest/topics/format.html#mime-multi-part-archive
-[tutorial]: https://cloudinit.readthedocs.io/en/latest/topics/tutorial.html
+[tutorial]: https://canonical-cloud-init.readthedocs-hosted.com/en/latest/tutorial/
 [website]: https://cloud-init.io/
 
 <!-- In-article sections -->

knowledge base/create, mount and use an encrypted disk.md

@@ -64,5 +64,5 @@ All the references in the [further readings] section, plus the following:
 [encrypted root filesystem]: encrypted%20root%20filesystem.md
 
 <!-- Files -->
-[create an encrypted btrfs device]: scripts/create-an-encrypted-btrfs-device.sh
+[create an encrypted btrfs device]: ../scripts/create-an-encrypted-btrfs-device.sh
-[create an encrypted zfs device]: scripts/create-an-encrypted-btrfs-device.sh
+[create an encrypted zfs device]: ../scripts/create-an-encrypted-zfs-device.sh

knowledge base/curl.md

@@ -145,7 +145,7 @@ All the references in the [further readings] section, plus the following:
 <!-- Upstream -->
 [book]: https://everything.curl.dev/
 [config file]: https://everything.curl.dev/cmdline/configfile
-[http2]: https://everything.curl.dev/http/http2
+[http2]: https://everything.curl.dev/http/versions/http2
 
 <!-- In-article sections -->
 [further readings]: #further-readings

knowledge base/get the environment of processes running in containers.md

@@ -38,8 +38,8 @@ All the references in the [further readings] section, plus the following:
 [further readings]: #further-readings
 
 <!-- Knowledge base -->
-[kubectl]: kubectl.md
+[kubectl]: kubernetes/kubectl.md
-[kubernetes]: README.md
+[kubernetes]: kubernetes/README.md
 
 <!-- Others -->
 [get the environment variables of running process in container]: https://unix.stackexchange.com/a/412730

knowledge base/immutable operating systems.md

@@ -9,6 +9,8 @@
   References
   -->
 
+<!-- Upstream -->
+[fedora silverblue]: https://fedoraproject.org/silverblue/
+
 <!-- Knowledge base -->
-[fedora silverblue]: fedora%20silverblue.md
 [microos]: microos.md

knowledge base/kubernetes/kapp.md

@@ -30,4 +30,4 @@ $ kapp -y deploy -a 'my-app' -f <(ytt -f './examples/simple-app-example/config-1
   -->
 
 <!-- Upstream -->
-[website]: https://get-kapp.io
+[website]: https://carvel.dev/kapp/

knowledge base/kubernetes/kubectl.md

@@ -632,7 +632,7 @@ All the references in the [further readings] section, plus the following:
 
 <!-- Knowledge base -->
 [jsonpath]: ../jsonpath.md
-[krew]: krew.md
+[krew]: krew.placeholder
 [kubernetes]: README.md
 
 <!-- Others -->

knowledge base/linux kernel modules.md

@@ -56,8 +56,6 @@ options brcmfmac roamoff=1 feature_disable=0x82000
 
 ## Sources
 
-All the references in the [further readings] section, plus the following:
-
 - The [Kernel module][arch wiki kernel module] page in the [Arch wiki]
 - The [Kernel modules][gentoo wiki kernel modules]
 
@@ -65,9 +63,6 @@ All the references in the [further readings] section, plus the following:
   References
   -->
 
-<!-- In-article sections -->
-[further readings]: #further-readings
-
 <!-- Others -->
 [arch wiki]: https://wiki.archlinux.org
 [arch wiki kernel module]: https://wiki.archlinux.org/title/Kernel_module

knowledge base/mac os x/openssl-osx-ca.md

@@ -36,5 +36,5 @@ find "$(brew --prefix)/etc" -type 'f' -name 'cert.pem' -path '*/openssl*' -exec
 [github]: https://github.com/raggi/openssl-osx-ca
 
 <!-- Knowledge base -->
-[homebrew]: homebrew.md
+[homebrew]: ../homebrew.md
 [mac os x]: README.md

knowledge base/microos.md

@@ -37,7 +37,6 @@ See [MicroOS Desktop] for more and updated information.
 
 ## Sources
 
-- [MicroOS Desktop]
 - [MicroOS Portal]
 
 <!--
@@ -45,7 +44,6 @@ See [MicroOS Desktop] for more and updated information.
   -->
 
 <!-- Upstream -->
-[microos desktop]: https://opensuse.github.io/openSUSE-docs-revamped-temp/microos_getting_started/
 [microos portal]: https://en.opensuse.org/Portal:MicroOS
 
 <!-- Knowledge base -->

knowledge base/pipx.md

@@ -54,7 +54,7 @@ pipx uninstall 'azure-cli'
   -->
 
 <!-- Upstream -->
-[website]: https://pypa.github.io/pipx/
+[website]: https://pipx.pypa.io/stable/
 
 <!-- Knowledge base -->
 [pip]: pip.md

knowledge base/prometheus.md

@@ -120,7 +120,7 @@ All the references in the [further readings] section, plus the following:
 <!-- Knowledge base -->
 [grafana]: grafana.md
 [node exporter]: node%20exporter.md
-[smnp exporter]: smnp%20exporter.md
+[snmp exporter]: snmp%20exporter.md
 
 <!-- Files -->
 [docker/monitoring]: ../docker/monitoring/README.md

knowledge base/replicated.md

@@ -28,4 +28,4 @@ replicated admin --tty=0 retrieve-iact
 [replicatedctl]: replicatedctl.md
 
 <!-- Files -->
-[configuration file example]: ../examples/terraform%20enterprise/replicated.settings.json
+[configuration file example]: ../examples/terraform/enterprise/replicated.settings.json

knowledge base/send an email from cli.md

@@ -28,5 +28,5 @@ uuencode file.txt | mail -s "Subject" recipient@mail.server
   -->
 
 <!-- Others -->
-[linux mail command examples]: https://www.binarytides.com/linux-mail-command-examples
+[linux mail command examples]: https://www.binarytides.com/linux-mail-command-examples/
 [uuencode]: https://linux.101hacks.com/unix/uuencode/

knowledge base/set the ondemand cpu governor to not rise the frequencies for niced load.md

@@ -25,7 +25,7 @@ echo "w /sys/devices/system/cpu/cpufreq/ondemand/ignore_nice_load - - - - 1" | s
   -->
 
 <!-- Knowledge base -->
-[cpufreq]: cpufreq.md
+[cpupower]: cpupower.md
 
 <!-- Others -->
 [laptop overheating and battery duration reduction]: https://wiki.archlinux.org/?title=BOINC#Laptop_overheating_and_battery_duration_reduction

knowledge base/synology dsm.md

@@ -219,7 +219,7 @@ All the references in the [further readings] section, plus the following:
 [further readings]: #further-readings
 
 <!-- Files -->
-[michelecereda/keybaseio-client]: ../docker/keybaseio-client/README.md
+[michelecereda/keybaseio-client]: ../docker/keybaseio-git-client/README.md
 
 <!-- Others -->
 [configuring deduplication block on the synology]: https://onedrive.live.com/?authkey=%21ACYMJq62iJaU7HY&cid=1E8D74207941B8DD&id=1E8D74207941B8DD%21243&parId=1E8D74207941B8DD%21121&o=OneUp

knowledge base/uci.md

@@ -65,4 +65,4 @@ reload_config
 [the uci system]: https://openwrt.org/docs/guide-user/base-system/uci
 
 <!-- Knowledge base -->
-[Turris Omnia]: turris.md
+[Turris Omnia]: turris%20os.md

knowledge base/useradd.md

@@ -46,4 +46,4 @@ sudo useradd --system username
   -->
 
 <!-- Others -->
-[cheat.sh]: cheat.sh/useradd
+[cheat.sh]: https://cheat.sh/useradd

knowledge base/userdel.md

@@ -29,4 +29,4 @@ sudo userdel --remove username
   -->
 
 <!-- Others -->
-[cheat.sh]: cheat.sh/userdel
+[cheat.sh]: https://cheat.sh/userdel

knowledge base/usermod.md

@@ -45,4 +45,4 @@ sudo usermod --move-home --home path/to/new_home lonny
   -->
 
 <!-- Others -->
-[cheat.sh]: cheat.sh/usermod
+[cheat.sh]: https://cheat.sh/usermod