removing _build

Author: robin-swift

.github/workflows/build.yml

@@ -16,7 +16,7 @@ jobs:
     - uses: actions/checkout@v4
 
     - name: build website
-      run: bash bin/website.sh
+      run: bash build.sh
 
     - name: Upload static files as artifact
       id: deployment

build.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+
+function build_static_site () {
+
+    echo "Generating static site..."
+    rm -fr site
+    mkdir site
+
+    python3 -m pip install --upgrade pip
+    python3 -m venv .
+    source bin/activate
+
+    ./bin/pip install mkdocs
+    ./bin/pip install mkdocs-material
+
+    # Documentation framework
+    ./bin/pip install sphinx
+    # Sphinx style
+    ./bin/pip install furo
+
+    ./bin/mkdocs build
+    echo "Done."
+
+}
+
+function build_website_docs () {
+
+    echo "Building HTML documentation..."
+    cd docs/manual
+        make html
+        mkdir -p ../../site/docs
+        mv _build/html/* ../../site/docs
+    cd ../..
+    echo "Done."
+
+}
+
+function build_print_docs () {
+
+    echo "Building printable documentation..."
+    cd docs/manual
+        make latexpdf
+        mv _build/latex/embroidermodder.pdf ../../site/docs/emrm_current.pdf
+    cd ../..
+    echo "Done."
+
+}
+
+if [ $# -lt 1 ]; then
+    build_static_site
+    build_website_docs
+    build_print_docs
+    exit
+fi
+
+# For running individual build steps when targeting an issue
+# effecting one step.
+while [ $# -gt 0 ]; do
+    case $1 in
+    --site) build_static_site;;
+    --web) build_website_docs;;
+    --print) build_print_docs;;
+    *) echo "Unrecognised option $1.";;
+    esac
+    shift
+done

docs/manual/LICENSE.md

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)