From a4070e7b424e2eab16c97e136b31a0e3ab62a163 Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Sat, 25 Mar 2023 15:44:12 +0200 Subject: Update content for md --- gemfeed/2021-04-24-welcome-to-the-geminispace.md | 1 + ...-05-gemtexter-one-bash-script-to-rule-it-all.md | 1 + ...022-08-27-gemtexter-1.1.0-lets-gemtext-again.md | 1 + ...3-03-25-gemtexter-2.0.0-lets-gemtext-again-2.md | 1 + .../DRAFT-gemtexter-1.1.0-lets-gemtext-again-2.md | 145 --------------------- index.md | 2 +- uptime-stats.md | 2 +- 7 files changed, 6 insertions(+), 147 deletions(-) delete mode 100644 gemfeed/DRAFT-gemtexter-1.1.0-lets-gemtext-again-2.md diff --git a/gemfeed/2021-04-24-welcome-to-the-geminispace.md b/gemfeed/2021-04-24-welcome-to-the-geminispace.md index f69ff3c1..4010cebd 100644 --- a/gemfeed/2021-04-24-welcome-to-the-geminispace.md +++ b/gemfeed/2021-04-24-welcome-to-the-geminispace.md @@ -80,6 +80,7 @@ Check out one of the following links for more information about Gemini. For exam Other related posts are: +[2023-03-25 Gemtexter 2.0.0 - Let's Gemtext again^2](./2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.md) [2022-08-27 Gemtexter 1.1.0 - Let's Gemtext again](./2022-08-27-gemtexter-1.1.0-lets-gemtext-again.md) [2021-06-05 Gemtexter - One Bash script to rule it all](./2021-06-05-gemtexter-one-bash-script-to-rule-it-all.md) [2021-04-24 Welcome to the Geminispace (You are currently reading this)](./2021-04-24-welcome-to-the-geminispace.md) diff --git a/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.md b/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.md index 49a2c0b4..aa18d324 100644 --- a/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.md +++ b/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.md @@ -166,6 +166,7 @@ I finally revamped my personal internet site and started to blog again. I wanted Other related posts are: +[2023-03-25 Gemtexter 2.0.0 - Let's Gemtext again^2](./2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.md) [2022-08-27 Gemtexter 1.1.0 - Let's Gemtext again](./2022-08-27-gemtexter-1.1.0-lets-gemtext-again.md) [2022-01-01 Bash Golf Part 2](./2022-01-01-bash-golf-part-2.md) [2021-11-29 Bash Golf Part 1](./2021-11-29-bash-golf-part-1.md) diff --git a/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.md b/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.md index f1f8e6bc..1916ab5b 100644 --- a/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.md +++ b/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.md @@ -87,6 +87,7 @@ Overall I think it's a pretty solid `1.1.0` release without anything groundbreak Other related posts are: +[2023-03-25 Gemtexter 2.0.0 - Let's Gemtext again^2](./2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.md) [2022-08-27 Gemtexter 1.1.0 - Let's Gemtext again (You are currently reading this)](./2022-08-27-gemtexter-1.1.0-lets-gemtext-again.md) [2021-06-05 Gemtexter - One Bash script to rule it all](./2021-06-05-gemtexter-one-bash-script-to-rule-it-all.md) [2021-04-24 Welcome to the Geminispace](./2021-04-24-welcome-to-the-geminispace.md) diff --git a/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.md b/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.md index 255aca2f..a126f199 100644 --- a/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.md +++ b/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.md @@ -136,6 +136,7 @@ Additionally, there were a couple of bug fixes, refactorings and overall improve Other related posts are: +[2023-03-25 Gemtexter 2.0.0 - Let's Gemtext again^2 (You are currently reading this)](./2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.md) [2022-08-27 Gemtexter 1.1.0 - Let's Gemtext again](./2022-08-27-gemtexter-1.1.0-lets-gemtext-again.md) [2021-06-05 Gemtexter - One Bash script to rule it all](./2021-06-05-gemtexter-one-bash-script-to-rule-it-all.md) [2021-04-24 Welcome to the Geminispace](./2021-04-24-welcome-to-the-geminispace.md) diff --git a/gemfeed/DRAFT-gemtexter-1.1.0-lets-gemtext-again-2.md b/gemfeed/DRAFT-gemtexter-1.1.0-lets-gemtext-again-2.md deleted file mode 100644 index 255aca2f..00000000 --- a/gemfeed/DRAFT-gemtexter-1.1.0-lets-gemtext-again-2.md +++ /dev/null @@ -1,145 +0,0 @@ -# Gemtexter 2.0.0 - Let's Gemtext again^2 - -``` --=[ typewriters ]=- 1/98 - - .-------. - _|~~ ~~ |_ .-------. - =(_|_______|_)= _|~~ ~~ |_ - |:::::::::| =(_|_______|_) - |:::::::[]| |:::::::::| - |o=======.| |:::::::[]| - jgs `"""""""""` |o=======.| - mod. by Paul Buetow `"""""""""` -``` - -I proudly announce that I've released Gemtexter version `2.0.0`. What is Gemtexter? It's my minimalist static site generator written in GNU Bash. - -[https://codeberg.org/snonux/gemtexter](https://codeberg.org/snonux/gemtexter) - -This is a new major release, so it contains a breaking change (see "Meta cache made obsolete"). - -Let's list what's new! - -## Minimal template engine - -Gemtexter now supports templating, enabling dynamically generated content to `.gmi` files before converting anything to any output format like HTML and Markdown. - -A template file name must have the suffix `gmi.tpl`. A template must be put into the same directory as the Gemtext `.gmi` file to be generated. Gemtexter will generate a Gemtext file `index.gmi` from a given template `index.gmi.tpl`. A `<<<` and `>>>` encloses a multiline template. All lines starting with `<< ` will be evaluated as a single line of Bash code and the output will be written into the resulting Gemtext file. - -For example, the template `index.gmi.tpl`: - -``` -# Hello world - -<< echo "> This site was generated at $(date --iso-8601=seconds) by \`Gemtexter\`" - -Welcome to this capsule! - -<<< - for i in {1..10}; do - echo Multiline template line $i - done ->>> -``` - -... results into the following `index.gmi` after running `./gemtexter --generate` (or `./gemtexter --template`, which instructs to do only template processing and nothing else): - -``` -# Hello world - -> This site was generated at 2023-03-15T19:07:59+02:00 by `Gemtexter` - -Welcome to this capsule! - -Multiline template line 1 -Multiline template line 2 -Multiline template line 3 -Multiline template line 4 -Multiline template line 5 -Multiline template line 6 -Multiline template line 7 -Multiline template line 8 -Multiline template line 9 -Multiline template line 10 -``` - -Another thing you can do is insert an index with links to similar blog posts. E.g.: - -``` -See more entries about DTail and Golang: - -<< template::inline::index dtail golang - -Blablabla... -``` - -... scans all other post entries with `dtail` and `golang` in the file name and generates a link list like this: - -``` -See more entries about DTail and Golang: - -[2022-10-30 Installing DTail on OpenBSD](./2022-10-30-installing-dtail-on-openbsd.md) -[2022-04-22 The Golang Programming language](./2022-04-22-programming-golang.md) -[2022-03-06 The release of DTail 4.0.0](./2022-03-06-the-release-of-dtail-4.0.0.md) -[2021-04-22 DTail - The distributed log tail program (You are currently reading this)](./2021-04-22-dtail-the-distributed-log-tail-program.md) - -Blablabla... -``` - -## Added hooks - -You can configure `PRE_GENERATE_HOOK` and `POST_PUBLISH_HOOK` to point to scripts to be executed before running `--generate`, or after running `--publish`. E.g. you could populate some of the content by an external script before letting Gemtexter do its thing or you could automatically deploy the site after running `--publish`. - -The sample config file `gemtexter.conf` includes this as an example now; these scripts will only be executed when they actually exist: - -``` -declare -xr PRE_GENERATE_HOOK=./pre_generate_hook.sh -declare -xr POST_PUBLISH_HOOK=./post_publish_hook.sh -``` - -## Use of safer Bash options - -Gemtexter now does `set -euf -o pipefile`, which helps to eliminate bugs and to catch scripting errors sooner. Previous versions only `set -e`. - -## Meta cache made obsolete - -Here is the breaking change to older versions of Gemtexter. The `$BASE_CONTENT_DIR/meta` directory was made obsolete. `meta` was used to store various information about all the blog post entries to make generating an Atom feed in Bash easier. Especially the publishing dates of each post were stored there. Instead, the publishing date is now encoded in the `.gmi` file. And if it is missing, Gemtexter will set it to the current date and time at first run. - -An example blog post without any publishing date looks like this: - -``` -% cat gemfeed/2023-02-26-title-here.gmi -# Title here - -The remaining content of the Gemtext file... -``` - -Gemtexter will add a line starting with `> Published at ...` now. Any subsequent Atom feed generation will then use that date. - -``` -% cat gemfeed/2023-02-26-title-here.gmi -# Title here - -> Published at 2023-02-26T21:43:51+01:00 - -The remaining content of the Gemtext file... -``` - -## XMLLint support - -Optionally, when the `xmllint` binary is installed, Gemtexter will perform a simple XML lint check against the Atom feed generated. This is a double-check of whether the Atom feed is a valid XML. - -## More - -Additionally, there were a couple of bug fixes, refactorings and overall improvements in the documentation made. - -Other related posts are: - -[2022-08-27 Gemtexter 1.1.0 - Let's Gemtext again](./2022-08-27-gemtexter-1.1.0-lets-gemtext-again.md) -[2021-06-05 Gemtexter - One Bash script to rule it all](./2021-06-05-gemtexter-one-bash-script-to-rule-it-all.md) -[2021-04-24 Welcome to the Geminispace](./2021-04-24-welcome-to-the-geminispace.md) - -E-Mail your comments to hi@paul.cyou :-) - -[Back to the main site](../) diff --git a/index.md b/index.md index 889a76b1..5d889e57 100644 --- a/index.md +++ b/index.md @@ -1,6 +1,6 @@ # foo.zone -> This site was generated at 2023-03-25T15:42:46+02:00 by `Gemtexter` +> This site was generated at 2023-03-25T15:43:55+02:00 by `Gemtexter` ``` |\---/| diff --git a/uptime-stats.md b/uptime-stats.md index 85a473dd..615f194b 100644 --- a/uptime-stats.md +++ b/uptime-stats.md @@ -1,6 +1,6 @@ # My machine uptime stats -> This site was last updated at 2023-03-25T15:42:46+02:00 +> This site was last updated at 2023-03-25T15:43:55+02:00 The following stats were collected via `uptimed` on all of my personal computers over many years and the output was generated by `guprecords`, the global uptime records stats analyser. -- cgit v1.2.3