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,67 @@
+SBLG = sblg
+PREFIX = $(HOME)/profanity
+BLOG_POST_SRC_DIR = blogsource/content/post
+BLOG_POST_OUT_DIR = blog
+BLOG_POSTS = $(wildcard $(BLOG_POST_SRC_DIR)/*.md)
+BLOG_POSTS_OUT = $(subst $(BLOG_POST_SRC_DIR), $(BLOG_POST_OUT_DIR),  $(BLOG_POSTS:.md=.html))
+CONTRIBUTORS_SRC_DIR = blogsource/content/contributors
+CONTRIBUTORS_OUT_DIR = contributors
+CONTRIBUTORS = $(wildcard $(CONTRIBUTORS_SRC_DIR)/*.md)
+PAGES_SRC_DIR = pagesource
+PAGES = $(wildcard $(PAGE_SRC_DIR)/*.xml)
+PAGES_OUT = $(subst $(PAGES_SRC_DIR),, $(PAGES:.xml=.html))
+REDIRECTS_DIR = pageredirects
+REDIRECTS_SRC = $(wildcard $(REDIRECTS_DIR)/*.html)
+REDIRECTS = $(subst $(REDIRECTS_DIR)/,,$(REDIRECTS_SRC))
+
+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 $(REDIRECTS)
+
+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 $(REDIRECTS)
+	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 $(addprefix $PAGES_SRC_DIR)/,($(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): $(CONTRIBUTORS)
+	$(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
+
+$(REDIRECTS): $(REDIRECTS_SRC)
+	cp --preserve=mode,ownership,timestamps $(addprefix $(REDIRECTS_DIR)/,$@) .
+
+clean:
+	$(MAKE) -C $(BLOG_POST_SRC_DIR) clean
+	$(MAKE) -C $(CONTRIBUTORS_SRC_DIR) clean
+	rm -f index.html $(PAGES_OUT) themegallery.html $(REDIRECTS)
+	rm -r $(BLOG_POSTS_XML) $(BLOG_POSTS_OUT) $(BLOG_POST_OUT_DIR)
+	rm -r $(CONTRIBUTORS_XML) $(CONTRIBUTORS_OUT) $(CONTRIBUTORS_OUT_DIR)

README.md

@@ -1,7 +1,30 @@
 Sources for https://profanity-im.github.io
 
 Most site are edited by hand.
-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).
+Top level pages are generated from xml sources using [sblg](https://kristaps.bsd.lv/sblg/).
+The source file for the landing page is index.xml which contains html for everything other
+than the header and footer.  The source files for other top level pages are in the folder
+`pagesource`. These are xml files which contain html content for everything other than the
+header and footer. Edit them by hand.
+
+Blog entry sources are in the directory `blogsource/content/post`. These are markdown
+files which are processed by [lowdown](https://kristaps.bsd.lv/lowdown). To create a new
+blog entry enter the directory `blogsource`. Run `blog-post.sh` to create a blog post
+starter file. Edit the starter file created in `blogsource/content/post/` to add the
+content for the blog post. If you do not have a contributor profile, please create one in
+`blogsource/content/contributors`. See one of the existing contributor profiles for the
+formatting. Optionally add an image in jpeg format with name `username.jpg` to be used with
+your profile in `blogsource/content/contributors/img`.
+
+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.
+
+GitHubActions will build and deploy the website for updates to blog entries and to changes in
+the top level pages.
+
+To build the site locally, type `make` in the top level directory.  You will need to have
+[sblg](https://kristaps.bsd.lv/sblg/) and [lowdown](https://kristaps/bsd.lv/lowdown) installed
+on your system.

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>