Update content for gemtext

1 files changed, 86 insertions, 0 deletions

diff --git a/gemfeed/2024-10-02-gemtexter-3.0.0-lets-gemtext-again-4.gmi b/gemfeed/2024-10-02-gemtexter-3.0.0-lets-gemtext-again-4.gmi
new file mode 100644
index 00000000..c0a4c633
--- /dev/null
+++ b/gemfeed/2024-10-02-gemtexter-3.0.0-lets-gemtext-again-4.gmi
@@ -0,0 +1,86 @@
+# Gemtexter 3.0.0 - Let's Gemtext again⁴
+
+> Published at 2024-10-01T21:46:26+03:00
+
+I proudly announce that I've released Gemtexter version `3.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
+
+```
+-=[ typewriters ]=-  1/98
+                                      .-------.
+       .-------.                     _|~~ ~~  |_
+      _|~~ ~~  |_       .-------.  =(_|_______|_)
+    =(_|_______|_)=    _|~~ ~~  |_   |:::::::::|    .-------.
+      |:::::::::|    =(_|_______|_)  |:::::::[]|   _|~~ ~~  |_
+      |:::::::[]|      |:::::::::|   |o=======.| =(_|_______|_)
+      |o=======.|      |:::::::[]|   `"""""""""`   |:::::::::|
+ jgs  `"""""""""`      |o=======.|                 |:::::::[]|
+  mod. by Paul Buetow  `"""""""""`                 |o=======.|
+                                                   `"""""""""`
+```
+
+## Table of Contents
+
+* ⇢ Gemtexter 3.0.0 - Let's Gemtext again⁴
+* ⇢ ⇢ Why Bash?
+* ⇢ ⇢ HTML exact variant is the only variant
+* ⇢ ⇢ Table of Contents auto-generation
+* ⇢ ⇢ Configurable themes
+* ⇢ ⇢ No use of webfonts by default
+* ⇢ ⇢ More
+
+## Why Bash?
+
+This project is too complex for a Bash script. Writing it in Bash was to try out how maintainable a "larger" Bash script could be. It's still pretty maintainable and helps me try new Bash tricks here and then!
+
+Let's list what's new!
+
+## HTML exact variant is the only variant
+
+The last version of Gemtexter introduced the HTML exact variant, which wasn't enabled by default. This version of Gemtexter removes the previous (inexact) variant and makes the exact variant the default. This is a breaking change, which is why there is a major version bump of Gemtexter. Here is a reminder of what the exact variant was:
+
+> Gemtexter is there to convert your Gemini Capsule into other formats, such as HTML and Markdown. An HTML exact variant can now be enabled in the `gemtexter.conf` by adding the line `declare -rx HTML_VARIANT=exact`. The HTML/CSS output changed to reflect a more exact Gemtext appearance and to respect the same spacing as you would see in the Geminispace. 
+
+## Table of Contents auto-generation
+
+Just add...
+
+```
+ << template::inline::toc
+```
+
+...into a Gemtexter template file and Gemtexter will automatically generate a table of contents for the page based on the headings (see this page's ToC for example). The ToC will also have links to the relevant sections in HTML and Markdown output. The Gemtext format does not support links, so the ToC will simply be displayed as a bullet list. 
+
+## Configurable themes
+
+It was always possible to customize the style of a Gemtexter's resulting HTML page, but all the config options were scattered across multiple files. Now, the CSS style, web fonts, etc., are all configurable via themes.
+
+Simply configure `HTML_THEME_DIR` in the `gemtexter.conf` file to the corresponding directory. For example:
+
+```bash
+declare -xr HTML_THEME_DIR=./extras/html/themes/simple
+```
+
+To customize the theme or create your own, simply copy the theme directory and modify it as needed. This makes it also much easier to switch between layouts.
+
+## No use of webfonts by default
+
+The default theme is now "back to the basics" and does not utilize any web fonts. The previous themes are still part of the release and can be easily configured. These are currently the `future` and `business` themes. You can check them out from the themes directory.
+
+## More
+
+Additionally, there were a couple of bug fixes, refactorings and overall improvements in the documentation made. 
+
+E-Mail your comments to `paul@nospam.buetow.org` :-)
+
+Other related posts are:
+
+=> ./2021-04-24-welcome-to-the-geminispace.gmi 2021-04-24 Welcome to the Geminispace
+=> ./2021-06-05-gemtexter-one-bash-script-to-rule-it-all.gmi 2021-06-05 Gemtexter - One Bash script to rule it all
+=> ./2022-08-27-gemtexter-1.1.0-lets-gemtext-again.gmi 2022-08-27 Gemtexter 1.1.0 - Let's Gemtext again
+=> ./2023-03-25-gemtexter-2.0.0-lets-gemtext-again-2.gmi 2023-03-25 Gemtexter 2.0.0 - Let's Gemtext again²
+=> ./2023-07-21-gemtexter-2.1.0-lets-gemtext-again-3.gmi 2023-07-21 Gemtexter 2.1.0 - Let's Gemtext again³
+=> ./2024-10-02-gemtexter-3.0.0-lets-gemtext-again-4.gmi 2024-10-02 Gemtexter 3.0.0 - Let's Gemtext again⁴ (You are currently reading this)
+
+=> ../ Back to the main site