Example: syntax

command.rec

@@ -5,6 +5,15 @@
 %unique: shell
 %sort: shell bin
 
+aim: Change a CSV header
+cmd: from=number
++ to=quantity
++ sed -i "1 s///" "".csv
+bin: sed
+tag: csv
+tag: substitute
+tag: replace
+
 aim: Roll a die
 cmd: echo $(( RANDOM % 6+1 ))
 shell: bash
@@ -442,6 +451,17 @@ bin: printf
 tag: xargs
 tag: stdout
 
+aim: Share a directory as a local website
+cmd: python3 -m http.server
+note: Anyone can go to your computer's IP address and access all files in the current directory.
+shell: sh
+bin: python3
+tag: tip
+tag: network
+tag: share
+cmd: qrencode -t ansi "$(ip route show | grep -Pom1 'src \K[\d.]+')"
++ sudo python -m http.server 80
+
 aim: Make a QR Code image
 cmd: qrencode 'https://play.google.com/store/apps/details?id=org.briarproject.briar.android' -o "${file}".png
 shell: sh
@@ -485,6 +505,12 @@ bin: recinf
 tag: recfiles
 tag: database
 
+aim: Remove non-printable characters
+cmd: sed -i 's/[^[:print:]]//g' ${file}
+shell: sh
+bin: sed
+tag: text
+
 aim: Get back terminal after ssh freezes remote machine
 cmd: <Return>~.
 shell: sh
@@ -492,6 +518,31 @@ bin: ssh
 tag: system
 tag: comfy
 
+aim: Launch GUI app as root
+cmd: app=gparted
++ sudo -E ${app}
+note: Useful for launching gparted in sway.
+shell: sh
+bin: sudo
+tag: wayland
+tag: gui
+tag: sway
+
+aim: Check current keyboard layout on sway
+cmd: swaymsg -t get_inputs --raw | jq -r '.[0].xkb_active_layout_name'
+bin: sway
+bin: jq
+tag: keyboard
+tag: locale
+shell: sh
+
+aim: Show name of currently selected app in sway
+cmd: swaymsg -t get_tree | jq -C '.. | select(.type?) | select(.focused==true)'
+bin: sway
+bin: jq
+tag: bar
+shell: sh
+
 aim: List enabled systemd services
 cmd: systemctl list-unit-files  --state enabled
 cmd: systemctl --user list-unit-files  --state enabled

example.rec

@@ -1,6 +1,5 @@
 %rec: example
 %key: name
-%type: note line
 
 name: Default systemd service file
 filename: default.service
@@ -148,9 +147,8 @@ content: ### Variables
 + 
 + .PHONY: help
 + help:
-+ 	@awk 'BEGIN {FS = ":.*?## "} /^[0-9a-zA-Z._-]+:.*?## / {printf "\033[36m%s\033[0m : %s\n", $$1, $$2}' $(MAKEFILE_LIST) | \
-+ 		sort | \
-+ 		column -s ':' -t
++ 	@awk 'BEGIN {FS = ":.*?## "} /^[0-9a-zA-Z._-]+:.*?## / {printf "\033[36m%s\033[0m : %s\n", $$1, $$2}' $(MAKEFILE_LIST) \
++ | sort | column -s ':' -t
 + 
 + .PHONY: check
 + check: ## Check you have the required dependencies
@@ -209,8 +207,7 @@ content: hdr = @printf "\n\033[37;1;4m%s\033[0m\n"
 + 	@printf "\033[36m%s\t" "done"
 + 	@printf "\033[0m %s " "Close $$(basename -s .md $(last_modified) | tr '_' ' ')"
 + 	@printf "\033[0m %s\n" "[$$(grep -Pom1 'title: \K.*' $(last_modified))]"
-+ 	@awk 'BEGIN {FS = ":.*?## "} /^[0-9a-zA-Z._-]+:.*?## / {printf "\033[36m%s\033[0m : %s\n", $$1, $$2}' $(MAKEFILE_LIST) | \
-+ 		column -s ':' -t
++ 	@awk 'BEGIN {FS = ":.*?## "} /^[0-9a-zA-Z._-]+:.*?## / {printf "\033[36m%s\033[0m : %s\n", $$1, $$2}' $(MAKEFILE_LIST) | + 		column -s ':' -t
 + 
 + $(closed_issues): closed/%.md: open/%.md
 + 	@git add $<
@@ -249,8 +246,34 @@ content: hdr = @printf "\n\033[37;1;4m%s\033[0m\n"
 + .PHONY: rundown
 + rundown: ## Summarize events
 + 	@printf "\033[33;5m# %s\033[0m\n" "Outstanding Calamities"
-+ 	@$(foreach bug, $(wildcard open/*.md), \
-+ 		a="$$(lowdown -X responsible $(bug))" && \
-+ 		n="$$(echo $(bug) | cut -d_ -f2 | cut -d. -f1)" && \
-+ 		t="$$(lowdown -X title $(bug))" && echo "$$n: $$t ($$a)" ;\
-+ 	)
++ 	@$(foreach bug, $(wildcard open/*.md), + 		a="$$(lowdown -X responsible $(bug))" && + 		n="$$(echo $(bug) | cut -d_ -f2 | cut -d. -f1)" && + 		t="$$(lowdown -X title $(bug))" && echo "$$n: $$t ($$a)" ;+ 	)
+
+name: RSS feed
+filename: rss.xml
+note: Only 'description', 'link', and 'title' are required.
++ 
++ Extra fields include 'textInput' (for a paragraph about the feed), 'skipHours' (for the hours to wait before refreshing), and 'language'.
+content: <?xml version="1.0" encoding="UTF-8" ?>
++ <rss version="2.0">
++ 
++ <channel>
++   <title>{{title}}</title>
++   <link>{{url}}</link>
++   <generator>Recutils</generator>
++   <docs>https://www.w3schools.com/XML/xml_rss.asp</docs>
++   <skipDays>{{frequency}}</skipDays>
++   <description>{{description}}</description>
+note: Output the next content field separately to produce multiple post items.
+content:   <item>
++     <guid>{{post_id}}</guid>
++ 	<category>{{post_category}}</category>
++ 	<pubDate>{{post_date}}</pubDate>
++     <title>{{post_title}}</title>
++     <link>{{url}}/{{post_link}}</link>
++     <description>{{post_description}}</description>
++ 	<source>{{post_source}}</source>
++   </item>
+note: The last content field closes the XML tags opened in the first content field.
+content: </channel>
++ 
++ </rss>

networking/remote_sway.md

@@ -0,0 +1,49 @@
+---
+title: Remote Desktop between Sway
+tags: 
+- networking
+requires: 
+- networking/ssh.md
+---
+
+# On the Host
+
+Install and run `wayvnc`.
+
+```sh
+export WAYLAND_DISPLAY=wayland-1
+wayvnc
+```
+
+Only the `localhost` can access this (highly insecure) desktop sharing, at port 5900.
+
+# On the Client
+
+You'll need to disable your main modifier key on the client while accessing the host.
+Edit `~/.config/sway/config`, and create a new `passthrough` mode where the modifier key does nothing.
+
+```config
+mode passthrough {
+    bindsym $mod+c mode default
+}
+bindsym $mod+c mode passthrough
+```
+
+Reload sway to make the changes take effect.
+
+```sh
+swaymsg reload
+```
+
+Use `ssh` to grab the host's port 5900.
+
+```sh
+ssh -L 5900:localhost:5900 ${remote_username}@${remote_ip}
+```
+
+Leave that session running, and connect with `vncviewer`:
+
+```sh
+vncviewer localhost:5900
+```
+

networking/remote_sway_alt.md

@@ -0,0 +1,22 @@
+---
+title: New Sway Remote Desktop
+tags: 
+- networking
+requires: 
+- networking/remote_sway.md
+---
+
+Check the host is using only one display:
+
+```sh
+test "$WAYLAND_DISPLAY" = "wayland-1"
+```
+
+Start a new sway session, and a `wayvnc` session:
+
+```sh
+WLR_BACKENDS=headless WLR_LIBINPUT_NO_DEVICES=1 sway &
+WAYLAND_DISPLAY=wayland-2 wayvnc
+```
+
+On the client, [connect as usual](networking/remote_sway.md).

shell/shell_tips.md

@@ -23,14 +23,15 @@ Most programs let you clear the highlighting with `<Esc>+u`.
 Follow a file as new lines are added to it:
 
 ```sh
-tail -f *somefile*
+tail -f "${file}"
 ```
 
-See changes in a directory, as it changes:
+Watch which files in `${directory}` have most recently changed.
 
-`watch -d ls *directory*`
+`watch -d ls -t ${directory}/
 
 Or use the `-g` flag to exit once the output changes.
+
 This command will look at whether you're connected to the internet, and turn into a rainbow once the connection hits.
 
 > watch -g ip address && clear && ip address | lolcat

system/makefiles/help.md

@@ -1,5 +1,5 @@
 ---
-title: make help target
+title: Make help target
 tags: 
 - system
 - make