From 0577a56127a42e7551695e20b1d2b9e59b1fa5ed Mon Sep 17 00:00:00 2001
From: veclav talica <veclavtalica@protonmal.com>
Date: Sun, 31 Mar 2024 10:38:30 +0500
Subject: [PATCH] configurability

---
 config.py                      | 32 ++++++++++++++++
 tools/article_wrapper.py       |  3 +-
 tools/config.py                |  1 +
 tools/date_descriptions.py     | 24 ++++++++++++
 tools/feed_generator.py        |  9 +++--
 tools/main_page_generator.py   | 13 ++++---
 tools/page_builder.py          | 43 ++++++++++++++++++++++
 tools/page_shares.py           | 67 ----------------------------------
 tools/rfc822.py                |  2 +-
 tools/tag_listing_generator.py |  3 +-
 10 files changed, 118 insertions(+), 79 deletions(-)
 create mode 100644 config.py
 create mode 120000 tools/config.py
 create mode 100644 tools/date_descriptions.py
 create mode 100644 tools/page_builder.py
 delete mode 100644 tools/page_shares.py

diff --git a/config.py b/config.py
new file mode 100644
index 0000000..0803c89
--- /dev/null
+++ b/config.py
@@ -0,0 +1,32 @@
+from random import choice
+
+## Title of the blog
+## Used for default first navbar entry to "/" root.
+## 
+title = "mjestečko"
+
+## Shows on top of every page providing navigation.
+## Every entry forms a <li><a> child element of <nav>,
+## where each dictionary pair forms an attached xml property.
+## 
+navbar = [
+    ("source", { "href": "https://git.poto.cafe/veclavtalica/mjestecko" }),
+    ("rss", { "href": "/feed.xml" }),
+    ("about", { "href": "/articles/mjestečko.html" }),
+    ("tracks", { "href":  "https://modarchive.org/index.php?request=view_artist_modules&query=96070" }),
+    ("mastodon", { "href":  "https://poto.cafe/@veclavtalica", "rel": "me" }),
+]
+
+## Optional description that will be shown on top of the main page.
+## Could be plain text or callable with no parameters.
+## 
+description = lambda: f"Personal blog of one {choice(adjectives)} Veclav Talica."
+adjectives = ["*wild*", "**wacky**", "very humble", "**most serious**"]
+
+## Optional link to logo image that will appear on top of the main page.
+##
+logo = "/logo.png"
+
+## Language specifier, used in RSS feed.
+##
+language = "en"
diff --git a/tools/article_wrapper.py b/tools/article_wrapper.py
index 53e5af9..15355c8 100755
--- a/tools/article_wrapper.py
+++ b/tools/article_wrapper.py
@@ -7,7 +7,8 @@ import time, urllib.parse, re
 import os.path as path
 
 from article_utils import the_line_after_metadata, parse_metadata
-from page_shares import wrap_page, MONTHS
+from page_builder import wrap_page
+from date_descriptions import MONTHS
 
 if len(argv) <= 1:
     print("No file was supplied")
diff --git a/tools/config.py b/tools/config.py
new file mode 120000
index 0000000..3721332
--- /dev/null
+++ b/tools/config.py
@@ -0,0 +1 @@
+../config.py
\ No newline at end of file
diff --git a/tools/date_descriptions.py b/tools/date_descriptions.py
new file mode 100644
index 0000000..4f2babc
--- /dev/null
+++ b/tools/date_descriptions.py
@@ -0,0 +1,24 @@
+MONTHS = {
+    1: "January",
+    2: "February",
+    3: "March",
+    4: "April",
+    5: "May",
+    6: "June",
+    7: "July",
+    8: "August",
+    9: "September",
+    10: "October",
+    11: "November",
+    12: "December"
+}
+
+WEEKDAYS = {
+    0: "Monday",
+    1: "Tuesday",
+    2: "Wednesday",
+    3: "Thursday",
+    4: "Friday",
+    5: "Saturday",
+    6: "Sunday"
+}
diff --git a/tools/feed_generator.py b/tools/feed_generator.py
index a66a3d5..d30d96a 100755
--- a/tools/feed_generator.py
+++ b/tools/feed_generator.py
@@ -7,9 +7,10 @@ from textwrap import indent
 import time, urllib.parse, re, subprocess
 
 from article_utils import parse_metadata
-from page_shares import ADJECTIVES
 from rfc822 import stringify_date
 
+import config
+
 if len(argv) <= 1:
     print("No directory was supplied")
     exit(-1)
@@ -25,10 +26,10 @@ address = argv[2]
 # todo: Find the latest pubDate
 feed = f"""<rss version="2.0">
     <channel>
-        <title>mjestečko</title>
+        <title>{config.title}</title>
         <link>{address}</link>
-        <description>Personal blog of one {choice(ADJECTIVES)} Veclav Talica</description>
-        <language>en</language>
+        <description>{config.description() if callable(config.description) else config.description}</description>
+        <language>{config.language}</language>
         <lastBuildDate>{stringify_date(time.gmtime(int(time.time())))}</lastBuildDate>
 """
 
diff --git a/tools/main_page_generator.py b/tools/main_page_generator.py
index e165dc2..a535923 100755
--- a/tools/main_page_generator.py
+++ b/tools/main_page_generator.py
@@ -1,11 +1,14 @@
 #!/usr/bin/python3
 
 from sys import argv, exit
-from random import choice, seed
+from random import seed
 import time
 
 from article_utils import parse_article_directory, sort_titles_by_date
-from page_shares import wrap_page, ADJECTIVES, MONTHS
+from page_builder import wrap_page
+from date_descriptions import MONTHS
+
+import config
 
 if len(argv) <= 1:
     print("No directory was supplied")
@@ -13,15 +16,15 @@ if len(argv) <= 1:
 
 seed()
 
-page_metadata = """Title:  mjestečko
+page_metadata = f"""Title:  {config.title}
 CSS:    /style.css
 HTML header:    <meta name="viewport" content="width=device-width, initial-scale=1">
 
 """
 
-page = f"""![](/logo.png)
+page = f"""![]({config.logo})
 
-Personal blog of one {choice(ADJECTIVES)} Veclav Talica.
+{config.description() if callable(config.description) else config.description}
 
 ### Articles ###
 
diff --git a/tools/page_builder.py b/tools/page_builder.py
new file mode 100644
index 0000000..c55e3b9
--- /dev/null
+++ b/tools/page_builder.py
@@ -0,0 +1,43 @@
+import config
+
+_navbar = config.navbar.copy()
+_navbar.insert(0, ('<strong>' + config.title + '</strong>', {"href": "/"}))
+_navbar.append(("tags", {"href": "/tags.html"}))
+
+_navbar_lis = '\n'.join(f"""<li><a {' '.join(
+        f'{p}="{v}"' for p, v in e[1].items())}>{e[0]}</a></li>"""
+    for e in _navbar)
+
+_head = f"""
+
+<div class="container">
+<nav class="custom-nav">
+<ul>
+{_navbar_lis}
+</ul>
+</nav>
+
+"""
+
+_footer = """
+<footer>
+<a href="#top">^ Return</a>
+</footer>
+
+"""
+
+_tail = """
+
+</div>
+
+"""
+
+def mixin_tag(content: str, tag: str) -> str:
+    return f"""<{tag}>
+
+{content}</{tag}>
+
+"""
+
+def wrap_page(page: str) -> str:
+    return _head + mixin_tag(page, "main") + _footer + _tail
diff --git a/tools/page_shares.py b/tools/page_shares.py
deleted file mode 100644
index 89dab31..0000000
--- a/tools/page_shares.py
+++ /dev/null
@@ -1,67 +0,0 @@
-
-HEAD_EMBED = """
-
-<div class="container">
-<nav class="custom-nav">
-<ul>
-<li><a href="/"><strong>mjestečko</strong></a></li>
-<li><a href="https://git.poto.cafe/veclavtalica/mjestecko">source</a></li>
-<li><a href="/feed.xml">rss</a></li>
-<li><a href="/articles/mjestečko.html">about</a></li>
-<li><a href="https://modarchive.org/index.php?request=view_artist_modules&query=96070">tracks</a></li>
-<li><a rel="me" href="https://poto.cafe/@veclavtalica">mastodon</a></li>
-<li><a href="/tags.html">tags</a></li>
-</ul>
-</nav>
-
-"""
-
-NOTICE = """
-<footer>
-<a href="#top">^ Return</a>
-</footer>
-
-"""
-
-TAIL_EMBED = """
-
-</div>
-
-"""
-
-ADJECTIVES = ["*wild*", "**wacky**", "very humble", "**most serious**"]
-
-MONTHS = {
-    1: "January",
-    2: "February",
-    3: "March",
-    4: "April",
-    5: "May",
-    6: "June",
-    7: "July",
-    8: "August",
-    9: "September",
-    10: "October",
-    11: "November",
-    12: "December"
-}
-
-WEEKDAYS = {
-    0: "Monday",
-    1: "Tuesday",
-    2: "Wednesday",
-    3: "Thursday",
-    4: "Friday",
-    5: "Saturday",
-    6: "Sunday"
-}
-
-def mixin_tag(content: str, tag: str) -> str:
-    return f"""<{tag}>
-
-{content}</{tag}>
-
-"""
-
-def wrap_page(page: str) -> str:
-    return HEAD_EMBED + mixin_tag(page, "main") + NOTICE + TAIL_EMBED
diff --git a/tools/rfc822.py b/tools/rfc822.py
index 5636ff1..c7e80d1 100644
--- a/tools/rfc822.py
+++ b/tools/rfc822.py
@@ -1,4 +1,4 @@
-from page_shares import MONTHS, WEEKDAYS
+from date_descriptions import MONTHS, WEEKDAYS
 
 def stringify_date(date) -> str:
     return f"{WEEKDAYS[date.tm_wday][:3]}, {date.tm_mday} {MONTHS[date.tm_mon][:3]} {date.tm_year} {date.tm_hour:02d}:{date.tm_min:02d}:{date.tm_sec:02d} GMT"
diff --git a/tools/tag_listing_generator.py b/tools/tag_listing_generator.py
index b293261..bfe31bc 100755
--- a/tools/tag_listing_generator.py
+++ b/tools/tag_listing_generator.py
@@ -8,8 +8,9 @@ from os import walk
 import os.path as path
 
 from article_utils import the_line_after_metadata, parse_metadata
-from page_shares import wrap_page
+from page_builder import wrap_page
 
+# todo: Reuse
 tag_listing_header = """CSS:    /style.css
 HTML header:    <meta name="viewport" content="width=device-width, initial-scale=1">