Merge pull request #158 from bkmgit/doap4

Use doap to generate list of supported XEPs

Author: jubalh

.github/workflows/deploy.yml

@@ -12,12 +12,14 @@ jobs:
       image: opensuse/tumbleweed:latest
 
     steps:
-    - uses: actions/checkout@v6
     - name: install dependencies
       run: |
        zypper refresh
        zypper --non-interactive update
-       zypper --non-interactive install git lowdown make sblg nodejs npm
+       zypper --non-interactive install git libxslt lowdown make sblg nodejs npm
+    - uses: actions/checkout@v6
+      with:
+        submodules: recursive
     - name: build css
       run: |
        npm install

.gitmodules

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

Makefile

@@ -1,4 +1,5 @@
 SBLG = sblg
+XSLTPROC = xsltproc
 PREFIX = $(PWD)/site
 BLOG_SRC_TOP_DIR = blogsource/content
 BLOG_POST_SRC_DIR = $(BLOG_SRC_TOP_DIR)/post
@@ -12,6 +13,7 @@ CONTRIBUTORS = $(wildcard $(CONTRIBUTORS_SRC_DIR)/*.md)
 PAGES_SRC_DIR = pagesource
 PAGES_SRC = $(wildcard $(PAGES_SRC_DIR)/*.xml)
 PAGES = $(subst $(PAGES_SRC_DIR)/,,$(PAGES_SRC:.xml=.html))
+PAGES_SRC += "xeps.xml"
 REDIRECTS_DIR = pageredirects
 REDIRECTS_SRC = $(wildcard $(REDIRECTS_DIR)/*.html)
 REDIRECTS = $(subst $(REDIRECTS_DIR)/,,$(REDIRECTS_SRC))
@@ -47,11 +49,20 @@ index.html: landing-template.xml index.xml profanity_version.txt
 	$(SBLG) -o $@ -t landing-template.xml -c index.gen.xml
 	rm -f index.gen.xml
 
-$(PAGES): manual-template.xml
+$(PAGES): manual-template.xml xeplist
 	cp --preserve=mode,ownership,timestamps $(addprefix $(PAGES_SRC_DIR)/,$(@:.html=.xml)) .
 	$(SBLG) -o $@ -t manual-template.xml -c $(@:.html=.xml)
 	rm -f $(PAGES:.html=.xml)
 
+xeplist: $(PAGES_SRC_DIR)/doap-stylesheet/style.xsl $(PAGES_SRC_DIR)/doap/profanity.doap \
+	$(PAGES_SRC_DIR)/xeplist/xeplist.xml
+	cp --preserve=mode,ownership,timestamps $(PAGES_SRC_DIR)/xeplist/xeplist.xml \
+		$(PAGES_SRC_DIR)/doap-stylesheet/
+	$(XSLTPROC) $(PAGES_SRC_DIR)/doap-stylesheet/style.xsl \
+		$(PAGES_SRC_DIR)/doap/profanity.doap \
+		> $(PAGES_SRC_DIR)/xeps.xml
+	rm $(PAGES_SRC_DIR)/doap-stylesheet/xeplist.xml
+
 themegallery.html: gallery-template.xml
 	$(SBLG) -o $@ -t gallery-template.xml -c themegallery.xml
 
@@ -77,6 +88,6 @@ $(REDIRECTS): $(REDIRECTS_SRC)
 clean:
 	$(MAKE) -C $(BLOG_POST_SRC_DIR) clean
 	$(MAKE) -C $(CONTRIBUTORS_SRC_DIR) clean
-	rm -f index.html $(PAGES) themegallery.html $(REDIRECTS)
+	rm -f index.html $(PAGES) themegallery.html $(REDIRECTS) $(PAGES_SRC_DIR)/xeps.xml
 	rm -r $(BLOG_POSTS_XML) $(BLOG_POSTS_OUT) $(BLOG_POST_OUT_TOP_DIR)
 	rm -r $(CONTRIBUTORS_XML) $(CONTRIBUTORS_OUT) $(CONTRIBUTORS_OUT_DIR)

README.md

@@ -17,7 +17,7 @@ The website is generated from XML and Markdown sources using [sblg](https://kris
 | **Style** | `css/*.css` | CSS |
 
 ### Page Sources
-The source files for the landing page (`index.xml`) and other top level pages in `pagesource/` are XML fragments. They contain the HTML content for the body, which is then injected into the appropriate header and footer templates.
+The source files for the landing page (`index.xml`) and other top level pages in `pagesource/` are XML fragments. They contain the HTML content for the body, which is then injected into the appropriate header and footer templates. The list of supported XEPS is generated using a git submodule for https://github.com/profanity-im/profanity/blob/master/profanity.doap.
 
 ### Blog
 Blog posts and contributor profiles are written in Markdown.
@@ -35,7 +35,15 @@ Command references (`main_fragment.html`, `toc_fragment.html`) and apidocs are g
 ### Build & Deploy
 GitHub Actions will automatically build and deploy the website to GitHub Pages on every push.
 
-To build the site locally, run `make` in the top level directory. You will need `sblg` and `lowdown` installed on your system.
+To build the site locally, run
+```
+git clone https://github.com/profanity-im/profanity-im.github.io.git
+cd profanity-im.github.io
+git submodule update --init --recursive
+make
+```
+
+You will need `sblg`, `lowdown` and `libxslt` installed on your system.
 
 To preview the site locally, run `make install` which will create a directory `site`, open `site/index.html` in a web browser.