From 5a1ba18176d4761b85db1e14de0c4f2ae74d29fc Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Thu, 28 Nov 2024 02:51:26 +0100 Subject: [PATCH 1/2] simplify git secret flaw --- data/git/git_secret.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/data/git/git_secret.md b/data/git/git_secret.md index ec1931d..d766867 100644 --- a/data/git/git_secret.md +++ b/data/git/git_secret.md @@ -1,9 +1,9 @@ --- -title: "git secret" +title: "git-secret" tags: [ "data", "git" ] --- This utility is largely useless, as it can only identify people by their email. So if someone has multiple GPG keys associated with one email, the tool will not work. -Worse than not working, it may 'suddenly' stop working as you try to transfer a secret to someone, who then discovers that `git-secret` requires them to mess about with their GPG keyring in order to use the repository. +A broken tool is better than a tool which will break soon. From b2ea104e96afd529e63bcce57bab9bca6a4eed42 Mon Sep 17 00:00:00 2001 From: Malin Freeborn Date: Thu, 28 Nov 2024 17:08:31 +0100 Subject: [PATCH 2/2] show website example with lowdown --- vision/lowdown.md | 8 ++++++++ vision/lowdown/example.txt | 36 ++++++++++++++++++++++++++++++++++++ 2 files changed, 44 insertions(+) create mode 100644 vision/lowdown/example.txt diff --git a/vision/lowdown.md b/vision/lowdown.md index 44d64b8..10e030f 100644 --- a/vision/lowdown.md +++ b/vision/lowdown.md @@ -9,6 +9,14 @@ Turn a markdown file into a pdf: lowdown -stms "$FILE".md | pdfroff -itk -mspdf > "$FILE".pdf ``` +*Example:* put [this Makefile](lowdown/example.txt) in a directory, rename it `Makefile`, then do: + + +```bash +make example +make +``` + To give the document a title, put that title in the metadata: ```bash diff --git a/vision/lowdown/example.txt b/vision/lowdown/example.txt new file mode 100644 index 0000000..a9d00e2 --- /dev/null +++ b/vision/lowdown/example.txt @@ -0,0 +1,36 @@ +output: all + +.PHONY: example +example: html/foot.html html/head.html + mkdir -p articles/ + fortune > articles/fort_1.md + fortune > articles/fort_2.md + +HTML = $(patsubst articles/%.md,public/%.html,$(wildcard articles/*.md)) + +$(HTML): public/ articles/ $(wildcard html/*) + +html/head.html: + @mkdir $(@D) + echo ' Something about CSS probably ' > $@ + echo '' >> $@ + +html/foot.html: html/head.html + echo '' >> $@ + +public/%.html : articles/%.md + cat html/head.html > $@ + lowdown $< >> $@ + cat html/foot.html >> $@ + +.PHONY: all +all : $(HTML) + +articles/: + mkdir $@ + +public/: + mkdir $@ + +clean : + rm -rf public