Merge branch 'dev' into vhs

README.md

@@ -44,6 +44,8 @@ They should not assume the reader knows much beyond common terminal commands, an
 People should be able to read an article from the beginning, then keep going until the end, and then stop.
 Articles should not take a detour through a chain of other articles of unknown size.
 
+[Do not Jaquays documentation](https://splint.rs/posts/no_links)
+
 ## Be Opinionated
 
 - Guides should not ask the reader to select options half-way through.

basics/at.md

@@ -64,6 +64,8 @@ atrm 2
 
 Check `/var/spool/atd/` to see the jobs.
 
+![At it again](/tapes/at.gif)
+
 ## Automation
 
 Automatically add a job for later, by setting the date, then using echo for the command.

basics/at.tape

@@ -0,0 +1,42 @@
+Require at
+Require atd
+Sleep 500ms
+Type "at teatime"
+Enter
+Sleep 1.5s
+Type "./"
+Sleep 500ms
+Type "baskup.sh"
+Sleep 1.5s
+Enter
+Sleep 1.5s
+Ctrl+D
+Sleep 3.5s
+Type "atq"
+Enter
+Sleep 1.5s
+Type "atq 1"
+Sleep 500ms
+Type "4"
+Enter
+Sleep 500ms
+Type "at"
+Sleep 1s
+Type " -c 15"
+Enter
+Sleep 1.5s
+Type "at"
+Sleep 500ms
+Type " "
+Sleep 500ms
+Type "-"
+Sleep 500ms
+Type "c 15 | grep PWD"
+Enter
+Sleep 5.5s
+Type "atrm 15"
+Sleep 2s
+Enter
+Sleep 3s
+Ctrl+D
+

basics/locating.md

@@ -13,6 +13,8 @@ type -P ls
 type -a cat
 ```
 
+![where is cmus?](/tapes/which.gif)
+
 # Whereis the Program
 
 Where is `grep` and all its configuration files?

basics/which.tape

@@ -0,0 +1,33 @@
+Require cmus
+
+Type "whereis cmus"
+Enter
+Sleep 1s
+Type "which cmus"
+Enter
+Sleep 500ms
+Type "type /bin/cmus"
+Enter
+Sleep 5s
+Type "man cmus"
+Enter
+Sleep 1s
+Type " "
+Sleep 1s
+Type " "
+Sleep 1s
+Type " "
+Sleep 500ms
+Type " "
+Sleep 1.5s
+Type " "
+Sleep 500ms
+Type " "
+Sleep 1.5s
+Type " "
+Sleep 500ms
+Type " q"
+Sleep 500ms
+Type "cmus"
+Sleep 3s
+Ctrl+D

data/git/basics.md

@@ -6,36 +6,40 @@ tags: [ "data" ]
 
 ## New Machines
 
-```bash
+```sh
 git config --global user.email "$YOUR_EMAIL"
 ```
 
-```bash
+```sh
 git config --global user.name "$YOUR_NAME"
 ```
 
 # New Git
 
-Start a git in directory `$DIR`:
+Decide on algorithm:
 
-```bash
-mkdir $DIR && cd $DIR
-```
+- If you're scared of insecure hash-sums, go with `hash=sha256`.
+- If you don't know what a hash sum is, go with `hash=sha1`.
 
-```bash
-git init
+## Init the Git
+
+Start a git in directory `${DIR}`:
+
+```sh
+git init --object-format=${hash} ${DIR}
+cd ${DIR}
 ```
 
 Make a file explaining what the project does, and tell `git` to track it:
 
-```bash
-echo "I hereby solemnly swear never to commit a binary." > README.md
+```sh
+echo "I hereby solemnly swear never to commit a binary file." > README.md
 git add README.md
 ```
 
 Then make the initial commit, explaining the change you just made:
 
-```bash
+```sh
 git commit
 ```
 
@@ -43,17 +47,17 @@ git commit
 
 Once you make a change to some file, add it and make a commit explaining it.
 
-```bash
+```sh
 git add $FILE
 ```
 
-```bash
+```sh
 git commit -m"change $FILE"
 ```
 
 Check your history:
 
-```bash
+```sh
 git log
 ```
 
@@ -64,20 +68,20 @@ Give it the same name as the `$DIR` directory, above.
 
 Add this as a remote:
 
-```bash
+```sh
 REMOTE=gitlab
 git remote add $REMOTE  https://gitlab.com/$USERNAME/$DIR
 ```
 
 Tell git you're pushing the branch "master" to the remote repo "origin": 
 
-```bash
+```sh
 git push -u master origin
 ```
 
 If someone makes a change on the remote, pull it down with:
 
-```bash
+```sh
 git pull
 ```
 
@@ -86,31 +90,31 @@ git pull
 A branch is a full copy of the project to test additional ideas.
 You can make a new branch called 'featurez' like this:
 
-```bash
+```sh
 git branch $FEATURE_BRANCH
 ```
 
 Have a look at all your branches:
 
-```bash
+```sh
 git branch
 ```
 
 Switch to your new branch:
 
-```bash
+```sh
 git checkout $FEATURE_BRANCH
 ```
 
 And if your changes are rubbish, checkout the "master" branch again, then delete "featurez":
 
-```bash
+```sh
 git branch -D $FEATURE_BRANCH
 ```
 
 Or if it's a good branch, push it to the remote:
 
-```bash
+```sh
 remote=origin
 git push $remote $FEATURE_BRANCH
 ```
@@ -119,13 +123,13 @@ git push $remote $FEATURE_BRANCH
 
 Once you like the feature, merge it into the main branch.  Switch to master then merge it:
 
-```bash
+```sh
 git merge $FEATURE_BRANCH
 ```
 
 And delete the branch, as you've already merged it:
 
-```bash
+```sh
 git branch -d $FEATURE_BRANCH
 ```
 
@@ -133,7 +137,7 @@ git branch -d $FEATURE_BRANCH
 
 ## Pulling another git repo into a subtree
 
-```bash
+```sh
 git subtree add -P config git@gitlab.com:bindrpg/config.git master
 ```
 
@@ -141,27 +145,27 @@ git subtree add -P config git@gitlab.com:bindrpg/config.git master
 
 ## Delete All History
 
-```bash
+```sh
 git checkout --orphan temp
 ```
 
-```bash
+```sh
 git add -A
 ```
 
-```bash
+```sh
 git commit -am "release the commits!"
 ```
 
-```bash
+```sh
 git branch -D master
 ```
 
-```bash
+```sh
 git branch -m master
 ```
 
-```bash
+```sh
 git push -f origin master
 ```
 
@@ -169,21 +173,21 @@ Gitlab requires more changes, such as going to `settings > repository` and switc
 
 ## Clean up Bloated Repo
 
-```bash
+```sh
 git fsck --full
 ```
 
-```bash
+```sh
 git gc --prune=now --aggressive
 ```
 
-```bash
+```sh
 git repack
 ```
 
 ## Find Binary Blobs
 
-```bash
+```sh
 git rev-list --objects --all \
 | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' \
 | sed -n 's/^blob //p' \

data/recfiles.md

@@ -52,3 +52,5 @@ recset -f "$new_field" --delete $database
 
 - [Recfiles for gemini capsules](gemini://tilde.town/~dozens/gemlog/21.gmi)
 
+
+![Recfiles](/tapes/recfiles.gif)

data/recfiles/recfiles.tape

@@ -0,0 +1,68 @@
+Require recins
+
+Set Shell "bash"
+Set TypingSpeed 0.1
+Set FontSize 25
+Set Width 900
+Set Height 700
+
+Enter
+Type "touch games.rec"
+Enter
+
+Sleep 2s
+Type 'recins --record "Name: Vojvodina" games.rec'
+Enter
+Sleep 2s
+Type 'recsel games.rec'
+Enter
+
+Sleep 2s
+
+Type 'for g in Saboter Carcassonne Chess; do recins -r "Name: $g" games.rec; done'
+Enter
+Type 'recsel games.rec'
+Enter
+Sleep 2s
+Type 'cat games.rec'
+Enter
+Sleep 1s
+
+Type 'recsel --quick=Carc games.rec'
+Enter
+Type 'recsel -q Carc games.rec'
+Enter
+Sleep 2s
+
+Type 'recsel -q "sabot" --print=Name games.rec'
+Enter
+Sleep 1s
+Type 'recsel --case-insensitive -q "sabot" --print=Name games.rec'
+Enter
+Sleep 2s
+
+Type 'recsel -i -q "chess" -p Name games.rec'
+Enter
+Sleep 1s
+
+Type 'recset -f "Played" --set-add="no" games.rec'
+Enter
+Type 'recsel games.rec'
+Enter
+Sleep 1s
+
+Type 'recset -iq chess -f "Played" --set=yes games.rec'
+Enter
+Type 'recsel games.rec'
+Enter
+Sleep 1s
+
+Type 'recset -f "Played" --delete games.rec'
+Enter
+Type 'recsel games.rec'
+Enter
+
+Hide
+Type 'rm games.rec'
+Enter
+Sleep 3s

data/sc-im.md

@@ -48,6 +48,7 @@ echo 'set autowrap' >> .config/sc-im/scimrc
 |:----------------------|:---:|
 | text (left align)     | <   |
 | text (right align)    | >   |
+| text (right align)    | `|` |
 | Edit existing  text   | E   |
 
 ### Meta Actions
@@ -62,6 +63,26 @@ echo 'set autowrap' >> .config/sc-im/scimrc
 |  paste with format    | Pc  |
 |  delete a cell        | x   |
 
+# Movement
+
+| Action                          | Key |
+|:-------------------------------:|:---:|
+| highest part                    | H   |
+| lowest part                     | L   |
+| top                             | gg  |
+| move right                      | g$  |
+| move left                       |  g0 |
+| insert middle                   | \   |
+| insert left                     | \>  |
+| insert right                    | <   |
+| to to cell b4                   | b4  |
+| see all text in cells           | aa  |
+| format cells so you can see it. | f   |
+| format wider right              | fl  |
+| format smaller left             | fh  |
+| format wider down               | fj  |
+| format smaller down             | fk  |
+
 
 ### Functions
 

data/task/contexts.md

@@ -0,0 +1,34 @@
+---
+title: "Taskwarrior Contexts"
+tags: [ "data", "task" ]
+requires: [ "Taskwarrior" ]
+---
+
+# Contexts
+
+Set three contexts by their tags:
+
+```sh
+task context define work +sa or +hr
+```
+
+```sh
+task context define study +ed or +void or +rat
+```
+
+```sh
+task context define home -sa -hr -ed -void -rat
+```
+
+Change to the first context.
+
+```sh
+task context work
+```
+
+Then stop.
+
+```sh
+task context none
+```
+

data/task/task.md

@@ -1,6 +1,6 @@
 ---
-title: "task"
-tags: [ "organization" ]
+title: "Taskwarrior"
+tags: [ "data", "organization" ]
 ---
 
 Set up the configuration file:
@@ -9,6 +9,18 @@ Set up the configuration file:
 task
 ```
 
+Taskwarrior published a new feature to synchronize tasks others, but the feature was not ready.
+The server's default installation instructions assume that users pay for hosting services.
+All listed providers run proprietary software and actively support genocide.
+
+
+To ignore the synchronization, tell the configuration file to use a local synchronization file.
+
+```
+task config sync.local.server_dir
+task config data.location ~/.local/state/
+```
+
 Add a task:
 
 ```sh
@@ -44,18 +56,16 @@ task add project:house buy potted plant
 task add proj:house.repair buy screwdriver
 task add proj:house.repair buy shelf brackets
 task add pro:house.paint buy white paint
-task add pro:house.paint buy red paint
-task add pro:house.paint buy black paint
-task add pro:house.paint buy brushes
+
+for t in "buy red paint" "buy black paint" "buy brushes" ; do
+  task add pro:house.paint $t
+done
 ```
 
 ## Summary
 
 ```sh
 task pro:house sum
-```
-
-```sh
 task burndown.daily pro:house
 ```
 
@@ -63,44 +73,12 @@ The summaries will show how fast a project is being completed, and when you can
 
 # Tags
 
+
 ```sh
 task add +buy toothbrush
-```
-
-You can then see only tasks which involve buying something with:
-
-```sh
 task +buy
 ```
 
-# Contexts
-
-Set three contexts by their tags:
-
-```sh
-task context define work +sa or +hr
-```
-
-```sh
-task context define study +ed or +void or +rat
-```
-
-```sh
-task context define home -sa -hr -ed -void -rat
-```
-
-Change to the first context.
-
-```sh
-task context work
-```
-
-Then stop.
-
-```sh
-task context none
-```
-
 # Review
 
 View list of tasks completed in the last week:
@@ -111,21 +89,17 @@ task end.after:today-1wk completed
 
 # User Defined Attributes
 
-Make a UDA 'size'.
+Define a new attribute for tasks called 'size'.
+The 'user defined attribute' (UDA) needs a `type` and `label`.
 
 ```sh
 task config uda.size.type string
-```
-
-```sh
 task config uda.size.label Size
 ```
+You can also ensure task tasks can only be `large`, `medium`, or `small`, then set a default.
 
 ```sh
 task config uda.size.values large,medium,small
-```
-
-```sh
 uda.size.default=medium
 ```
 

data/task/taskwarrior_configuration.md

@@ -0,0 +1,20 @@
+---
+title: "Taskwarrior Configuration"
+tags: [ "data", "task" ]
+requires: [ "Taskwarrior" ]
+---
+
+Show your current config:
+
+
+```sh
+task show
+```
+
+Use machine-readable output to make a config file with all configuration keys shown, then make it your configuration file.
+
+```sh
+task _show > ${file}
+mv ${file} ~/.config/task/taskrc
+```
+

data/w3m.md

@@ -19,3 +19,4 @@ w3m ddg.gg
 | T        | new tab              |
 | { / }    | switch tabs          |
 
+![w3m browser](/tapes/w3m.gif)

data/w3m.tape

@@ -0,0 +1,43 @@
+Require w3m
+
+Sleep 1s
+Type "w3m ddg.gg"
+Sleep 500ms
+Enter
+Sleep 1.5s
+Tab
+Enter
+Type "cats"
+Enter
+Sleep 2s
+Tab
+Enter
+Sleep 2s
+Type "jjjjjjjjjjjj"
+Tab
+Enter
+Sleep 2s
+Type "U"
+Sleep 500ms
+Ctrl+U
+Sleep 500ms
+Type "dmz.rs"
+Sleep 500ms
+Enter
+Sleep 4.5s
+Type "jjjjjjjj"
+Tab
+Type "j"
+Sleep 500ms
+Enter
+Sleep 1s
+Type " "
+Sleep 2s
+Backspace
+Sleep 500ms
+Type " "
+Sleep 1.5s
+Type " "
+Sleep 2s
+Type "qy"
+Sleep 500ms

distros/void/xbps-install.tape

@@ -0,0 +1,28 @@
+Require xbps-query
+Require xbps-install
+
+Set Shell "bash"
+Set FontSize 20
+Set Width 1400
+Set Height 900
+
+Type "sudo xbps-install --sync" Enter Sleep 700ms  Enter
+
+Type "sudo xbps-install --update --yes" Sleep 700ms
+
+Backspace 33
+
+Type "echo same but faster!" Sleep 200ms  Enter
+
+Type "sudo xbps-install -uy" Enter Sleep 700ms
+
+Type "echo now we just download" Sleep 2s  Enter
+
+Type "sudo xbps-install -SD --yes" Sleep 700ms Enter 
+
+Type "echo and install from the downloaded updates..." Sleep 2s  Enter
+
+Type "sudo xbps-install -Du" Sleep 700ms Enter 
+
+Sleep 4s
+

distros/void/xbps-query.tape

@@ -0,0 +1,64 @@
+Require xbps-query
+Require xbps-install
+
+Set Shell "bash"
+#Set FontSize 20
+#Set Width 1400
+#Set Height 900
+
+#Hide 
+#
+#Type "sudo xbps-remove -y cowsay xcowsay aerc"
+
+Show
+
+Type "xbps-query cows" Enter Sleep 1s
+
+Type "nothing..."
+
+Backspace 11
+
+Type "xbps-query --search cows" Sleep 500ms  Enter
+
+Type "xbps-query --repository --search cows" Sleep 500ms  Enter
+
+Type "echo same but faster!" Sleep 200ms  Enter
+
+Type "xbps-query -Rs cows" Sleep 500ms  Enter
+
+Sleep 3s
+
+Type "sudo xbps-install -y xcowsay" Enter Sleep 700ms  Enter
+
+Sleep 5
+
+Type "xbps-query --repository --search 'email'" Sleep 300ms Enter
+
+Type "too much...." Sleep 1s
+
+Backspace 13
+
+Sleep 1s
+
+Type "xbps-query -R --search '^email'" Sleep 300ms Enter
+
+Sleep 2s
+
+Type "xbps-query -Rs --regex '^email terminal'" Sleep 300ms Enter
+
+Type "???" Sleep 2s
+
+Backspace 3
+
+Sleep 3s
+
+Type "regex first!" Sleep 2s
+
+Backspace 12
+
+Type "xbps-query --regex -Rs '^email.*terminal'" Sleep 300ms Enter Sleep 900ms
+
+Type "xbps-query --regex -Rs '^terminal.*email'" Sleep 300ms Enter Sleep 900ms
+
+Type "sudo xbps-install aerc" Enter Sleep 300ms Enter Sleep 2s
+

distros/void/xbps-remove.tape

@@ -0,0 +1,28 @@
+Require xbps-query
+Require xbps-install
+
+Set Shell "bash"
+#Set FontSize 20
+#Set Width 1400
+#Set Height 900
+
+Type "sudo xbps-remove --yes thunderbird" Enter Sleep 2s
+
+Type "time to kill orphans" Sleep 600ms
+
+Backspace 21
+
+Enter
+
+Type "xbps-remove --remove-orphans --dry-run" Sleep 700ms 
+
+Backspace 38
+
+Enter
+
+Type "xbps-remove -on | cowsay" Sleep 300ms Enter Sleep 1.5s
+
+Type "sudo xbps-remove --yes -o" Sleep 700ms Enter
+
+Sleep 2s
+

distros/void/xbps.md

@@ -22,6 +22,8 @@ Search with regex:
 xbps-query --regex -Rs 'cow(s)?\w'
 ```
 
+![xbps searches](/tapes/xbps-query.gif)
+
 List what's required for cowsay
 
 ```bash
@@ -68,6 +70,8 @@ Upgrade current packages.
 xbps-install -Suv
 ```
 
+![xbps searches](/tapes/xbps-install.gif)
+
 ## Remove/ Uninstall
 
 Remove cowsay
@@ -90,6 +94,8 @@ xbps-remove -o
 
 Show information about cowsay
 
+![xbps searches](/tapes/xbps-remove.gif)
+
 ## Fixes
 
 Reinstall cowsay

networking/port_scan.md

@@ -0,0 +1,25 @@
+---
+title: "Port Scan"
+tags: [ "networking" ]
+repo: 'https://github.com/mrjackwills/havn/'
+---
+
+`havn` scans ports.
+It's not in many repos, but if you can `cargo install havn`.
+
+
+```sh
+havn -h
+havn -a
+domain=splint.rs
+havn -p 19-90 ${domain}
+```
+
+That last command doesn't work reliably, so increase the number of retries (`-r`), or decrease concurrent requests (`-c`).
+
+
+```sh
+havn -p 19-443 -r 6 ${domain}
+havn -p 1-1000 -c 500 -r 5 ${domain}
+```
+

system/Makefiles/patterns.md

@@ -1,4 +1,3 @@
-
 ---
 title: "Makefile Patterns"
 tags: [ "system", "make" ]

system/Makefiles/python_projects.md

@@ -0,0 +1,98 @@
+---
+title: "Python Projects with Makefiles"
+tags: [ "tutorial", "system", "makefiles", "graphviz", "python" ]
+requires: [ "Makefiles" ]
+---
+
+If you have a python script which requires a packages - e.g. `graphviz` - you can automate the setup with a `Makefile`.
+The `Makefile` will:
+
+1. Make three copies of an 8-line installer script.
+2. Use one of the installer script to install local packages.
+3. Install a symbolic link to python.
+3. Make a script called `activate`, which tells python to use 
+
+# Context
+
+Python coders don't like updating their projects, they just expect everyone to install the same version of everything that they have.
+Historically, people dealt with this by installing only half a dozen copies of `graphviz`; but now each python project uses a local environment, with a local copy of `graphviz`, which means everyone gets to install a new copy of `graphviz` every time they try out a project.
+
+Downloading 40MB of software for each 40-line script you write is called 'virtual environments' because it sounds cool.
+We can make it even cooler with `make`, but not yet, because python - like the fae of old - will not fetch anything until you know its true name.
+
+# Setup
+
+```sh
+command -v python
+realpath `!!`
+```
+
+You must reveal that true path, because `python` is always a relative symbolic link, to an absolute symbolic link, which leads to a shortcut.
+We can finally let `make` know how to invoke python, and where it will install `graphviz`.
+
+If your python's version is '3.14', then python needs its packages placed in `${somewhere}/lib/python3.14/site-packages/`.
+You must create a new, local, name for these packages, because - like the fey of old - python demands a private name in return for revealing its true name.
+
+I'll call mine `camelot`, because the path is long and arduous.
+Set up the Makefiles like this:
+
+```make
+py_link != command -v python
+py != realpath $(py_link)
+version != basename $(py)
+
+virtenv = camelot
+```
+
+Now you can ask for a local `pip` script, which can install the python packages:
+
+```make
+    [...]
+
+$(virtenv)/bin/pip:
+    $(py) -m venv $(virtenv)
+```
+
+Finally, list the packages you want in `requirements.txt`, and make `pip` install from it.
+
+
+```sh
+ppkg=graphviz
+echo ${ppkg} > requirements.txt
+```
+
+```make
+    [...]
+
+pkgs = $(virtenv)/lib/$(version)/site-packages/
+
+$(pkgs): $(virtenv)/bin/pip
+$(pkgs): requirements.txt
+    $(virtenv)/bin/pip install -r $<
+```
+
+The complete Makefile looks like this:
+
+
+```make
+all: .default
+
+py_link != command -v python
+py != realpath $(py_link)
+version != basename $(py)
+
+virtenv = camelot
+
+$(virtenv)/bin/pip:
+    $(py) -m venv $(virtenv)
+
+pkgs = $(virtenv)/lib/$(version)/site-packages/
+
+$(pkgs): $(virtenv)/bin/pip
+$(pkgs): requirements.txt
+    $(virtenv)/bin/pip install -r $<
+
+.PHONY: .default
+.default: $(pkgs)
+```
+

system/lf.md

@@ -3,6 +3,8 @@ title: "lf - The Light File Manager"
 tags: [ "file browser", "TUI" ]
 ---
 
+![lf](/tapes/lf.gif)
+
 ## Config File
 
 If you don't have a `~/.config/lf/lfrc` file, you can probably find an example in `/usr/share/examples/lf`.

system/lf.tape

@@ -0,0 +1,24 @@
+Require lf
+
+Set Shell "bash"
+Set FontSize 12
+Set Width 800
+Set Height 600
+
+Type "lf"
+Sleep 1.5s
+Enter
+Sleep 1.5s
+Type "jjj"
+Sleep 1s
+Enter
+Sleep 2s
+Type "fortune > file"
+Enter
+Sleep 2s
+Enter
+Type "/file"
+Enter
+Sleep 3s
+Type "q"
+

writing/tex/calendar.md

@@ -0,0 +1,12 @@
+---
+title: "Calendar"
+tags: [ "writing", "tex", "fun" ]
+requires: [ "LaTeX Packages" ]
+---
+
+```sh
+yplan $(date +%Y) > ${file}.tex
+pdflatex -output-directory=/tmp/ ${file}.tex
+mv /tmp/${file}.pdf .
+```
+

writing/tex/tex_packages.md

@@ -1,5 +1,5 @@
 ---
-title: "LaTeX Setup the Hard Way"
+title: "LaTeX Packages"
 tags: [ "writing" ]
 ---
 
@@ -21,7 +21,7 @@ ls /opt/texlive/${YEAR}/texmf-dist/scripts/texlive/tlmgr.pl
 ```
 
 Double-check the year.
-It should *not* match the real year, it should match the `texlive`.
+It should *not* match the current year, it should match the `texlive`.
 
 ## Problems along the Path