From c6e6abcb2ff84eb2eab51ee6c07f7352e78d927b Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Sat, 24 Aug 2024 19:59:34 +0300 Subject: Update content for gemtext --- gemfeed/2008-06-26-perl-poetry.gmi | 11 + gemfeed/2008-06-26-perl-poetry.gmi.tpl | 4 + .../2011-05-07-perl-daemon-service-framework.gmi | 16 + ...011-05-07-perl-daemon-service-framework.gmi.tpl | 4 + ...-04-09-jails-and-zfs-on-freebsd-with-puppet.gmi | 11 + ...09-jails-and-zfs-on-freebsd-with-puppet.gmi.tpl | 4 + ...4-22-dtail-the-distributed-log-tail-program.gmi | 16 + ...-dtail-the-distributed-log-tail-program.gmi.tpl | 4 + gemfeed/2021-04-24-welcome-to-the-geminispace.gmi | 11 + .../2021-04-24-welcome-to-the-geminispace.gmi.tpl | 2 + ...2021-05-16-personal-bash-coding-style-guide.gmi | 24 ++ ...-05-16-personal-bash-coding-style-guide.gmi.tpl | 4 + ...05-gemtexter-one-bash-script-to-rule-it-all.gmi | 21 +- ...emtexter-one-bash-script-to-rule-it-all.gmi.tpl | 6 +- gemfeed/2021-09-12-keep-it-simple-and-stupid.gmi | 44 ++- .../2021-09-12-keep-it-simple-and-stupid.gmi.tpl | 28 +- gemfeed/2021-11-29-bash-golf-part-1.gmi | 15 + gemfeed/2021-11-29-bash-golf-part-1.gmi.tpl | 4 + gemfeed/2022-01-01-bash-golf-part-2.gmi | 14 + gemfeed/2022-01-01-bash-golf-part-2.gmi.tpl | 4 + gemfeed/2022-03-06-the-release-of-dtail-4.0.0.gmi | 20 + .../2022-03-06-the-release-of-dtail-4.0.0.gmi.tpl | 4 + .../2022-05-27-perl-is-still-a-great-choice.gmi | 12 + ...2022-05-27-perl-is-still-a-great-choice.gmi.tpl | 4 + ...022-07-30-lets-encrypt-with-openbsd-and-rex.gmi | 21 +- ...07-30-lets-encrypt-with-openbsd-and-rex.gmi.tpl | 6 +- ...22-08-27-gemtexter-1.1.0-lets-gemtext-again.gmi | 16 + ...8-27-gemtexter-1.1.0-lets-gemtext-again.gmi.tpl | 4 + gemfeed/2022-10-30-installing-dtail-on-openbsd.gmi | 17 + .../2022-10-30-installing-dtail-on-openbsd.gmi.tpl | 4 + ...-03-25-gemtexter-2.0.0-lets-gemtext-again-2.gmi | 13 + ...25-gemtexter-2.0.0-lets-gemtext-again-2.gmi.tpl | 4 + ...rithms-and-data-structures-in-golang-part-1.gmi | 12 + ...ms-and-data-structures-in-golang-part-1.gmi.tpl | 4 + ...eiling-guprecords:-uptime-records-with-raku.gmi | 10 +- ...ng-guprecords:-uptime-records-with-raku.gmi.tpl | 4 +- ...23-05-06-the-obstacle-is-the-way-book-notes.gmi | 20 +- ...5-06-the-obstacle-is-the-way-book-notes.gmi.tpl | 5 +- ...23-06-01-kiss-server-monitoring-with-gogios.gmi | 18 + ...6-01-kiss-server-monitoring-with-gogios.gmi.tpl | 2 + ...-17-career-guide-and-soft-skills-book-notes.gmi | 35 ++ ...career-guide-and-soft-skills-book-notes.gmi.tpl | 4 + ...-07-21-gemtexter-2.1.0-lets-gemtext-again-3.gmi | 14 + ...21-gemtexter-2.1.0-lets-gemtext-again-3.gmi.tpl | 4 + gemfeed/2023-09-25-dtail-usage-examples.gmi | 16 + gemfeed/2023-09-25-dtail-usage-examples.gmi.tpl | 4 + ...-static-web-photo-albums-with-photoalbum.sh.gmi | 12 + ...tic-web-photo-albums-with-photoalbum.sh.gmi.tpl | 2 + gemfeed/2023-11-11-mind-management-book-notes.gmi | 15 + .../2023-11-11-mind-management-book-notes.gmi.tpl | 4 + gemfeed/2023-12-10-bash-golf-part-3.gmi | 15 + gemfeed/2023-12-10-bash-golf-part-3.gmi.tpl | 4 + ...-quickly-logging-ideas-programmed-in-golang.gmi | 8 + ...ckly-logging-ideas-programmed-in-golang.gmi.tpl | 4 + ...4-04-01-KISS-high-availability-with-OpenBSD.gmi | 3 + ...-01-KISS-high-availability-with-OpenBSD.gmi.tpl | 2 + .../2024-05-01-slow-productivity-book-notes.gmi | 12 + ...2024-05-01-slow-productivity-book-notes.gmi.tpl | 4 + ...-03-projects-i-currently-dont-have-time-for.gmi | 8 +- ...projects-i-currently-dont-have-time-for.gmi.tpl | 4 +- .../2024-07-07-the-stoic-challenge-book-notes.gmi | 9 + ...24-07-07-the-stoic-challenge-book-notes.gmi.tpl | 4 + .../2024-08-05-typing-127.1-words-per-minute.gmi | 31 ++ ...024-08-05-typing-127.1-words-per-minute.gmi.tpl | 202 ++++++++++ gemfeed/atom.xml | 424 +++++++++++++++++++-- 65 files changed, 1220 insertions(+), 71 deletions(-) create mode 100644 gemfeed/2024-08-05-typing-127.1-words-per-minute.gmi.tpl (limited to 'gemfeed') diff --git a/gemfeed/2008-06-26-perl-poetry.gmi b/gemfeed/2008-06-26-perl-poetry.gmi index 0f3ba25b..536c9c50 100644 --- a/gemfeed/2008-06-26-perl-poetry.gmi +++ b/gemfeed/2008-06-26-perl-poetry.gmi @@ -25,6 +25,17 @@ _~~|~/_|_|__/|~~~~~~~ | / ~~~~~ | | ~~~~~~~~ (__) (____) ``` +## Table of Contents + +* ⇢ Perl Poetry +* ⇢ ⇢ Introduction +* ⇢ ⇢ math.pl +* ⇢ ⇢ christmas.pl +* ⇢ ⇢ shopping.pl +* ⇢ ⇢ More... + +## Introduction + Here are some Perl Poems I wrote. They don't do anything useful when you run them, but they don't produce a compiler error either. They only exist for fun and demonstrate what you can do with Perl syntax. Wikipedia: "Perl poetry is the practice of writing poems that can be compiled as legal Perl code, for example the piece known as Black Perl. Perl poetry is made possible by the large number of English words that are used in the Perl language. New poems are regularly submitted to the community at PerlMonks." diff --git a/gemfeed/2008-06-26-perl-poetry.gmi.tpl b/gemfeed/2008-06-26-perl-poetry.gmi.tpl index 257e21a8..01636b3d 100644 --- a/gemfeed/2008-06-26-perl-poetry.gmi.tpl +++ b/gemfeed/2008-06-26-perl-poetry.gmi.tpl @@ -25,6 +25,10 @@ _~~|~/_|_|__/|~~~~~~~ | / ~~~~~ | | ~~~~~~~~ (__) (____) ``` +<< template::inline::toc + +## Introduction + Here are some Perl Poems I wrote. They don't do anything useful when you run them, but they don't produce a compiler error either. They only exist for fun and demonstrate what you can do with Perl syntax. Wikipedia: "Perl poetry is the practice of writing poems that can be compiled as legal Perl code, for example the piece known as Black Perl. Perl poetry is made possible by the large number of English words that are used in the Perl language. New poems are regularly submitted to the community at PerlMonks." diff --git a/gemfeed/2011-05-07-perl-daemon-service-framework.gmi b/gemfeed/2011-05-07-perl-daemon-service-framework.gmi index 887a7210..78c79a9e 100644 --- a/gemfeed/2011-05-07-perl-daemon-service-framework.gmi +++ b/gemfeed/2011-05-07-perl-daemon-service-framework.gmi @@ -9,6 +9,22 @@ //\ //\\ //\ //\\ //\ //\\jrei ``` +## Table of Contents + +* ⇢ Perl Daemon (Service Framework) +* ⇢ ⇢ Introduction +* ⇢ ⇢ Features +* ⇢ ⇢ Quick Guide +* ⇢ ⇢ How to configure +* ⇢ ⇢ Example +* ⇢ ⇢ HiRes event loop +* ⇢ ⇢ Writing your own modules +* ⇢ ⇢ ⇢ Example module +* ⇢ ⇢ ⇢ Your own module +* ⇢ ⇢ May the source be with you + +## Introduction + PerlDaemon is a minimal daemon for Linux and other Unix like operating systems programmed in Perl. It is a minimal but pretty functional and fairly generic service framework. This means that it does not do anything useful other than providing a framework for starting, stopping, configuring and logging. To do something useful, a module (written in Perl) must be provided. ## Features diff --git a/gemfeed/2011-05-07-perl-daemon-service-framework.gmi.tpl b/gemfeed/2011-05-07-perl-daemon-service-framework.gmi.tpl index 36baca1c..f7baa258 100644 --- a/gemfeed/2011-05-07-perl-daemon-service-framework.gmi.tpl +++ b/gemfeed/2011-05-07-perl-daemon-service-framework.gmi.tpl @@ -9,6 +9,10 @@ //\ //\\ //\ //\\ //\ //\\jrei ``` +<< template::inline::toc + +## Introduction + PerlDaemon is a minimal daemon for Linux and other Unix like operating systems programmed in Perl. It is a minimal but pretty functional and fairly generic service framework. This means that it does not do anything useful other than providing a framework for starting, stopping, configuring and logging. To do something useful, a module (written in Perl) must be provided. ## Features diff --git a/gemfeed/2016-04-09-jails-and-zfs-on-freebsd-with-puppet.gmi b/gemfeed/2016-04-09-jails-and-zfs-on-freebsd-with-puppet.gmi index fe07f8c5..ee830eb5 100644 --- a/gemfeed/2016-04-09-jails-and-zfs-on-freebsd-with-puppet.gmi +++ b/gemfeed/2016-04-09-jails-and-zfs-on-freebsd-with-puppet.gmi @@ -22,6 +22,17 @@ \ `. ``` +## Table of Contents + +* ⇢ Jails and ZFS with Puppet on FreeBSD +* ⇢ ⇢ Introduction +* ⇢ ⇢ ZFS +* ⇢ ⇢ Jails +* ⇢ ⇢ Inside-Jail Puppet +* ⇢ ⇢ Managing multiple Jails + +## Introduction + Over the last couple of years I wrote quite a few Puppet modules in order to manage my personal server infrastructure. One of them manages FreeBSD Jails and another one ZFS file systems. I thought I would give a brief overview in how it looks and feels. ## ZFS diff --git a/gemfeed/2016-04-09-jails-and-zfs-on-freebsd-with-puppet.gmi.tpl b/gemfeed/2016-04-09-jails-and-zfs-on-freebsd-with-puppet.gmi.tpl index c5595a87..a7a311d8 100644 --- a/gemfeed/2016-04-09-jails-and-zfs-on-freebsd-with-puppet.gmi.tpl +++ b/gemfeed/2016-04-09-jails-and-zfs-on-freebsd-with-puppet.gmi.tpl @@ -22,6 +22,10 @@ \ `. ``` +<< template::inline::toc + +## Introduction + Over the last couple of years I wrote quite a few Puppet modules in order to manage my personal server infrastructure. One of them manages FreeBSD Jails and another one ZFS file systems. I thought I would give a brief overview in how it looks and feels. ## ZFS diff --git a/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program.gmi b/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program.gmi index 21e7d316..df9a037d 100644 --- a/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program.gmi +++ b/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program.gmi @@ -4,6 +4,22 @@ => ./dtail-the-distributed-log-tail-program/title.png DTail logo image +## Table of Contents + +* ⇢ DTail - The distributed log tail program +* ⇢ ⇢ Introduction +* ⇢ ⇢ A Mimecast Pet Project +* ⇢ ⇢ Differentiating from log management systems +* ⇢ ⇢ Combining simplicity, security and efficiency +* ⇢ ⇢ The DTail family of commands +* ⇢ ⇢ Usage example +* ⇢ ⇢ Fitting it in +* ⇢ ⇢ Advanced features +* ⇢ ⇢ For the future +* ⇢ ⇢ Open Source + +## Introduction + This article first appeared at the Mimecast Engineering Blog but I made it available here in my personal internet site too. => https://medium.com/mimecast-engineering/dtail-the-distributed-log-tail-program-79b8087904bb Original Mimecast Engineering Blog post at Medium diff --git a/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program.gmi.tpl b/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program.gmi.tpl index 5c955c66..97f9429d 100644 --- a/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program.gmi.tpl +++ b/gemfeed/2021-04-22-dtail-the-distributed-log-tail-program.gmi.tpl @@ -4,6 +4,10 @@ => ./dtail-the-distributed-log-tail-program/title.png DTail logo image +<< template::inline::toc + +## Introduction + This article first appeared at the Mimecast Engineering Blog but I made it available here in my personal internet site too. => https://medium.com/mimecast-engineering/dtail-the-distributed-log-tail-program-79b8087904bb Original Mimecast Engineering Blog post at Medium diff --git a/gemfeed/2021-04-24-welcome-to-the-geminispace.gmi b/gemfeed/2021-04-24-welcome-to-the-geminispace.gmi index 26e56715..a7b1bbb2 100644 --- a/gemfeed/2021-04-24-welcome-to-the-geminispace.gmi +++ b/gemfeed/2021-04-24-welcome-to-the-geminispace.gmi @@ -30,6 +30,17 @@ However, if you still use HTTP, you are just surfing the fallback HTML version o ``` +## Table of Contents + +* ⇢ Welcome to the Geminispace +* ⇢ ⇢ Motivation +* ⇢ ⇢ ⇢ My urge to revamp my personal website +* ⇢ ⇢ ⇢ My still great Laptop running hot +* ⇢ ⇢ Discovering the Gemini internet protocol +* ⇢ ⇢ My own Gemini capsule +* ⇢ ⇢ Gemini advantages summarised +* ⇢ ⇢ Dive into deep Gemini space + ## Motivation ### My urge to revamp my personal website diff --git a/gemfeed/2021-04-24-welcome-to-the-geminispace.gmi.tpl b/gemfeed/2021-04-24-welcome-to-the-geminispace.gmi.tpl index 0a036349..63586cf5 100644 --- a/gemfeed/2021-04-24-welcome-to-the-geminispace.gmi.tpl +++ b/gemfeed/2021-04-24-welcome-to-the-geminispace.gmi.tpl @@ -30,6 +30,8 @@ However, if you still use HTTP, you are just surfing the fallback HTML version o ``` +<< template::inline::toc + ## Motivation ### My urge to revamp my personal website diff --git a/gemfeed/2021-05-16-personal-bash-coding-style-guide.gmi b/gemfeed/2021-05-16-personal-bash-coding-style-guide.gmi index 349b39b5..1765f71d 100644 --- a/gemfeed/2021-05-16-personal-bash-coding-style-guide.gmi +++ b/gemfeed/2021-05-16-personal-bash-coding-style-guide.gmi @@ -15,6 +15,30 @@ "\__/"---------------"\__/"-+---+' ``` +## Table of Contents + +* ⇢ Personal Bash coding style guide +* ⇢ ⇢ Introduction +* ⇢ ⇢ My modifications +* ⇢ ⇢ ⇢ Shebang +* ⇢ ⇢ ⇢ Two space soft-tabs indentation +* ⇢ ⇢ ⇢ Breaking long pipes +* ⇢ ⇢ ⇢ Quoting your variables +* ⇢ ⇢ ⇢ Prefer built-in commands over external commands +* ⇢ ⇢ My additions +* ⇢ ⇢ ⇢ Use of 'yes' and 'no' +* ⇢ ⇢ ⇢ Non-evil alternative to variable assignments via eval +* ⇢ ⇢ ⇢ Prefer pipes over arrays for list processing +* ⇢ ⇢ ⇢ Assign-then-shift +* ⇢ ⇢ ⇢ Paranoid mode +* ⇢ ⇢ Learned +* ⇢ ⇢ ⇢ Unintended lexicographical comparison. +* ⇢ ⇢ ⇢ PIPESTATUS +* ⇢ ⇢ Use common sense and BE CONSISTENT. +* ⇢ ⇢ Advanced Bash learning pro tip + +## Introduction + Lately, I have been polishing and writing a lot of Bash code. Not that I never wrote a lot of Bash, but now as I also looked through the Google Shell Style Guide, I thought it is time also to write my thoughts on that. I agree with that guide in most, but not in all points. => https://google.github.io/styleguide/shellguide.html Google Shell Style Guide diff --git a/gemfeed/2021-05-16-personal-bash-coding-style-guide.gmi.tpl b/gemfeed/2021-05-16-personal-bash-coding-style-guide.gmi.tpl index 04e3f708..32e255f3 100644 --- a/gemfeed/2021-05-16-personal-bash-coding-style-guide.gmi.tpl +++ b/gemfeed/2021-05-16-personal-bash-coding-style-guide.gmi.tpl @@ -15,6 +15,10 @@ "\__/"---------------"\__/"-+---+' ``` +<< template::inline::toc + +## Introduction + Lately, I have been polishing and writing a lot of Bash code. Not that I never wrote a lot of Bash, but now as I also looked through the Google Shell Style Guide, I thought it is time also to write my thoughts on that. I agree with that guide in most, but not in all points. => https://google.github.io/styleguide/shellguide.html Google Shell Style Guide diff --git a/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.gmi b/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.gmi index c8e39d48..4f5c0c3c 100644 --- a/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.gmi +++ b/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.gmi @@ -43,11 +43,30 @@ `+a:f:......jrei''' ``` +## Table of Contents + +* ⇢ Gemtexter - One Bash script to rule it all +* ⇢ ⇢ Introduction +* ⇢ ⇢ ⇢ Motivation +* ⇢ ⇢ Output formats +* ⇢ ⇢ Taking it as far as I should, but no farther +* ⇢ ⇢ ⇢ Modularization +* ⇢ ⇢ ⇢ Bash best practises and ShellCheck +* ⇢ ⇢ ⇢ Unit testing +* ⇢ ⇢ ⇢ HTML unit test example +* ⇢ ⇢ ⇢ Markdown unit test example +* ⇢ ⇢ Handcrafted HTML styles +* ⇢ ⇢ Configurability +* ⇢ ⇢ Future features +* ⇢ ⇢ Conclusion + +## Introduction + You might have read my previous blog posts about entering the Geminispace, where I pointed out the benefits of having and maintaining an internet presence there. This whole site (the blog and all other pages) is composed in the Gemtext markup language. This comes with the benefit that I can write content in my favourite text editor (Vim). -## Motivation +### Motivation Another benefit of using Gemini is that the Gemtext markup language is easy to parse. As my site is dual-hosted (Gemini+HTTP), I could, in theory, just write a shell script to deal with the conversion from Gemtext to HTML; there is no need for a full-featured programming language here. I have done a lot of Bash in the past, but I am also often revisiting old tools and techniques for refreshing and keeping the knowledge up to date here. diff --git a/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.gmi.tpl b/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.gmi.tpl index 61cd65be..f45bedec 100644 --- a/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.gmi.tpl +++ b/gemfeed/2021-06-05-gemtexter-one-bash-script-to-rule-it-all.gmi.tpl @@ -43,11 +43,15 @@ `+a:f:......jrei''' ``` +<< template::inline::toc + +## Introduction + You might have read my previous blog posts about entering the Geminispace, where I pointed out the benefits of having and maintaining an internet presence there. This whole site (the blog and all other pages) is composed in the Gemtext markup language. This comes with the benefit that I can write content in my favourite text editor (Vim). -## Motivation +### Motivation Another benefit of using Gemini is that the Gemtext markup language is easy to parse. As my site is dual-hosted (Gemini+HTTP), I could, in theory, just write a shell script to deal with the conversion from Gemtext to HTML; there is no need for a full-featured programming language here. I have done a lot of Bash in the past, but I am also often revisiting old tools and techniques for refreshing and keeping the knowledge up to date here. diff --git a/gemfeed/2021-09-12-keep-it-simple-and-stupid.gmi b/gemfeed/2021-09-12-keep-it-simple-and-stupid.gmi index 834c4020..51f97223 100644 --- a/gemfeed/2021-09-12-keep-it-simple-and-stupid.gmi +++ b/gemfeed/2021-09-12-keep-it-simple-and-stupid.gmi @@ -17,25 +17,45 @@ -------------------- -------------------- ``` +## Table of Contents + +* ⇢ Keep it simple and stupid +* ⇢ ⇢ Introduction +* ⇢ ⇢ Need faster hardware +* ⇢ ⇢ Too complex to be replaced +* ⇢ ⇢ ⇢ On COBOL +* ⇢ ⇢ ⇢ On Kubernetes +* ⇢ ⇢ ⇢ The younger generation of IT professionals +* ⇢ ⇢ The bloated web +* ⇢ ⇢ Fancy log-management solutions +* ⇢ ⇢ More KISS +* ⇢ ⇢ ⇢ The Adslowbe PDF Reader +* ⇢ ⇢ ⇢ The power of plain text files +* ⇢ ⇢ ⇢ KISS for programmers +* ⇢ ⇢ When KISS is not KISS anymore +* ⇢ ⇢ Other relevant readings + +## Introduction + A robust computer system must be kept simple and stupid (KISS). The fancier the system is, the more can break. Unfortunately, most systems tend to become complex and challenging to maintain in today's world. In the early days, so I was told, engineers understood every part of the system, but nowadays, we see more of the "lasagna" stack. One layer or framework is built on top of another layer, and in the end, nobody has got a clue what's going on. -# Need faster hardware +## Need faster hardware This not just makes the system much more complex, difficult to maintain and challenging to troubleshoot, but also slow. So more experts are needed to support it. Also, newer and faster hardware is required to make it run smoothly. Often, it's so much easier to buy speedier hardware than rewrite a whole system from scratch from the bottom-up. The latter would require much more resources in the short run, but in the long run, it should pay off. Unfortunately, many project owners scare away from it as they only want to get their project done and then move on. -# Too complex to be replaced +## Too complex to be replaced -## On COBOL +### On COBOL Have a look at COBOL, a prevalent programming language of the past. No one is learning COBOL in college or university anymore, but many legacy systems still require COBOL experts. Why is this? It's just too scary to write everything from scratch. There's too much COBOL code out there that can't be replaced from today to tomorrow. => https://nymag.com/intelligencer/2020/04/what-is-cobol-what-does-it-have-to-do-with-the-coronavirus.html -## On Kubernetes +### On Kubernetes Now have a look at Kubernetes (k8s), the current trendy infrastructure thing to use nowadays. Of course, there are many benefits of using k8s (auto-scaling, reproducible deployments, dynamic resource allocation and resource sharing, saving of hardware costs, good commercial for potential employees as it is the current hot sauce of infrastructure). But all of this also comes with costs: You need experts operating the k8s cluster (or you need to pay extra for a managed cluster in the cloud), increased complexity of the system (k8s comes with a steep learning curve). The latter not only applies to the engineers managing the k8s cluster - it also applies to the software engineers, who now have to develop 'cloud native' applications and, therefore, have to change how they developed software how they used to. They all need to be re-educated on what cloud-native means, and they also need to understand the key concepts of k8s for writing optimal software for it. -## The younger generation of IT professionals +### The younger generation of IT professionals Maybe the younger generation knows all of this already after graduation, but then they are missing other critical parts of the system for sure. I have seen engineers who knew about containers and how to configure resource restrictions for a Docker container managed via k8s but have never heard the terms Linux control groups and Linux namespaces. So obviously, there is some knowledge gap of the underlying architecture. This can be a big problem when you have to troubleshoot such a system during a production incident and k8s adds a lot of abstraction to the mix which doesn't make it easier. @@ -51,7 +71,7 @@ And here is something to smile about: => https://christine.website/blog/theres-a-node-2021-10-02 -# The bloated web +## The bloated web Another example is the modern web. Have you ever wondered why the internet becomes slower and slower nowadays? The modern web is so much like lasagna that I decided to use Gemini to be the primary protocol of my website. The HTML version of this website is just a fallback as many visitors don't know what Gemini is and don't have any compatible software installed for surfing the Geminispace: @@ -59,7 +79,7 @@ Another example is the modern web. Have you ever wondered why the internet becom The Gemtext protocol is KISS. There's no way to do other formattings than headings, links, paragraphs, lists, quotes, and bare text blocks (e.g., ASCII art or code snippets). There's no way to create bloated Gemini sites, and due to its limited capabilities, there's also no way to commercialise it (e.g. there's no good way to track the site visitors as things like cookies don't exist). By design, the Gemini protocol can't be extended, so there is no chance to abuse it even in the future. Gemini sites will stay KISS forever, and there won't be any fancy HTML/JavaScript frameworks like we see on the modern web. -# Fancy log-management solutions +## Fancy log-management solutions Yet another example I want to bring up is DTail, the distributed log tail program I wrote. There are many great and fancy log-management solutions available to choose from, and they all seem complex to set up and maintain. The ELK stack, for example, requires you to operate an ElasticSearch cluster (or multiple, if you are geo-redundant), Logstash (different configurations and instances, depending on your infrastructure) and a Kibana web-frontend (which also needs to be highly available). I have operated ElasticSearch clusters on multiple occasions, and I must say that it is not an easy task to optimise it for the particular workload you might encounter. I also have seen many ES clusters operated by other people, and I have seen these clusters failing a lot (so it's not just me). The reduced complexity of DTail also makes it more robust against outages. You won't troubleshoot your distributed application very well if the log management infrastructure isn't working either. @@ -67,23 +87,23 @@ Yet another example I want to bring up is DTail, the distributed log tail progra I don't say that the ELK stack doesn't work, but it requires experts and additional hardware resources to support it. But instead, if you keep your infrastructure simple (e.g. only use DTail), it will maintain pretty much by itself. -# More KISS +## More KISS -## The Adslowbe PDF Reader +### The Adslowbe PDF Reader Another perfect example is the Adobe PDF reader. How can it be that the inventor of the PDF format creates such a terrible user experience with its official reader? The reader is awful bloated, and slow. There are much better alternatives around (especially for Linux and other UNIX like operating systems, look at Zathura for example). I believe the reason Adobe's reader is like this is featuritis, and 90% of the users don't use 90% of all available features. Less is more; keep it simple and stupid. -## The power of plain text files +### The power of plain text files Speaking of file formats, never underestimate the power of plain text files. Plain text files don't require any special software to be opened, and they outlive the software which created them in the first place. You will still be able to read a plain text file on a modern computer system ten (or twenty) years from now, but you probably won't be able to read such an old version of an Adobe Photoshop image file if the software required for reading that format isn't supported anymore and doesn't run anymore on modern computers. -## KISS for programmers +### KISS for programmers Not to mention, keeping things simple and stupid also reduces the potential malicious attack surface. It's not just about the software and services you use and operate. It's also about the software you write. Here is a nice article about the KISS principle in software development: => https://thevaluable.dev/kiss-principle-explained/ -# When KISS is not KISS anymore +## When KISS is not KISS anymore There is, however, a trap. The more you spend time with things, the more these things feel natural to you and you become an expert. The more you become an expert, the more you introduce more abstractions and other clever ways of doing things. For you, things seem to be KISS still, but another person may not be an expert and might not understand what you do. One of the fundamental challenges is to keep things really KISS. You might add abstraction upon abstraction to a system and don't even notice it until it is too late. diff --git a/gemfeed/2021-09-12-keep-it-simple-and-stupid.gmi.tpl b/gemfeed/2021-09-12-keep-it-simple-and-stupid.gmi.tpl index 753587bf..008f1662 100644 --- a/gemfeed/2021-09-12-keep-it-simple-and-stupid.gmi.tpl +++ b/gemfeed/2021-09-12-keep-it-simple-and-stupid.gmi.tpl @@ -17,25 +17,29 @@ -------------------- -------------------- ``` +<< template::inline::toc + +## Introduction + A robust computer system must be kept simple and stupid (KISS). The fancier the system is, the more can break. Unfortunately, most systems tend to become complex and challenging to maintain in today's world. In the early days, so I was told, engineers understood every part of the system, but nowadays, we see more of the "lasagna" stack. One layer or framework is built on top of another layer, and in the end, nobody has got a clue what's going on. -# Need faster hardware +## Need faster hardware This not just makes the system much more complex, difficult to maintain and challenging to troubleshoot, but also slow. So more experts are needed to support it. Also, newer and faster hardware is required to make it run smoothly. Often, it's so much easier to buy speedier hardware than rewrite a whole system from scratch from the bottom-up. The latter would require much more resources in the short run, but in the long run, it should pay off. Unfortunately, many project owners scare away from it as they only want to get their project done and then move on. -# Too complex to be replaced +## Too complex to be replaced -## On COBOL +### On COBOL Have a look at COBOL, a prevalent programming language of the past. No one is learning COBOL in college or university anymore, but many legacy systems still require COBOL experts. Why is this? It's just too scary to write everything from scratch. There's too much COBOL code out there that can't be replaced from today to tomorrow. => https://nymag.com/intelligencer/2020/04/what-is-cobol-what-does-it-have-to-do-with-the-coronavirus.html -## On Kubernetes +### On Kubernetes Now have a look at Kubernetes (k8s), the current trendy infrastructure thing to use nowadays. Of course, there are many benefits of using k8s (auto-scaling, reproducible deployments, dynamic resource allocation and resource sharing, saving of hardware costs, good commercial for potential employees as it is the current hot sauce of infrastructure). But all of this also comes with costs: You need experts operating the k8s cluster (or you need to pay extra for a managed cluster in the cloud), increased complexity of the system (k8s comes with a steep learning curve). The latter not only applies to the engineers managing the k8s cluster - it also applies to the software engineers, who now have to develop 'cloud native' applications and, therefore, have to change how they developed software how they used to. They all need to be re-educated on what cloud-native means, and they also need to understand the key concepts of k8s for writing optimal software for it. -## The younger generation of IT professionals +### The younger generation of IT professionals Maybe the younger generation knows all of this already after graduation, but then they are missing other critical parts of the system for sure. I have seen engineers who knew about containers and how to configure resource restrictions for a Docker container managed via k8s but have never heard the terms Linux control groups and Linux namespaces. So obviously, there is some knowledge gap of the underlying architecture. This can be a big problem when you have to troubleshoot such a system during a production incident and k8s adds a lot of abstraction to the mix which doesn't make it easier. @@ -51,7 +55,7 @@ And here is something to smile about: => https://christine.website/blog/theres-a-node-2021-10-02 -# The bloated web +## The bloated web Another example is the modern web. Have you ever wondered why the internet becomes slower and slower nowadays? The modern web is so much like lasagna that I decided to use Gemini to be the primary protocol of my website. The HTML version of this website is just a fallback as many visitors don't know what Gemini is and don't have any compatible software installed for surfing the Geminispace: @@ -59,7 +63,7 @@ Another example is the modern web. Have you ever wondered why the internet becom The Gemtext protocol is KISS. There's no way to do other formattings than headings, links, paragraphs, lists, quotes, and bare text blocks (e.g., ASCII art or code snippets). There's no way to create bloated Gemini sites, and due to its limited capabilities, there's also no way to commercialise it (e.g. there's no good way to track the site visitors as things like cookies don't exist). By design, the Gemini protocol can't be extended, so there is no chance to abuse it even in the future. Gemini sites will stay KISS forever, and there won't be any fancy HTML/JavaScript frameworks like we see on the modern web. -# Fancy log-management solutions +## Fancy log-management solutions Yet another example I want to bring up is DTail, the distributed log tail program I wrote. There are many great and fancy log-management solutions available to choose from, and they all seem complex to set up and maintain. The ELK stack, for example, requires you to operate an ElasticSearch cluster (or multiple, if you are geo-redundant), Logstash (different configurations and instances, depending on your infrastructure) and a Kibana web-frontend (which also needs to be highly available). I have operated ElasticSearch clusters on multiple occasions, and I must say that it is not an easy task to optimise it for the particular workload you might encounter. I also have seen many ES clusters operated by other people, and I have seen these clusters failing a lot (so it's not just me). The reduced complexity of DTail also makes it more robust against outages. You won't troubleshoot your distributed application very well if the log management infrastructure isn't working either. @@ -67,23 +71,23 @@ Yet another example I want to bring up is DTail, the distributed log tail progra I don't say that the ELK stack doesn't work, but it requires experts and additional hardware resources to support it. But instead, if you keep your infrastructure simple (e.g. only use DTail), it will maintain pretty much by itself. -# More KISS +## More KISS -## The Adslowbe PDF Reader +### The Adslowbe PDF Reader Another perfect example is the Adobe PDF reader. How can it be that the inventor of the PDF format creates such a terrible user experience with its official reader? The reader is awful bloated, and slow. There are much better alternatives around (especially for Linux and other UNIX like operating systems, look at Zathura for example). I believe the reason Adobe's reader is like this is featuritis, and 90% of the users don't use 90% of all available features. Less is more; keep it simple and stupid. -## The power of plain text files +### The power of plain text files Speaking of file formats, never underestimate the power of plain text files. Plain text files don't require any special software to be opened, and they outlive the software which created them in the first place. You will still be able to read a plain text file on a modern computer system ten (or twenty) years from now, but you probably won't be able to read such an old version of an Adobe Photoshop image file if the software required for reading that format isn't supported anymore and doesn't run anymore on modern computers. -## KISS for programmers +### KISS for programmers Not to mention, keeping things simple and stupid also reduces the potential malicious attack surface. It's not just about the software and services you use and operate. It's also about the software you write. Here is a nice article about the KISS principle in software development: => https://thevaluable.dev/kiss-principle-explained/ -# When KISS is not KISS anymore +## When KISS is not KISS anymore There is, however, a trap. The more you spend time with things, the more these things feel natural to you and you become an expert. The more you become an expert, the more you introduce more abstractions and other clever ways of doing things. For you, things seem to be KISS still, but another person may not be an expert and might not understand what you do. One of the fundamental challenges is to keep things really KISS. You might add abstraction upon abstraction to a system and don't even notice it until it is too late. diff --git a/gemfeed/2021-11-29-bash-golf-part-1.gmi b/gemfeed/2021-11-29-bash-golf-part-1.gmi index ebb317d7..0e6ef0fe 100644 --- a/gemfeed/2021-11-29-bash-golf-part-1.gmi +++ b/gemfeed/2021-11-29-bash-golf-part-1.gmi @@ -14,6 +14,21 @@ jgs^^^^^^^`^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Art by Joan Stark ``` +## Table of Contents + +* ⇢ Bash Golf Part 1 +* ⇢ ⇢ Introduction +* ⇢ ⇢ TCP/IP networking +* ⇢ ⇢ Process substitution +* ⇢ ⇢ Grouping +* ⇢ ⇢ Expansions +* ⇢ ⇢ - aka stdin and stdout placeholder +* ⇢ ⇢ Alternative argument passing +* ⇢ ⇢ : aka the null command +* ⇢ ⇢ (No) floating point support + +## Introduction + This is the first blog post about my Bash Golf series. This series is about random Bash tips, tricks and weirdnesses I came across. It's a collection of smaller articles I wrote in an older (in German language) blog, which I translated and refreshed with some new content. => ./2021-11-29-bash-golf-part-1.gmi 2021-11-29 Bash Golf Part 1 (You are currently reading this) diff --git a/gemfeed/2021-11-29-bash-golf-part-1.gmi.tpl b/gemfeed/2021-11-29-bash-golf-part-1.gmi.tpl index 5b5885a4..0f4c0d21 100644 --- a/gemfeed/2021-11-29-bash-golf-part-1.gmi.tpl +++ b/gemfeed/2021-11-29-bash-golf-part-1.gmi.tpl @@ -14,6 +14,10 @@ jgs^^^^^^^`^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Art by Joan Stark ``` +<< template::inline::toc + +## Introduction + This is the first blog post about my Bash Golf series. This series is about random Bash tips, tricks and weirdnesses I came across. It's a collection of smaller articles I wrote in an older (in German language) blog, which I translated and refreshed with some new content. << template::inline::index bash-golf diff --git a/gemfeed/2022-01-01-bash-golf-part-2.gmi b/gemfeed/2022-01-01-bash-golf-part-2.gmi index 2fc2d2be..815cd361 100644 --- a/gemfeed/2022-01-01-bash-golf-part-2.gmi +++ b/gemfeed/2022-01-01-bash-golf-part-2.gmi @@ -14,6 +14,20 @@ jgs^^^^^^^`^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Art by Joan Stark, mod. by Paul Buetow ``` +## Table of Contents + +* ⇢ Bash Golf Part 2 +* ⇢ ⇢ Introduction +* ⇢ ⇢ Redirection +* ⇢ ⇢ HERE +* ⇢ ⇢ RANDOM +* ⇢ ⇢ set -x and set -e and pipefile +* ⇢ ⇢ ⇢ -x +* ⇢ ⇢ ⇢ -e +* ⇢ ⇢ ⇢ pipefail + +## Introduction + This is the second blog post about my Bash Golf series. This series is random Bash tips, tricks and weirdnesses I came across. It's a collection of smaller articles I wrote in an older (in German language) blog, which I translated and refreshed with some new content. => ./2021-11-29-bash-golf-part-1.gmi 2021-11-29 Bash Golf Part 1 diff --git a/gemfeed/2022-01-01-bash-golf-part-2.gmi.tpl b/gemfeed/2022-01-01-bash-golf-part-2.gmi.tpl index ec589a69..8a834664 100644 --- a/gemfeed/2022-01-01-bash-golf-part-2.gmi.tpl +++ b/gemfeed/2022-01-01-bash-golf-part-2.gmi.tpl @@ -14,6 +14,10 @@ jgs^^^^^^^`^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Art by Joan Stark, mod. by Paul Buetow ``` +<< template::inline::toc + +## Introduction + This is the second blog post about my Bash Golf series. This series is random Bash tips, tricks and weirdnesses I came across. It's a collection of smaller articles I wrote in an older (in German language) blog, which I translated and refreshed with some new content. << template::inline::index bash-golf diff --git a/gemfeed/2022-03-06-the-release-of-dtail-4.0.0.gmi b/gemfeed/2022-03-06-the-release-of-dtail-4.0.0.gmi index cd8bb6a4..eb4903f5 100644 --- a/gemfeed/2022-03-06-the-release-of-dtail-4.0.0.gmi +++ b/gemfeed/2022-03-06-the-release-of-dtail-4.0.0.gmi @@ -16,6 +16,26 @@ | | ``` +## Table of Contents + +* ⇢ The release of DTail 4.0.0 +* ⇢ ⇢ Introduction +* ⇢ ⇢ So, what's new in 4.0.0? +* ⇢ ⇢ ⇢ Rewritten logging +* ⇢ ⇢ ⇢ Configurable terminal color codes +* ⇢ ⇢ ⇢ Serverless mode +* ⇢ ⇢ ⇢ Shorthand flags +* ⇢ ⇢ ⇢ Spartan (aka plain) mode +* ⇢ ⇢ ⇢ Standard input pipe +* ⇢ ⇢ ⇢ New command dtailhealth +* ⇢ ⇢ ⇢ Improved documentation +* ⇢ ⇢ ⇢ Integration testing suite +* ⇢ ⇢ ⇢ Improved code +* ⇢ ⇢ ⇢ Use of memory pools +* ⇢ ⇢ What's next + +## Introduction + I have recently released DTail 4.0.0 and this blog post goes through all the new goodies. If you want to jump directly to DTail, do it here (there are nice animated gifs which demonstrates the usage pretty well): => https://dtail.dev diff --git a/gemfeed/2022-03-06-the-release-of-dtail-4.0.0.gmi.tpl b/gemfeed/2022-03-06-the-release-of-dtail-4.0.0.gmi.tpl index a7d6bdd5..a8f3a111 100644 --- a/gemfeed/2022-03-06-the-release-of-dtail-4.0.0.gmi.tpl +++ b/gemfeed/2022-03-06-the-release-of-dtail-4.0.0.gmi.tpl @@ -16,6 +16,10 @@ | | ``` +<< template::inline::toc + +## Introduction + I have recently released DTail 4.0.0 and this blog post goes through all the new goodies. If you want to jump directly to DTail, do it here (there are nice animated gifs which demonstrates the usage pretty well): => https://dtail.dev diff --git a/gemfeed/2022-05-27-perl-is-still-a-great-choice.gmi b/gemfeed/2022-05-27-perl-is-still-a-great-choice.gmi index 5719847c..cc7ccd07 100644 --- a/gemfeed/2022-05-27-perl-is-still-a-great-choice.gmi +++ b/gemfeed/2022-05-27-perl-is-still-a-great-choice.gmi @@ -4,6 +4,18 @@ => ./perl-is-still-a-great-choice/regular_expressions.png Comic source: XKCD +## Table of Contents + +* ⇢ Perl is still a great choice +* ⇢ ⇢ Introduction +* ⇢ ⇢ Write-only language +* ⇢ ⇢ Is Perl abandoned? +* ⇢ ⇢ Why use Perl as there are better alternatives? +* ⇢ ⇢ Why all the sigils? It looks like an exploding ASCII factory!! +* ⇢ ⇢ Where do I personally still use perl? + +## Introduction + Perl (the Practical Extraction and Report Language) is a battle-tested, mature, multi-paradigm dynamic programming language. Note that it's not called PERL, neither P.E.R.L. nor Pearl. "Perl" is the name of the language and `perl` the name of the interpreter or the interpreter command. Unfortunately (it makes me sad), Perl's popularity has been declining over the last years as Google trends shows: diff --git a/gemfeed/2022-05-27-perl-is-still-a-great-choice.gmi.tpl b/gemfeed/2022-05-27-perl-is-still-a-great-choice.gmi.tpl index ea0170e2..890de11c 100644 --- a/gemfeed/2022-05-27-perl-is-still-a-great-choice.gmi.tpl +++ b/gemfeed/2022-05-27-perl-is-still-a-great-choice.gmi.tpl @@ -4,6 +4,10 @@ => ./perl-is-still-a-great-choice/regular_expressions.png Comic source: XKCD +<< template::inline::toc + +## Introduction + Perl (the Practical Extraction and Report Language) is a battle-tested, mature, multi-paradigm dynamic programming language. Note that it's not called PERL, neither P.E.R.L. nor Pearl. "Perl" is the name of the language and `perl` the name of the interpreter or the interpreter command. Unfortunately (it makes me sad), Perl's popularity has been declining over the last years as Google trends shows: diff --git a/gemfeed/2022-07-30-lets-encrypt-with-openbsd-and-rex.gmi b/gemfeed/2022-07-30-lets-encrypt-with-openbsd-and-rex.gmi index 9180891b..31c5cc2c 100644 --- a/gemfeed/2022-07-30-lets-encrypt-with-openbsd-and-rex.gmi +++ b/gemfeed/2022-07-30-lets-encrypt-with-openbsd-and-rex.gmi @@ -29,9 +29,28 @@ ASCII Art by John Savard ``` +## Table of Contents + +* ⇢ Let's Encrypt with OpenBSD and Rex +* ⇢ ⇢ Introduction +* ⇢ ⇢ ⇢ What's Let's Encrypt? +* ⇢ ⇢ Meet `acme-client` +* ⇢ ⇢ Configuration +* ⇢ ⇢ ⇢ acme-client.conf +* ⇢ ⇢ ⇢ httpd.conf +* ⇢ ⇢ ⇢ CRON job +* ⇢ ⇢ relayd.conf and smtpd.conf +* ⇢ ⇢ Rexification +* ⇢ ⇢ ⇢ General ACME client configuration +* ⇢ ⇢ ⇢ Service rexification +* ⇢ ⇢ All pieces together +* ⇢ ⇢ Conclusion + +## Introduction + I was amazed at how easy it is to automatically generate and update Let's Encrypt certificates with OpenBSD. -## What's Let's Encrypt? +### What's Let's Encrypt? > Let's Encrypt is a non-profit certificate authority run by Internet Security Research Group that provides X.509 certificates for Transport Layer Security (TLS) encryption at no charge. It is the world's largest certificate authority, used by more than 265 million websites, with the goal of all websites being secure and using HTTPS. diff --git a/gemfeed/2022-07-30-lets-encrypt-with-openbsd-and-rex.gmi.tpl b/gemfeed/2022-07-30-lets-encrypt-with-openbsd-and-rex.gmi.tpl index de5ee1f0..6797ff2d 100644 --- a/gemfeed/2022-07-30-lets-encrypt-with-openbsd-and-rex.gmi.tpl +++ b/gemfeed/2022-07-30-lets-encrypt-with-openbsd-and-rex.gmi.tpl @@ -29,9 +29,13 @@ ASCII Art by John Savard ``` +<< template::inline::toc + +## Introduction + I was amazed at how easy it is to automatically generate and update Let's Encrypt certificates with OpenBSD. -## What's Let's Encrypt? +### What's Let's Encrypt? > Let's Encrypt is a non-profit certificate authority run by Internet Security Research Group that provides X.509 certificates for Transport Layer Security (TLS) encryption at no charge. It is the world's largest certificate authority, used by more than 265 million websites, with the goal of all websites being secure and using HTTPS. diff --git a/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.gmi b/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.gmi index 2e0d0535..eb841254 100644 --- a/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.gmi +++ b/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.gmi @@ -14,6 +14,22 @@ jgs `"""""""""` ``` +## Table of Contents + +* ⇢ Gemtexter 1.1.0 - Let's Gemtext again +* ⇢ ⇢ Introduction +* ⇢ ⇢ What's new? +* ⇢ ⇢ ⇢ Automatic check for GNU version requirements +* ⇢ ⇢ ⇢ Backticks now produce `inline code blocks` in the HTML output +* ⇢ ⇢ ⇢ Cache for Atom feed generation +* ⇢ ⇢ ⇢ Input filter support +* ⇢ ⇢ ⇢ Revamped `git` support +* ⇢ ⇢ ⇢ Addition of `htmlextras` and web font support +* ⇢ ⇢ ⇢ Sub-section support +* ⇢ ⇢ ⇢ More + +## Introduction + I proudly announce that I've released Gemtexter version `1.1.0`. What is Gemtexter? It's my minimalist static site generator for Gemini Gemtext, HTML and Markdown written in GNU Bash. => https://codeberg.org/snonux/gemtexter diff --git a/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.gmi.tpl b/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.gmi.tpl index 383a5d39..1fb173da 100644 --- a/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.gmi.tpl +++ b/gemfeed/2022-08-27-gemtexter-1.1.0-lets-gemtext-again.gmi.tpl @@ -14,6 +14,10 @@ jgs `"""""""""` ``` +<< template::inline::toc + +## Introduction + I proudly announce that I've released Gemtexter version `1.1.0`. What is Gemtexter? It's my minimalist static site generator for Gemini Gemtext, HTML and Markdown written in GNU Bash. => https://codeberg.org/snonux/gemtexter diff --git a/gemfeed/2022-10-30-installing-dtail-on-openbsd.gmi b/gemfeed/2022-10-30-installing-dtail-on-openbsd.gmi index 5941a7cb..da44662d 100644 --- a/gemfeed/2022-10-30-installing-dtail-on-openbsd.gmi +++ b/gemfeed/2022-10-30-installing-dtail-on-openbsd.gmi @@ -39,6 +39,23 @@ ' ' ``` +## Table of Contents + +* ⇢ Installing DTail on OpenBSD +* ⇢ ⇢ Introduction +* ⇢ ⇢ Compile it +* ⇢ ⇢ Install it +* ⇢ ⇢ ⇢ Rexification +* ⇢ ⇢ Configure it +* ⇢ ⇢ ⇢ Rexification +* ⇢ ⇢ Update the key cache for it +* ⇢ ⇢ ⇢ Rexification +* ⇢ ⇢ Start it +* ⇢ ⇢ Use it +* ⇢ ⇢ Conclusions + +## Introduction + This will be a quick blog post, as I am busy with my personal life now. I have relocated to a different country and am still busy arranging things. So bear with me :-) In this post, I want to give a quick overview (or how-to) about installing DTail on OpenBSD, as the official documentation only covers Red Hat and Fedora Linux! And this blog post will also be used as my reference! diff --git a/gemfeed/2022-10-30-installing-dtail-on-openbsd.gmi.tpl b/gemfeed/2022-10-30-installing-dtail-on-openbsd.gmi.tpl index 2bb239e2..d09bf49a 100644 --- a/gemfeed/2022-10-30-installing-dtail-on-openbsd.gmi.tpl +++ b/gemfeed/2022-10-30-installing-dtail-on-openbsd.gmi.tpl @@ -39,6 +39,10 @@ ' ' ``` +<< template::inline::toc + +## Introduction + This will be a quick blog post, as I am busy with my personal life now. I have relocated to a different country and am still busy arranging things. So bear with me :-) In this post, I want to give a quick overview (or how-to) about installing DTail on OpenBSD, as the official documentation only covers Red Hat and Fedora Linux! And this blog post will also be used as my reference! diff --git a/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.gmi b/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.gmi index 82e61126..6adcfdee 100644 --- a/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.gmi +++ b/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.gmi @@ -15,6 +15,19 @@ mod. by Paul Buetow `"""""""""` ``` +## Table of Contents + +* ⇢ Gemtexter 2.0.0 - Let's Gemtext again² +* ⇢ ⇢ Introduction +* ⇢ ⇢ Minimal template engine +* ⇢ ⇢ Added hooks +* ⇢ ⇢ Use of safer Bash options +* ⇢ ⇢ Meta cache made obsolete +* ⇢ ⇢ XMLLint support +* ⇢ ⇢ More + +## Introduction + I proudly announce that I've released Gemtexter version `2.0.0`. What is Gemtexter? It's my minimalist static site generator for Gemini Gemtext, HTML and Markdown written in GNU Bash. => https://codeberg.org/snonux/gemtexter diff --git a/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.gmi.tpl b/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.gmi.tpl index 2e322cac..a8ed98e5 100644 --- a/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.gmi.tpl +++ b/gemfeed/2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.gmi.tpl @@ -15,6 +15,10 @@ mod. by Paul Buetow `"""""""""` ``` +<< template::inline::toc + +## Introduction + I proudly announce that I've released Gemtexter version `2.0.0`. What is Gemtexter? It's my minimalist static site generator for Gemini Gemtext, HTML and Markdown written in GNU Bash. => https://codeberg.org/snonux/gemtexter diff --git a/gemfeed/2023-04-09-algorithms-and-data-structures-in-golang-part-1.gmi b/gemfeed/2023-04-09-algorithms-and-data-structures-in-golang-part-1.gmi index 3a05cd59..aa12a353 100644 --- a/gemfeed/2023-04-09-algorithms-and-data-structures-in-golang-part-1.gmi +++ b/gemfeed/2023-04-09-algorithms-and-data-structures-in-golang-part-1.gmi @@ -16,6 +16,18 @@ | | ``` +## Table of Contents + +* ⇢ Algorithms and Data Structures in Go - Part 1 +* ⇢ ⇢ Introduction +* ⇢ ⇢ Type constraints +* ⇢ ⇢ ArrayList +* ⇢ ⇢ Helper methods +* ⇢ ⇢ Sleep sort +* ⇢ ⇢ ⇢ Testing + +## Introduction + This is the first blog post about my Algorithms and Data Structures in Go series. I am not a Software Developer in my day job. In my current role, programming and scripting skills are desirable but not mandatory. I have been learning about Data Structures and Algorithms many years ago at University. I thought it would be fun to revisit/refresh my knowledge here and implement many of the algorithms in Go. => ./2023-04-09-algorithms-and-data-structures-in-golang-part-1.gmi 2023-04-09 Algorithms and Data Structures in Go - Part 1 (You are currently reading this) diff --git a/gemfeed/2023-04-09-algorithms-and-data-structures-in-golang-part-1.gmi.tpl b/gemfeed/2023-04-09-algorithms-and-data-structures-in-golang-part-1.gmi.tpl index 5f03693e..8d3807d9 100644 --- a/gemfeed/2023-04-09-algorithms-and-data-structures-in-golang-part-1.gmi.tpl +++ b/gemfeed/2023-04-09-algorithms-and-data-structures-in-golang-part-1.gmi.tpl @@ -16,6 +16,10 @@ | | ``` +<< template::inline::toc + +## Introduction + This is the first blog post about my Algorithms and Data Structures in Go series. I am not a Software Developer in my day job. In my current role, programming and scripting skills are desirable but not mandatory. I have been learning about Data Structures and Algorithms many years ago at University. I thought it would be fun to revisit/refresh my knowledge here and implement many of the algorithms in Go. << template::inline::index algorithms-and-data-structures-in-golang-part diff --git a/gemfeed/2023-05-01-unveiling-guprecords:-uptime-records-with-raku.gmi b/gemfeed/2023-05-01-unveiling-guprecords:-uptime-records-with-raku.gmi index 8ba2d64a..d06a7a7f 100644 --- a/gemfeed/2023-05-01-unveiling-guprecords:-uptime-records-with-raku.gmi +++ b/gemfeed/2023-05-01-unveiling-guprecords:-uptime-records-with-raku.gmi @@ -19,7 +19,15 @@ +-----+-----------------+-----------------------------+ ``` -# Introduction +## Table of Contents + +* ⇢ Unveiling `guprecords.raku`: Global Uptime Records with Raku +* ⇢ ⇢ Introduction +* ⇢ ⇢ How Guprecords works +* ⇢ ⇢ Example +* ⇢ ⇢ Conclusion + +## Introduction For fun, I am tracking the uptime of various personal machines (servers, laptops, workstations...). I have been doing this for over ten years now, so I have a lot of statistics collected. diff --git a/gemfeed/2023-05-01-unveiling-guprecords:-uptime-records-with-raku.gmi.tpl b/gemfeed/2023-05-01-unveiling-guprecords:-uptime-records-with-raku.gmi.tpl index d1edab1d..56e55e41 100644 --- a/gemfeed/2023-05-01-unveiling-guprecords:-uptime-records-with-raku.gmi.tpl +++ b/gemfeed/2023-05-01-unveiling-guprecords:-uptime-records-with-raku.gmi.tpl @@ -19,7 +19,9 @@ +-----+-----------------+-----------------------------+ ``` -# Introduction +<< template::inline::toc + +## Introduction For fun, I am tracking the uptime of various personal machines (servers, laptops, workstations...). I have been doing this for over ten years now, so I have a lot of statistics collected. diff --git a/gemfeed/2023-05-06-the-obstacle-is-the-way-book-notes.gmi b/gemfeed/2023-05-06-the-obstacle-is-the-way-book-notes.gmi index 3626c547..39bcb63d 100644 --- a/gemfeed/2023-05-06-the-obstacle-is-the-way-book-notes.gmi +++ b/gemfeed/2023-05-06-the-obstacle-is-the-way-book-notes.gmi @@ -2,6 +2,25 @@ > Published at 2023-05-06T17:23:16+03:00 +## Table of Contents + +* ⇢ "The Obstacle is the Way" book notes +* ⇢ ⇢ Introduction +* ⇢ ⇢ Reframe your perspective +* ⇢ ⇢ Embrace rationality +* ⇢ ⇢ Control your response +* ⇢ ⇢ Practice emotional and physical resilience +* ⇢ ⇢ Persistence and patience +* ⇢ ⇢ Embrace failure +* ⇢ ⇢ Be adaptable +* ⇢ ⇢ Embrace non-action +* ⇢ ⇢ Leverage crisis +* ⇢ ⇢ Build your inner citadel +* ⇢ ⇢ Love everything that happens +* ⇢ ⇢ Conclusion + +## Introduction + These are my personal takeaways after reading "The Obstacle Is the Way" by Ryan Holiday. This is mainly for my own use, but you might find it helpful too. @@ -27,7 +46,6 @@ We spend a lot of time trying to get things perfect and look at the rules, but w Don't always try to use the front door; a backdoor could open. It's nonsense. Don't fight the judo master with judo. Non-action can be action, exposing the weaknesses of others. - ## Embrace rationality It is a superpower to see things rationally when others are fearful. Focus on the reality of the situation without letting emotions, such as anger, cloud your judgment. This ability will enable you to make better decisions in adversity. Ability to see things what they really are. E.g. wine is old fermented grapes, or other people behaving like animals during a fight. Show the middle finger if someone persists on the stupid rules occasionally. diff --git a/gemfeed/2023-05-06-the-obstacle-is-the-way-book-notes.gmi.tpl b/gemfeed/2023-05-06-the-obstacle-is-the-way-book-notes.gmi.tpl index 92ccc20b..9b33a943 100644 --- a/gemfeed/2023-05-06-the-obstacle-is-the-way-book-notes.gmi.tpl +++ b/gemfeed/2023-05-06-the-obstacle-is-the-way-book-notes.gmi.tpl @@ -2,6 +2,10 @@ > Published at 2023-05-06T17:23:16+03:00 +<< template::inline::toc + +## Introduction + These are my personal takeaways after reading "The Obstacle Is the Way" by Ryan Holiday. This is mainly for my own use, but you might find it helpful too. @@ -27,7 +31,6 @@ We spend a lot of time trying to get things perfect and look at the rules, but w Don't always try to use the front door; a backdoor could open. It's nonsense. Don't fight the judo master with judo. Non-action can be action, exposing the weaknesses of others. - ## Embrace rationality It is a superpower to see things rationally when others are fearful. Focus on the reality of the situation without letting emotions, such as anger, cloud your judgment. This ability will enable you to make better decisions in adversity. Ability to see things what they really are. E.g. wine is old fermented grapes, or other people behaving like animals during a fight. Show the middle finger if someone persists on the stupid rules occasionally. diff --git a/gemfeed/2023-06-01-kiss-server-monitoring-with-gogios.gmi b/gemfeed/2023-06-01-kiss-server-monitoring-with-gogios.gmi index cec0f470..3e0aadf4 100644 --- a/gemfeed/2023-06-01-kiss-server-monitoring-with-gogios.gmi +++ b/gemfeed/2023-06-01-kiss-server-monitoring-with-gogios.gmi @@ -4,6 +4,24 @@ => ./kiss-server-monitoring-with-gogios/gogios-small.png Gogios logo +## Table of Contents + +* ⇢ KISS server monitoring with Gogios +* ⇢ ⇢ Introduction +* ⇢ ⇢ Motivation +* ⇢ ⇢ Features +* ⇢ ⇢ Example alert +* ⇢ ⇢ Installation +* ⇢ ⇢ ⇢ Compiling and installing Gogios +* ⇢ ⇢ ⇢ Setting up user, group and directories +* ⇢ ⇢ ⇢ Installing monitoring plugins +* ⇢ ⇢ Configuration +* ⇢ ⇢ ⇢ MTA +* ⇢ ⇢ ⇢ Configuring Gogios +* ⇢ ⇢ Running Gogios +* ⇢ ⇢ ⇢ High-availability +* ⇢ ⇢ Conclusion: + ## Introduction Gogios is a minimalistic and easy-to-use monitoring tool I programmed in Google Go designed specifically for small-scale self-hosted servers and virtual machines. The primary purpose of Gogios is to monitor my personal server infrastructure for `foo.zone`, my MTAs, my authoritative DNS servers, my NextCloud, Wallabag and Anki sync server installations, etc. diff --git a/gemfeed/2023-06-01-kiss-server-monitoring-with-gogios.gmi.tpl b/gemfeed/2023-06-01-kiss-server-monitoring-with-gogios.gmi.tpl index ec42c787..2232ddb4 100644 --- a/gemfeed/2023-06-01-kiss-server-monitoring-with-gogios.gmi.tpl +++ b/gemfeed/2023-06-01-kiss-server-monitoring-with-gogios.gmi.tpl @@ -4,6 +4,8 @@ => ./kiss-server-monitoring-with-gogios/gogios-small.png Gogios logo +<< template::inline::toc + ## Introduction Gogios is a minimalistic and easy-to-use monitoring tool I programmed in Google Go designed specifically for small-scale self-hosted servers and virtual machines. The primary purpose of Gogios is to monitor my personal server infrastructure for `foo.zone`, my MTAs, my authoritative DNS servers, my NextCloud, Wallabag and Anki sync server installations, etc. diff --git a/gemfeed/2023-07-17-career-guide-and-soft-skills-book-notes.gmi b/gemfeed/2023-07-17-career-guide-and-soft-skills-book-notes.gmi index ac5fcbb4..3608ff78 100644 --- a/gemfeed/2023-07-17-career-guide-and-soft-skills-book-notes.gmi +++ b/gemfeed/2023-07-17-career-guide-and-soft-skills-book-notes.gmi @@ -2,6 +2,41 @@ > Published at 2023-07-17T04:56:20+03:00 +## Table of Contents + +* ⇢ "Software Developmers Career Guide and Soft Skills" book notes +* ⇢ Introduction +* ⇢ Improve +* ⇢ ⇢ Always learn new things +* ⇢ ⇢ Set goals +* ⇢ ⇢ Ratings +* ⇢ ⇢ Promotions +* ⇢ ⇢ Finish things +* ⇢ ⇢ Expand the empire +* ⇢ ⇢ Be pragmatic and also manage your time +* ⇢ ⇢ ⇢ The quota system +* ⇢ ⇢ ⇢ Don't waste time +* ⇢ ⇢ ⇢ Habits +* ⇢ Work-life balance +* ⇢ ⇢ Mental health +* ⇢ ⇢ Physical health +* ⇢ ⇢ No drama +* ⇢ Personal brand +* ⇢ ⇢ Market yourself +* ⇢ ⇢ Networking +* ⇢ ⇢ Public speaking +* ⇢ New job +* ⇢ ⇢ For the interview +* ⇢ ⇢ Find the right type of company +* ⇢ ⇢ Apply for the new job +* ⇢ ⇢ Negotiation +* ⇢ ⇢ Leaving the old job +* ⇢ Other things +* ⇢ ⇢ Testing +* ⇢ ⇢ Books to read + +# Introduction + These notes are of two books by "John Sommez" I found helpful. I also added some of my own keypoints to it. These notes are mainly for my own use, but you might find them helpful, too. ``` diff --git a/gemfeed/2023-07-17-career-guide-and-soft-skills-book-notes.gmi.tpl b/gemfeed/2023-07-17-career-guide-and-soft-skills-book-notes.gmi.tpl index 0fdeac5a..92b75aae 100644 --- a/gemfeed/2023-07-17-career-guide-and-soft-skills-book-notes.gmi.tpl +++ b/gemfeed/2023-07-17-career-guide-and-soft-skills-book-notes.gmi.tpl @@ -2,6 +2,10 @@ > Published at 2023-07-17T04:56:20+03:00 +<< template::inline::toc + +# Introduction + These notes are of two books by "John Sommez" I found helpful. I also added some of my own keypoints to it. These notes are mainly for my own use, but you might find them helpful, too. ``` diff --git a/gemfeed/2023-07-21-gemtexter-2.1.0-lets-gemtext-again-3.gmi b/gemfeed/2023-07-21-gemtexter-2.1.0-lets-gemtext-again-3.gmi index e9b3590c..4782b3f2 100644 --- a/gemfeed/2023-07-21-gemtexter-2.1.0-lets-gemtext-again-3.gmi +++ b/gemfeed/2023-07-21-gemtexter-2.1.0-lets-gemtext-again-3.gmi @@ -15,6 +15,20 @@ mod. by Paul Buetow `"""""""""` ``` +## Table of Contents + +* ⇢ Gemtexter 2.1.0 - Let's Gemtext again³ +* ⇢ ⇢ Introduction +* ⇢ ⇢ Why Bash? +* ⇢ ⇢ Switch to GPL3 license +* ⇢ ⇢ Source code highlighting support +* ⇢ ⇢ HTML exact variant +* ⇢ ⇢ Use of Hack webfont by default +* ⇢ ⇢ HTML Mastodon verification support +* ⇢ ⇢ More + +## Introduction + I proudly announce that I've released Gemtexter version `2.1.0`. What is Gemtexter? It's my minimalist static site generator for Gemini Gemtext, HTML and Markdown, written in GNU Bash. => https://codeberg.org/snonux/gemtexter diff --git a/gemfeed/2023-07-21-gemtexter-2.1.0-lets-gemtext-again-3.gmi.tpl b/gemfeed/2023-07-21-gemtexter-2.1.0-lets-gemtext-again-3.gmi.tpl index 95e5ea54..20c57265 100644 --- a/gemfeed/2023-07-21-gemtexter-2.1.0-lets-gemtext-again-3.gmi.tpl +++ b/gemfeed/2023-07-21-gemtexter-2.1.0-lets-gemtext-again-3.gmi.tpl @@ -15,6 +15,10 @@ mod. by Paul Buetow `"""""""""` ``` +<< template::inline::toc + +## Introduction + I proudly announce that I've released Gemtexter version `2.1.0`. What is Gemtexter? It's my minimalist static site generator for Gemini Gemtext, HTML and Markdown, written in GNU Bash. => https://codeberg.org/snonux/gemtexter diff --git a/gemfeed/2023-09-25-dtail-usage-examples.gmi b/gemfeed/2023-09-25-dtail-usage-examples.gmi index 1bc4cd86..a3f5301a 100644 --- a/gemfeed/2023-09-25-dtail-usage-examples.gmi +++ b/gemfeed/2023-09-25-dtail-usage-examples.gmi @@ -2,6 +2,22 @@ > Published at 2023-09-25T14:57:42+03:00 +## Table of Contents + +* ⇢ DTail usage examples +* ⇢ ⇢ Introduction +* ⇢ ⇢ Following logs +* ⇢ ⇢ Aggregating logs +* ⇢ ⇢ How to use `dcat` +* ⇢ ⇢ How to use `dgrep` +* ⇢ ⇢ How to use `dmap` +* ⇢ ⇢ How to use the DTail serverless mode +* ⇢ ⇢ ⇢ Serverless map-reduce query +* ⇢ ⇢ ⇢ Aggregating CSV files +* ⇢ ⇢ ⇢ Other serverless commands + +## Introduction + Hey there. As I am pretty busy this month personally (I am now on Paternity Leave) and as I still want to post once monthly, the blog post of this month will only be some DTail usage examples. They're from the DTail documentation, but not all readers of my blog may be aware of those! DTail is a distributed DevOps tool for tailing, grepping, catting logs and other text files on many remote machines at once which I programmed in Go. diff --git a/gemfeed/2023-09-25-dtail-usage-examples.gmi.tpl b/gemfeed/2023-09-25-dtail-usage-examples.gmi.tpl index 8c41c1f7..54a239ae 100644 --- a/gemfeed/2023-09-25-dtail-usage-examples.gmi.tpl +++ b/gemfeed/2023-09-25-dtail-usage-examples.gmi.tpl @@ -2,6 +2,10 @@ > Published at 2023-09-25T14:57:42+03:00 +<< template::inline::toc + +## Introduction + Hey there. As I am pretty busy this month personally (I am now on Paternity Leave) and as I still want to post once monthly, the blog post of this month will only be some DTail usage examples. They're from the DTail documentation, but not all readers of my blog may be aware of those! DTail is a distributed DevOps tool for tailing, grepping, catting logs and other text files on many remote machines at once which I programmed in Go. diff --git a/gemfeed/2023-10-29-kiss-static-web-photo-albums-with-photoalbum.sh.gmi b/gemfeed/2023-10-29-kiss-static-web-photo-albums-with-photoalbum.sh.gmi index a8c48449..9a43d300 100644 --- a/gemfeed/2023-10-29-kiss-static-web-photo-albums-with-photoalbum.sh.gmi +++ b/gemfeed/2023-10-29