Generate top level files with static site generator

.github/workflows/deploy.yml

@@ -0,0 +1,42 @@
+name: Build and Deploy Site
+on: push
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    container:
+      image: fedora:latest
+
+    steps:
+    - uses: actions/checkout@v6
+    - run: cat /etc/os-release
+    - name: install dependencies
+      run: |
+       sudo dnf -y update
+       sudo dnf install -y lowdown make sblg
+    - name: build site
+      run: make
+    - name: package site
+      run: |
+       mkdir site
+       make install PREFIX=$(pwd)/site
+    - name: Upload artifact
+      uses: actions/upload-pages-artifact@v4
+      with:
+       path: site
+
+  deploy:
+    needs: build
+
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,3 +1,5 @@
 images/.DS_Store
 .DS_Store
 node_modules
+blog_sources/public/
+blog_sources/themes/

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "blog_source"]
+	path = blog_source
+	url = https://github.com/profanity-im/blog

Makefile

@@ -0,0 +1,68 @@
+SBLG = sblg
+PREFIX = $(HOME)/profanity
+BLOG_POST_SRC_DIR = blogsource/content/post
+BLOG_POST_OUT_DIR = blog
+BLOG_POSTS = $(wildcard blogsource/content/post/*.md)
+CONTRIBUTORS = $(wildcard blogsource/content/contributors/*.md)
+CONTRIBUTORS_SRC_DIR = blogsource/content/contributors
+CONTRIBUTORS_OUT_DIR = contributors
+PAGES = accounts.xml \
+        donate.xml \
+        faq.xml \
+        helpout.xml \
+        issues.xml \
+        plugins.xml \
+        userguide.xml \
+        xeps.xml
+
+PAGES_OUT = $(PAGES:.xml=.html)
+BLOG_POSTS_OUT = $(subst $(BLOG_POST_SRC_DIR), $(BLOG_POST_OUT_DIR),  $(BLOG_POSTS:.md=.html))
+
+all: index.html $(PAGES_OUT) themegallery.html $(BLOG_POSTS_OUT) $(BLOG_POST_OUT_DIR)/atom.xml \
+     $(BLOG_POST_OUT_DIR)/index.html $(CONTRIBUTORS_OUT) $(CONTRIBUTORS_OUT_DIR)/index.html
+
+install:  index.html $(PAGES_OUT) themegallery.html $(BLOG_POSTS_OUT) $(BLOG_POST_OUT_DIR)/atom.xml \
+	$(BLOG_POST_OUT_DIR)/index.html $(CONTRIBUTORS_OUT) $(CONTRIBUTORS_OUT_DIR)/index.html
+	mkdir -p $(PREFIX)
+	install -m0444 *.html $(PREFIX)
+	install -m0444 -p -D -t $(PREFIX)/blog blog/*.html
+	install -m0444 -p -D -t $(PREFIX)/blog/img blog/img/*.png
+	install -m0444 -p -D -t $(PREFIX)/contributors contributors/*.html
+	install -m0444 -p -D -t $(PREFIX)/contributors/img contributors/img/*jpg
+	cp -p -r css $(PREFIX)
+	cp -p -r guide $(PREFIX)
+	cp -p -r images $(PREFIX)
+	cp -p -r js $(PREFIX)
+	cp -p -r plugins $(PREFIX)
+	cp -p -r tarballs $(PREFIX)
+
+index.html: landing-template.xml
+	$(SBLG) -o $@ -t landing-template.xml -c index.xml
+
+$(PAGES_OUT): manual-template.xml
+	$(SBLG) -o $@ -t manual-template.xml -c $(subst .html,.xml,$@)
+
+themegallery.html: gallery-template.xml
+	$(SBLG) -o $@ -t gallery-template.xml -c themegallery.xml
+
+$(BLOG_POST_OUT_DIR)/atom.xml $(BLOG_POST_OUT_DIR)/index.html $(BLOG_POSTS_OUT): $(BLOG_POSTS)
+	$(MAKE) -C $(BLOG_POST_SRC_DIR)
+	mkdir $(BLOG_POST_OUT_DIR)
+	mv $(BLOG_POST_SRC_DIR)/*.html $(BLOG_POST_OUT_DIR)/
+	mv $(BLOG_POST_SRC_DIR)/atom.xml $(BLOG_POST_OUT_DIR)/
+	cp --preserve=mode,ownership,timestamps --recursive $(BLOG_POST_SRC_DIR)/img $(BLOG_POST_OUT_DIR)/
+	$(MAKE) -C $(BLOG_POST_SRC_DIR) clean
+
+$(CONTRIBUTORS_OUT_DIR)/index.html $(CONTRIBUTORS_OUT): $(CONTRIBUTORSS)
+	$(MAKE) -C $(CONTRIBUTORS_SRC_DIR)
+	mkdir $(CONTRIBUTORS_OUT_DIR)
+	mv $(CONTRIBUTORS_SRC_DIR)/*.html $(CONTRIBUTORS_OUT_DIR)/
+	cp --preserve=mode,ownership,timestamps --recursive $(CONTRIBUTORS_SRC_DIR)/img $(CONTRIBUTORS_OUT_DIR)/
+	$(MAKE) -C $(CONTRIBUTORS_SRC_DIR) clean
+
+clean:
+	$(MAKE) -C $(BLOG_POST_SRC_DIR) clean
+	$(MAKE) -C $(CONTRIBUTORS_SRC_DIR) clean
+	rm -f index.html $(PAGES_OUT) themegallery.html
+	rm -r $(BLOG_POSTS_XML) $(BLOG_POSTS_OUT) $(BLOG_POST_OUT_DIR) $(BLOG_POST_OUT_DIR)
+	rm -r $(CONTRIBUTORS_XML) $(CONTRIBUTORS_OUT) $(CONTRIBUTORS_OUT_DIR)

README.md

@@ -1,7 +1,8 @@
 Sources for https://profanity-im.github.io
 
 Most site are edited by hand.
+Top level pages are generated from xml sources using [sblg](https://kristaps.bsd.lv/sblg/),
+type `make` after updating the xml files.
 Command references (main_fragment.html, toc_fragment.html),  and apidocs are generated via `profanity docgen`.
 See the [release guide](https://github.com/profanity-im/profanity/blob/master/RELEASE_GUIDE.md) for details.
 
-Blog sources are at [https://github.com/profanity-im/blog](https://github.com/profanity-im/blog).

accounts.html → accounts.xml

@@ -1,32 +1,14 @@
-<!DOCTYPE html>
-<html>
-
-<head>
-    <title>Profanity, a console based XMPP client - Account Configuration</title>
-    <meta charset="utf-8">
-    <meta http-equiv="Expires" content="-1">
-    <meta http-equiv="Pragma" content="no-cache">
-    <meta http-equiv="Cache-Control" content="no-cache">
-    <link href="css/profanity.css" type="text/css" rel="stylesheet">
-
-</head>
-
-<body id="article">
-    <img class="overlay" src="images/profanity_mouth-only.png" alt="Profanity Illustration">
-    <header>
-        <h1>
-            <a href="index.html">
-            Profani<span class="kern-ty">ty</span>
-            </a>
-        </h1>
-        <h2>Account Configuration</h2>
-    </header>
-    <article id="manual">
+<?xml version="1.0" encoding="utf-8"?>
+
+<article id="manual"
+         data-sblg-article="1"
+         data-sblg-set-title="Profanity, a console based XMPP client - Account Configuration"
+         data-sblg-set-subtitle="Account Configuration">
         <section>
             <h3>Contents</h3>
 
             <ul>
-                <li><a href="#configuring-accounts">Configuring Accounts</a>
+                <li><a href="#configuring-accounts">Configuring Accounts</a></li>
             </ul>
         </section>
         <section>
@@ -66,10 +48,4 @@ <h3>Configuring Accounts</h3>
 muc.nick=smithy
 </code></pre>
         </section>
-    </article>
-    <footer>
-        <p class="matty">site designed by <a href="http://www.matthewbalaam.co.uk">Matthew Balaam</a></p>
-    </footer>
-</body>
-
-</html>
+</article>

atom-template.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+	<title>Feed</title>
+	<link href="https://profanity-im.github.io/blog/" />
+	<link href="https://profanity-im.github.io/blog/atom.xml" rel="self" />
+	<id />
+	<updated />
+	<entry data-sblg-forall="1" data-sblg-entry="1" data-sblg-altlink="1"
+	 data-sblg-altlink-fmt="https://profanity-im.github.io/blog/${sblg-base}.html" />
+</feed>