*: improve more info links and add option placeholders part 18

pages/common/cjxl.md

@@ -2,7 +2,7 @@
 
 > Compress images to JPEG XL.
 > Accepted input extensions are PNG, APNG, GIF, JPEG, EXR, PPM, PFM, PAM, PGX, and JXL.
-> More information: <https://github.com/libjxl/libjxl>.
+> More information: <https://github.com/libjxl/libjxl/blob/main/doc/man/cjxl.txt>.
 
 - Convert an image to JPEG XL:
 

pages/common/cosign.md

@@ -1,35 +1,35 @@
 # cosign
 
 > Container Signing, Verification and Storage in an OCI registry.
-> More information: <https://github.com/sigstore/cosign>.
+> More information: <https://github.com/sigstore/cosign/blob/main/doc/cosign.md>.
 
 - Generate a key-pair:
 
 `cosign generate-key-pair`
 
 - Sign a container and store the signature in the registry:
 
-`cosign sign -key {{cosign.key}} {{image}}`
+`cosign sign --key {{cosign.key}} {{image}}`
 
 - Sign a container image with a key pair stored in a Kubernetes secret:
 
-`cosign sign -key k8s://{{namespace}}/{{key}} {{image}}`
+`cosign sign --key k8s://{{namespace}}/{{key}} {{image}}`
 
 - Sign a blob with a local key pair file:
 
 `cosign sign-blob --key {{cosign.key}} {{path/to/file}}`
 
 - Verify a container against a public key:
 
-`cosign verify -key {{cosign.pub}} {{image}}`
+`cosign verify --key {{cosign.pub}} {{image}}`
 
 - Verify images with a public key in a Dockerfile:
 
 `cosign dockerfile verify -key {{cosign.pub}} {{path/to/Dockerfile}}`
 
 - Verify an image with a public key stored in a Kubernetes secret:
 
-`cosign verify -key k8s://{{namespace}}/{{key}} {{image}}`
+`cosign verify --key k8s://{{namespace}}/{{key}} {{image}}`
 
 - Copy a container image and its signatures:
 

pages/common/direnv.md

@@ -1,7 +1,7 @@
 # direnv
 
 > Shell extension to load and unload environment variables depending on the current directory.
-> More information: <https://github.com/direnv/direnv>.
+> More information: <https://github.com/direnv/direnv/blob/master/man/direnv.1.md>.
 
 - Grant direnv permission to load the `.envrc` present in the current directory:
 

pages/common/djxl.md

@@ -2,7 +2,7 @@
 
 > Decompress JPEG XL images.
 > Accepted output extensions are PNG, APNG, JPEG, EXR, PGM, PPM, PNM, PFM, PAM, EXIF, XMP and JUMBF.
-> More information: <https://github.com/libjxl/libjxl>.
+> More information: <https://github.com/libjxl/libjxl/blob/main/doc/man/djxl.txt>.
 
 - Decompress a JPEG XL image to another format:
 

pages/common/eget.md

@@ -1,7 +1,7 @@
 # eget
 
 > Easily install prebuilt binaries from GitHub.
-> More information: <https://github.com/zyedidia/eget>.
+> More information: <https://github.com/zyedidia/eget#usage>.
 
 - Download a prebuilt binary for the current system from a repository on GitHub:
 
@@ -13,19 +13,19 @@
 
 - Specify the location to place the downloaded files:
 
-`eget {{zyedidia/micro}} --to={{path/to/directory}}`
+`eget {{zyedidia/micro}} --to {{path/to/directory}}`
 
 - Specify a Git tag instead of using the latest version:
 
-`eget {{zyedidia/micro}} --tag={{v2.0.10}}`
+`eget {{zyedidia/micro}} {{[-t|--tag]}} {{v2.0.10}}`
 
 - Install the latest pre-release instead of the latest stable version:
 
 `eget {{zyedidia/micro}} --pre-release`
 
 - Only download the asset, skipping extraction:
 
-`eget {{zyedidia/micro}} --download-only`
+`eget {{zyedidia/micro}} {{[-d|--download-only]}}`
 
 - Only download if there is a newer release then the currently downloaded version:
 

pages/common/eol.md

@@ -1,7 +1,7 @@
 # eol
 
 > Show end-of-life dates (EoLs) for a number of products.
-> More information: <https://github.com/hugovk/norwegianblue>.
+> More information: <https://github.com/hugovk/norwegianblue#example-command-line-use>.
 
 - List all available products:
 
@@ -13,16 +13,16 @@
 
 - Open the product webpage:
 
-`eol {{product}} --web`
+`eol {{product}} {{[-w|--web]}}`
 
 - Get EoLs of a one or more products in a specific format:
 
-`eol {{product1 product2 ...}} --format {{html|json|md|markdown|pretty|rst|csv|tsv|yaml}}`
+`eol {{product1 product2 ...}} --{{html|json|md|markdown|pretty|rst|csv|tsv|yaml}}`
 
 - Get EoLs of one or more products as a single markdown file:
 
-`eol {{product1 product2 ...}} --format {{markdown}} > {{eol_report.md}}`
+`eol {{product1 product2 ...}} --{{markdown}} > {{eol_report.md}}`
 
 - Display help:
 
-`eol --help`
+`eol {{[-h|--help]}}`

pages/common/eva.md

@@ -1,7 +1,7 @@
 # eva
 
 > Simple calculator REPL, similar to `bc`, with syntax highlighting and persistent history.
-> More information: <https://github.com/NerdyPepper/eva>.
+> More information: <https://github.com/oppiliappan/eva#usage>.
 
 - Run the calculator in interactive mode:
 

pages/common/fdroidcl.md

@@ -1,7 +1,7 @@
 # fdroidcl
 
 > Manage F-Droid apps of devices connected via ADB.
-> More information: <https://github.com/mvdan/fdroidcl>.
+> More information: <https://github.com/Hoverth/fdroidcl#commands>.
 
 - Fetch the F-Droid index:
 

pages/common/fkill.md

@@ -1,7 +1,7 @@
 # fkill
 
 > Fabulously kill processes. Cross-platform.
-> More information: <https://github.com/sindresorhus/fkill>.
+> More information: <https://manned.org/fkill>.
 
 - Run without arguments to use the interactive interface:
 

pages/common/gcpdiag.md

@@ -2,23 +2,23 @@
 
 > Google Cloud Platform troubleshooting and diagnostics tool.
 > Run in a Docker container or in GCP Cloudshell.
-> More information: <https://github.com/GoogleCloudPlatform/gcpdiag>.
+> More information: <https://github.com/GoogleCloudPlatform/gcpdiag#usage>.
 
 - Run `gcpdiag` on your project, returning all rules:
 
-`gcpdiag lint --project={{gcp_project_id}}`
+`gcpdiag lint --project {{gcp_project_id}}`
 
 - Hide rules that are ok:
 
-`gcpdiag lint --project={{gcp_project_id}} --hide-ok`
+`gcpdiag lint --project {{gcp_project_id}} --hide-ok`
 
 - Authenticate using a service account private key file:
 
-`gcpdiag lint --project={{gcp_project_id}} --auth-key {{path/to/private_key}}`
+`gcpdiag lint --project {{gcp_project_id}} --auth-key {{path/to/private_key}}`
 
 - Search logs and metrics from a number of days back (default: 3 days):
 
-`gcpdiag lint --project={{gcp_project_id}} --within-days {{number}}`
+`gcpdiag lint --project {{gcp_project_id}} --within-days {{number}}`
 
 - Display help:
 

pages/common/gist.md

@@ -13,20 +13,20 @@
 
 - Create a private gist with a description:
 
-`gist --private --description "{{A meaningful description}}" {{file.txt}}`
+`gist {{[-p|--private]}} {{[-d|--description]}} "{{A meaningful description}}" {{file.txt}}`
 
 - Read contents from `stdin` and create a gist from it:
 
 `{{echo "hello world"}} | gist`
 
 - List your public and private gists:
 
-`gist --list`
+`gist {{[-l|--list]}}`
 
 - List all public gists for any user:
 
-`gist --list {{username}}`
+`gist {{[-l|--list]}} {{username}}`
 
 - Update a gist using the ID from URL:
 
-`gist --update {{GIST_ID}} {{file.txt}}`
+`gist {{[-u|--update]}} {{GIST_ID}} {{file.txt}}`

pages/common/gitleaks.md

@@ -1,27 +1,27 @@
 # gitleaks
 
 > Detect secrets and API keys leaked in Git repositories.
-> More information: <https://github.com/gitleaks/gitleaks>.
+> More information: <https://github.com/gitleaks/gitleaks#usage>.
 
 - Scan a remote repository:
 
 `gitleaks detect --repo-url {{https://github.com/username/repository.git}}`
 
 - Scan a local directory:
 
-`gitleaks detect --source {{path/to/repository}}`
+`gitleaks detect {{[-s|--source]}} {{path/to/repository}}`
 
 - Output scan results to a JSON file:
 
-`gitleaks detect --source {{path/to/repository}} --report {{path/to/report.json}}`
+`gitleaks detect {{[-s|--source]}} {{path/to/repository}} --report {{path/to/report.json}}`
 
 - Use a custom rules file:
 
-`gitleaks detect --source {{path/to/repository}} --config-path {{path/to/config.toml}}`
+`gitleaks detect {{[-s|--source]}} {{path/to/repository}} --config-path {{path/to/config.toml}}`
 
 - Start scanning from a specific commit:
 
-`gitleaks detect --source {{path/to/repository}} --log-opts {{--since=commit_id}}`
+`gitleaks detect {{[-s|--source]}} {{path/to/repository}} --log-opts {{--since=commit_id}}`
 
 - Scan uncommitted changes before a commit:
 

pages/common/gitsome.md

@@ -2,7 +2,7 @@
 
 > A terminal-based interface for GitHub, accessed via the `gh` command.
 > It also provides menu-style autocomplete suggestions for `git` commands.
-> More information: <https://github.com/donnemartin/gitsome>.
+> More information: <https://github.com/donnemartin/gitsome#index>.
 
 - Enter the gitsome shell (optional), to enable autocompletion and interactive help for Git (and gh) commands:
 
@@ -26,4 +26,4 @@
 
 - View the recent activity feed for a given GitHub user, using the default pager (e.g. `less`):
 
-`gh feed {{torvalds}} -p`
+`gh feed {{torvalds}} {{[-p|--pager]}}`

pages/common/gnomon.md

@@ -1,24 +1,24 @@
 # gnomon
 
 > Utility to annotate console logging statements with timestamps and find slow processes.
-> More information: <https://github.com/paypal/gnomon>.
+> More information: <https://github.com/paypal/gnomon#options>.
 
 - Use UNIX (or DOS) pipes to pipe `stdout` of any command through gnomon:
 
 `{{npm test}} | gnomon`
 
 - Show number of seconds since the start of the process:
 
-`{{npm test}} | gnomon --type=elapsed-total`
+`{{npm test}} | gnomon {{[-t|--type]}} elapsed-total`
 
 - Show an absolute timestamp in UTC:
 
-`{{npm test}} | gnomon --type=absolute`
+`{{npm test}} | gnomon {{[-t|--type]}} absolute`
 
 - Use a high threshold of 0.5 seconds, exceeding which the timestamp will be colored bright red:
 
-`{{npm test}} | gnomon --high 0.5`
+`{{npm test}} | gnomon {{[-h|--high]}} 0.5`
 
 - Use a medium threshold of 0.2 seconds, exceeding which the timestamp will be colored bright yellow:
 
-`{{npm test}} | gnomon --medium {{0.2}}`
+`{{npm test}} | gnomon {{[-m|--medium]}} 0.2`

pages/common/guetzli.md

@@ -1,7 +1,7 @@
 # guetzli
 
 > JPEG image compression utility.
-> More information: <https://github.com/google/guetzli>.
+> More information: <https://manned.org/guetzli>.
 
 - Compress a JPEG image:
 

pages/common/hashid.md

@@ -1,7 +1,7 @@
 # hashid
 
 > Python3 program that identifies data and password hashes.
-> More information: <https://github.com/psypanda/hashID>.
+> More information: <https://github.com/psypanda/hashID#usage>.
 
 - Identify hashes from `stdin` (through typing, copying and pasting, or piping the hash into the program):
 
@@ -17,12 +17,12 @@
 
 - Show all possible hash types (including salted hashes):
 
-`hashid --extended {{hash}}`
+`hashid {{[-e|--extended]}} {{hash}}`
 
 - Show `hashcat`'s mode number and `john`'s format string of the hash types:
 
-`hashid --mode --john {{hash}}`
+`hashid {{[-m|--mode]}} {{[-j|--john]}} {{hash}}`
 
 - Save output to a file instead of printing to `stdout`:
 
-`hashid --outfile {{path/to/output.txt}} {{hash}}`
+`hashid {{[-o|--outfile]}} {{path/to/output.txt}} {{hash}}`

pages/common/hcloud.md

@@ -1,16 +1,16 @@
 # hcloud
 
 > Show how to use the CLI for Hetzner Cloud.
-> More information: <https://github.com/hetznercloud/cli>.
+> More information: <https://github.com/hetznercloud/cli/blob/main/docs/reference/manual/hcloud.md>.
 
 - Show available commands and flags:
 
 `hcloud`
 
-- Display help:
-
-`hcloud -h`
-
 - Show available commands and flags for `hcloud` contexts:
 
 `hcloud context`
+
+- Display help:
+
+`hcloud -h`

pages/common/hping3.md

@@ -2,32 +2,32 @@
 
 > Advanced ping utility which supports protocols such TCP, UDP, and raw IP.
 > Best run with elevated privileges.
-> More information: <https://github.com/antirez/hping>.
+> More information: <https://manned.org/hping3>.
 
 - Ping a destination with 4 ICMP ping requests:
 
-`hping3 --icmp --count {{4}} {{ip_or_hostname}}`
+`hping3 {{[-1|--icmp]}} {{[-c|--count]}} 4 {{ip_or_hostname}}`
 
 - Ping an IP address over UDP on port 80:
 
-`hping3 --udp --destport {{80}} --syn {{ip_or_hostname}}`
+`hping3 {{[-2|--udp]}} {{[-p|--destport]}} 80 {{[-S|--syn]}} {{ip_or_hostname}}`
 
 - Scan TCP port 80, scanning from the specific local source port 5090:
 
-`hping3 --verbose --syn --destport {{80}} --baseport {{5090}} {{ip_or_hostname}}`
+`hping3 {{[-V|--verbose]}} {{[-S|--syn]}} {{[-p|--destport]}} 80 {{[-s|--baseport]}} 5090 {{ip_or_hostname}}`
 
 - Traceroute using a TCP scan to a specific destination port:
 
-`hping3 --traceroute --verbose --syn --destport {{80}} {{ip_or_hostname}}`
+`hping3 {{[-T|--traceroute]}} {{[-V|--verbose]}} {{[-S|--syn]}} {{[-p|--destport]}} {{80}} {{ip_or_hostname}}`
 
 - Scan a set of TCP ports on a specific IP address:
 
-`hping3 --scan {{80,3000,9000}} --syn {{ip_or_hostname}}`
+`hping3 {{[-8|--scan]}} {{80,3000,9000}} {{[-S|--syn]}} {{ip_or_hostname}}`
 
 - Perform a TCP ACK scan to check if a given host is alive:
 
-`hping3 --count {{2}} --verbose --destport {{80}} --ack {{ip_or_hostname}}`
+`hping3 {{[-c|--count]}} {{2}} {{[-V|--verbose]}} {{[-p|--destport]}} {{80}} {{[-A|--ack]}} {{ip_or_hostname}}`
 
 - Perform a charge test on port 80:
 
-`hping3 --flood --destport {{80}} --syn {{ip_or_hostname}}`
+`hping3 --flood {{[-p|--destport]}} 80 {{[-S|--syn]}} {{ip_or_hostname}}`