Update pages

build.zig

@@ -1,7 +1,7 @@
 const std = @import("std");
 const Allocator = std.mem.Allocator;
 
-const VERSION = "0.0.20";
+const VERSION = "0.0.21";
 
 fn embedData(b: *std.Build, exe: *std.Build.Step.Compile) !void {
     var options = b.addOptions();

pages/common/age-keygen.md

@@ -1,7 +1,7 @@
 # age-keygen
 
 > Generate `age` key pairs.
-> See `age` for how to encrypt/decrypt files.
+> See also: `age` for encrypting/decrypting files.
 > More information: <https://manned.org/age-keygen>.
 
 - Generate a key pair, save it to an unencrypted file, and print the public key to `stdout`:

pages/common/age.md

@@ -1,7 +1,7 @@
 # age
 
 > A simple, modern and secure file encryption tool.
-> See `age-keygen` for how to generate key pairs.
+> See also: `age-keygen` for generating key pairs.
 > More information: <https://github.com/FiloSottile/age>.
 
 - Generate an encrypted file that can be decrypted with a passphrase:

pages/common/ansible-playbook.md

@@ -26,3 +26,7 @@
 - Run tasks in a playbook starting at a specific task:
 
 `ansible-playbook {{playbook}} --start-at {{task_name}}`
+
+- Run tasks in a playbook without making any changes (dry-run):
+
+`ansible-playbook {{playbook}} --check --diff`

pages/common/ansiweather.md

@@ -1,6 +1,6 @@
 # ansiweather
 
-> A shell script for displaying the current weather conditions in your terminal.
+> Display the current weather conditions in your terminal.
 > More information: <https://github.com/fcambus/ansiweather>.
 
 - Display a [f]orecast using metric [u]nits for the next seven days for a specific [l]ocation:

pages/common/apkleaks.md

@@ -1,6 +1,6 @@
 # apkleaks
 
-> An APK file scanner for exposing URIs, endpoints, and secrets.
+> Expose URIs, endpoints, and secrets from APK files.
 > Note: APKLeaks utilizes the `jadx` disassembler to decompile APK files.
 > More information: <https://github.com/dwisiswant0/apkleaks>.
 

pages/common/apm.md

@@ -1,7 +1,7 @@
 # apm
 
 > Atom editor Package Manager.
-> See `atom`.
+> See also: `atom`.
 > More information: <https://github.com/atom/apm>.
 
 - Install a package from <http://atom.io/packages> or a theme from <http://atom.io/themes>:

pages/common/audacious.md

@@ -1,7 +1,7 @@
 # audacious
 
 > An open-source audio player. Indirectly based on XMMS.
-> See also: `clementine`, `mpc`, `ncmpcpp`.
+> See also: `audtool`, `clementine`, `mpc`, `ncmpcpp`.
 > More information: <https://audacious-media-player.org>.
 
 - Launch the GUI:

pages/common/audtool.md

@@ -0,0 +1,37 @@
+# audtool
+
+> Control Audacious using commands.
+> See also: `audacious`.
+> More information: <https://manned.org/audtool>.
+
+- Play/pause audio playback:
+
+`audtool playback-playpause`
+
+- Print artist, album, and song name of currently playing song:
+
+`audtool current-song`
+
+- Set volume of audio playback:
+
+`audtool set-volume {{100}}`
+
+- Skip to the next song:
+
+`audtool playlist-advance`
+
+- Print the bitrate of the current song in kilobits:
+
+`audtool current-song-bitrate-kbps`
+
+- Open Audacious in full-screen if hidden:
+
+`audtool mainwin-show`
+
+- Display help:
+
+`audtool help`
+
+- Display settings:
+
+`audtool preferences-show`

pages/common/azurite.md

@@ -3,15 +3,15 @@
 > Azure Storage API compatible server (emulator) in local environment.
 > More information: <https://www.npmjs.com/package/azurite>.
 
-- Use an existing [l]ocation as workspace path:
+- Use an existing location as workspace path:
 
 `azurite {{-l|--location}} {{path/to/directory}}`
 
 - Disable access log displayed in console:
 
 `azurite {{-s|--silent}}`
 
-- Enable [d]ebug log by providing a file path as log destination:
+- Enable debug log by providing a file path as log destination:
 
 `azurite {{-d|--debug}} {{path/to/debug.log}}`
 

pages/common/bc.md

@@ -2,7 +2,7 @@
 
 > An arbitrary precision calculator language.
 > See also: `dc`.
-> More information: <https://manned.org/man/bc.1>.
+> More information: <https://manned.org/bc.1>.
 
 - Start an interactive session:
 

pages/common/bru.md

@@ -1,7 +1,7 @@
 # bru
 
 > CLI for Bruno, an Opensource IDE for exploring and testing APIs.
-> More information: <https://docs.usebruno.com/cli/overview.html>.
+> More information: <https://docs.usebruno.com/bru-cli/overview>.
 
 - Run all request files from the current directory:
 

pages/common/cabal.md

@@ -2,7 +2,7 @@
 
 > Command-line interface to the Haskell package infrastructure (Cabal).
 > Manage Haskell projects and Cabal packages from the Hackage package repository.
-> More information: <https://cabal.readthedocs.io/en/latest/intro.html>.
+> More information: <https://cabal.readthedocs.io/en/latest/getting-started.html>.
 
 - Search and list packages from Hackage:
 

pages/common/chezmoi.md

@@ -8,10 +8,18 @@
 
 `chezmoi init`
 
+- Set up `chezmoi` from existing dotfiles of a Git repository:
+
+`chezmoi init {{repository_url}}`
+
 - Start tracking one or more dotfiles:
 
 `chezmoi add {{path/to/dotfile1 path/to/dotfile2 ...}}`
 
+- Update repository with local changes:
+
+`chezmoi re-add {{path/to/dotfile1 path/to/dotfile2 ...}}`
+
 - Edit the source state of a tracked dotfile:
 
 `chezmoi edit {{path/to/dotfile_or_symlink}}`
@@ -24,10 +32,6 @@
 
 `chezmoi -v apply`
 
-- Set up `chezmoi` from existing dotfiles of a Git repository:
-
-`chezmoi init {{repository_url}}`
-
 - Pull changes from a remote repository and apply them:
 
 `chezmoi update`

pages/common/compare.md

@@ -1,13 +1,7 @@
 # compare
 
-> Create a comparison image to visually annotate the difference between two images.
-> Part of ImageMagick.
-> More information: <https://imagemagick.org/script/compare.php>.
+> This command is an alias of `magick compare`.
 
-- Compare two images:
+- View documentation for the original command:
 
-`compare {{path/to/image1.png}} {{path/to/image2.png}} {{path/to/diff.png}}`
-
-- Compare two images using the specified metric:
-
-`compare -verbose -metric {{PSNR}} {{path/to/image1.png}} {{path/to/image2.png}} {{path/to/diff.png}}`
+`tldr magick compare`

pages/common/convert.md

@@ -1,37 +1,9 @@
 # convert
 
-> Convert between image formats, scale, join, and create images, and much more.
-> Part of ImageMagick.
-> More information: <https://imagemagick.org/script/convert.php>.
+> This command is an alias of `magick convert`.
+> Note: this alias is deprecated since ImageMagick 7. It has been replaced by `magick`.
+> Use `magick convert` if you need to use the old tool in versions 7+.
 
-- Convert an image from JPEG to PNG:
+- View documentation for the original command:
 
-`convert {{path/to/input_image.jpg}} {{path/to/output_image.png}}`
-
-- Scale an image to 50% of its original size:
-
-`convert {{path/to/input_image.png}} -resize 50% {{path/to/output_image.png}}`
-
-- Scale an image keeping the original aspect ratio to a maximum dimension of 640x480:
-
-`convert {{path/to/input_image.png}} -resize 640x480 {{path/to/output_image.png}}`
-
-- Horizontally append images:
-
-`convert {{path/to/image1.png path/to/image2.png ...}} +append {{path/to/output_image.png}}`
-
-- Vertically append images:
-
-`convert {{path/to/image1.png path/to/image2.png ...}} -append {{path/to/output_image.png}}`
-
-- Create a GIF from a series of images with 100ms delay between them:
-
-`convert {{path/to/image1.png path/to/image2.png ...}} -delay {{10}} {{path/to/animation.gif}}`
-
-- Create an image with nothing but a solid red background:
-
-`convert -size {{800x600}} "xc:{{#ff0000}}" {{path/to/image.png}}`
-
-- Create a favicon from several images of different sizes:
-
-`convert {{path/to/image1.png path/to/image2.png ...}} {{path/to/favicon.ico}}`
+`tldr magick convert`

pages/common/crystal.md

@@ -11,7 +11,7 @@
 
 `crystal build {{path/to/file.cr}}`
 
-- Read Crystal source code from the command line or `stdin`, and execute it:
+- Read Crystal source code from the command-line or `stdin`, and execute it:
 
 `crystal eval '{{code}}'`
 

pages/common/cypher-shell.md

@@ -0,0 +1,33 @@
+# cypher-shell
+
+> Open an interactive session and run Cypher queries against a Neo4j instance.
+> See also: `neo4j-admin`, `mysql`.
+> More information: <https://neo4j.com/docs/operations-manual/current/tools/cypher-shell/>.
+
+- Connect to a local instance on the default port (`neo4j://localhost:7687`):
+
+`cypher-shell`
+
+- Connect to a remote instance:
+
+`cypher-shell --address neo4j://{{host}}:{{port}}`
+
+- Connect and supply security credentials:
+
+`cypher-shell --username {{username}} --password {{password}}`
+
+- Connect to a specific database:
+
+`cypher-shell --database {{database_name}}`
+
+- Execute Cypher statements in a file and close:
+
+`cypher-shell --file {{path/to/file.cypher}}`
+
+- Enable logging to a file:
+
+`cypher-shell --log {{path/to/file.log}}`
+
+- Display help:
+
+`cypher-shell --help`

pages/common/dcfldd.md

@@ -5,8 +5,8 @@
 
 - Copy a disk to a raw image file and hash the image using SHA256:
 
-`dcfldd if=/dev/{{disk_device}} of={{file.img}} hash=sha256 hashlog={{file.hash}}`
+`dcfldd if={{/dev/disk_device}} of={{file.img}} hash=sha256 hashlog={{file.hash}}`
 
 - Copy a disk to a raw image file, hashing each 1 GB chunk:
 
-`dcfldd if=/dev/{{disk_device}} of={{file.img}} hash={{sha512|sha384|sha256|sha1|md5}} hashlog={{file.hash}} hashwindow={{1G}}`
+`dcfldd if={{/dev/disk_device}} of={{file.img}} hash={{sha512|sha384|sha256|sha1|md5}} hashlog={{file.hash}} hashwindow={{1G}}`

pages/common/dd.md

@@ -1,15 +1,15 @@
 # dd
 
 > Convert and copy a file.
-> More information: <https://manned.org/man/dd.1p>.
+> More information: <https://manned.org/dd.1p>.
 
-- Make a bootable USB drive from an isohybrid file (such as `archlinux-xxx.iso`):
+- Make a bootable USB drive from an isohybrid file (such as `archlinux-xxx.iso`) and show the progress:
 
-`dd if={{path/to/file.iso}} of=/dev/{{usb_drive}}`
+`dd if={{path/to/file.iso}} of={{/dev/usb_drive}} status=progress`
 
 - Clone a drive to another drive with 4 MiB block size and flush writes before the command terminates:
 
-`dd bs={{4194304}} conv={{fsync}} if=/dev/{{source_drive}} of=/dev/{{dest_drive}}`
+`dd bs=4194304 conv=fsync if={{/dev/source_drive}} of={{/dev/dest_drive}}`
 
 - Generate a file with a specific number of random bytes by using kernel random driver:
 
@@ -19,6 +19,6 @@
 
 `dd bs={{1024}} count={{1000000}} if=/dev/zero of={{path/to/file_1GB}}`
 
-- Create a system backup and save it into an IMG file (can be restored later by swapping `if` and `of`):
+- Create a system backup, save it into an IMG file (can be restored later by swapping `if` and `of`), and show the progress:
 
-`dd if={{/dev/drive_device}} of={{path/to/file.img}}`
+`dd if={{/dev/drive_device}} of={{path/to/file.img}} status=progress`

pages/common/deemix.md

@@ -2,7 +2,7 @@
 
 > A barebone deezer downloader library built from the ashes of Deezloader Remix.
 > It can be used as a standalone CLI app or implemented in a UI using the API.
-> More information: <https://deemix.app>.
+> More information: <https://gitlab.com/RemixDev/deemix-py>.
 
 - Download a track or playlist:
 

pages/common/devenv.md

@@ -0,0 +1,28 @@
+# devenv
+
+> Fast, Declarative, Reproducible and Composable Developer Environments using Nix.
+> More information: <https://devenv.sh>.
+
+- Initialise the environment:
+
+`devenv init`
+
+- Enter the Development Environment with relaxed hermeticity (state of being airtight):
+
+`devenv shell --impure`
+
+- Get detailed information about the current environment:
+
+`devenv info --verbose`
+
+- Start processes with `devenv`:
+
+`devenv up --config /{{file}}/{{path}}/`
+
+- Clean the environment variables and re-enter the shell in offline mode:
+
+`devenv --clean --offline`
+
+- Delete the previous shell generations:
+
+`devenv gc`