Switch to Markdown

.github/workflows/deploy-pages.yml

@@ -12,6 +12,11 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v5
+      - name: Install pandoc
+        run: |
+          sudo apt install pandoc
+      - name: Generate HTML from Markdown
+        run: make
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v4
         with:

.gitignore

@@ -0,0 +1,4 @@
+docs/*.html
+!docs/index.html
+
+.DS_Store

Makefile

@@ -0,0 +1,13 @@
+##
+# Build LYAH web site from Markdown sources using Pandoc and sed
+#
+
+all: site
+
+site:
+	cd markdown && ./generate.sh
+
+clean:
+	find ./docs -name '*.html' -not -name 'index.html' -delete
+
+# end

README.md

@@ -22,11 +22,13 @@ The whole thing is completely free to read online, but the original is also avai
 - [ ] refactor web code
 - [ ] make UI more modern (whilst retaining as much of the original "feel" as possible)
 - [x] make content pages mobile-friendly (*still needs work)
-- [ ] make homepage mobile-friendly
+- [ ] make index page mobile-friendly
 - [x] prepare "content edit request" interface on GitHub
 - [ ] add exercises
 - [ ] update content (just overall, the outdated parts)
 
+For some of these points, there are more focused issues on GitHub.
+
 Don't forget to star the GitHub repository if you like it! 🙂
 
 ## Discussion