lets update to use the Jekyll docs publiser instead of doing it every time we use this template repo

Author: bitplane

.gitignore

@@ -5,3 +5,4 @@ htmlcov
 dist
 coverage.json
 site
+docs/pydoc

Makefile

@@ -1,6 +1,6 @@
 # the things that don't have output files or run every time
 .PHONY: help all install test dev coverage clean \
-		pre-commit update-pre-commit
+		pre-commit update-pre-commit docs dist
 
 
 PROJECT_NAME := example_package
@@ -18,7 +18,8 @@ test: .venv/.installed-dev  ## run the project's tests
 coverage: .venv/.installed-dev scripts/coverage.sh  ## build the html coverage report
 	scripts/coverage.sh $(PROJECT_NAME)
 
-docs: .docs/index.html ## build the documentation
+docs: .venv/.installed-dev scripts/docs.sh docs/index.md README.md pyproject.toml ## build the documentation
+	scripts/docs.sh
 
 clean:  ## delete caches and the venv
 	scripts/clean.sh
@@ -36,9 +37,6 @@ release: scripts/release.sh ## publish to pypi
 
 # Caching doesn't work if we depend on PHONY targets
 
-.docs/index.html: .venv/.installed-dev scripts/docs.sh mkdocs.yml $(shell find -name '*.md')
-	scripts/docs.sh $(PROJECT_NAME)
-
 .venv/.installed: pyproject.toml .venv/bin/activate scripts/install.sh $(shell find src -name '*.py')
 	scripts/install.sh $(PROJECT_NAME)
 

docs/index.md

@@ -0,0 +1 @@
+../README.md

mkdocs.yml

@@ -21,8 +21,6 @@ dev = [
     "build",
     "twine",
     "ruff",
-    "mkdocs",
-    "mkdocs-material",
     "pydoc-markdown"
 ]
 

pyproject.toml

@@ -1,12 +1,58 @@
-#!/usr/bin/bash
-
-source .venv/bin/activate
+#!/bin/sh
 
 set -e
 
-pushd src
-pydoc-markdown -p "$1" > ../docs/pydoc.md
-popd
+# Variables
+PROJECT_NAME=$(basename "$(pwd)")
+REPO_URL="ssh://git@github.com/bitplane/bitplane.net.git"
+SRC_PATH="docs"
+DEST_PATH="dev/python/$PROJECT_NAME"
+COMMIT_MSG="Update $PROJECT_NAME docs"
+
+# Build the pydocs
+. .venv/bin/activate
+
+mkdir -p docs/pydoc
+cd src
+pydoc-markdown -p "$PROJECT_NAME" > ../docs/pydoc/index.md
+cd ..
+
+# Check out the main website repo
+TMP_DIR=$(mktemp -d)
+
+# Cleanup on exit
+cleanup() {
+    echo "Cleaning up..."
+    rm -rf "$TMP_DIR"
+}
+trap cleanup EXIT
+
+# Clone the repository
+echo "Cloning $REPO_URL into $TMP_DIR..."
+git clone --depth=1 "$REPO_URL" "$TMP_DIR"
+
+# Set up the destination path
+FULL_DEST_PATH="$TMP_DIR/$DEST_PATH"
+
+# Copy files from source to destination
+echo "Copying files from $SRC_PATH to $FULL_DEST_PATH..."
+mkdir -p "$FULL_DEST_PATH"
+cp -r "$SRC_PATH/." "$FULL_DEST_PATH/"
+
+# Remove symlinks in the destination
+echo "Removing symlinks in $FULL_DEST_PATH..."
+find "$FULL_DEST_PATH" -type l -exec rm {} +
+
+# Replace symlinks with file contents
+echo "Replacing symlinks with file contents..."
+cd "$SRC_PATH"
+find . -type l -exec sh -c 'cat "$1" > "$2/$1"' _ {} "$FULL_DEST_PATH" \;
+
+# Commit and push
+echo "Committing and pushing changes..."
+cd "$TMP_DIR"
+git add "$DEST_PATH"
+git commit -m "$COMMIT_MSG"
+git push
 
-mkdocs build
-mkdocs gh-deploy
+echo "Docs published!"