add gh workflows

.github/workflows/docs.yml

@@ -0,0 +1,83 @@
+# SPDX-FileCopyrightText: 2024 Thomas Buck <thomas@xythobuz.de>
+# SPDX-License-Identifier: CERN-OHL-S-2.0+
+#
+#  ------------------------------------------------------------------------------
+# | Copyright (c) 2024 Thomas Buck <thomas@xythobuz.de>                          |
+# |                                                                              |
+# | This source describes Open Hardware and is licensed under the CERN-OHL-S v2  |
+# | or any later version.                                                        |
+# |                                                                              |
+# | You may redistribute and modify this source and make products using it under |
+# | the terms of the CERN-OHL-S v2 (https://ohwr.org/cern_ohl_s_v2.txt)          |
+# | or any later version.                                                        |
+# |                                                                              |
+# | This source is distributed WITHOUT ANY EXPRESS OR IMPLIED WARRANTY,          |
+# | INCLUDING OF MERCHANTABILITY, SATISFACTORY QUALITY AND FITNESS FOR A         |
+# | PARTICULAR PURPOSE. Please see the CERN-OHL-S v2 (or any later version)      |
+# | for applicable conditions.                                                   |
+# |                                                                              |
+# | Source location: https://git.xythobuz.de/thomas/drumkit                      |
+# |                                                                              |
+# | As per CERN-OHL-S v2 section 4, should You produce hardware based on this    |
+# | source, You must where practicable maintain the Source Location visible      |
+# | on the external case of the Gizmo or other products you make using this      |
+# | source.                                                                      |
+#  ------------------------------------------------------------------------------
+
+name: Docs
+
+# only build single instance of docs for latest main branch
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      pages: write
+      id-token: write
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Checkout repo submodules
+        run: git submodule update --init
+
+      - name: Install dependencies
+        run: |
+          sudo add-apt-repository --yes ppa:kicad/kicad-7.0-releases
+          sudo apt update
+          sudo apt install -y --install-recommends kicad pipx libfuse2 libegl1 poppler-utils
+
+      - name: Install latest mdbook
+        run: |
+          tag=$(curl 'https://api.github.com/repos/rust-lang/mdbook/releases/latest' | jq -r '.tag_name')
+          url="https://github.com/rust-lang/mdbook/releases/download/${tag}/mdbook-${tag}-x86_64-unknown-linux-gnu.tar.gz"
+          mkdir mdbook
+          curl -sSL $url | tar -xz --directory=./mdbook
+          echo `pwd`/mdbook >> $GITHUB_PATH
+
+      - name: Generate Plots
+        run: pcb/generate_plot.sh
+
+      - name: Build Book
+        run: docs/generate_docs.sh build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v2
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: 'docs/book'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1

.github/workflows/kicad.yml

@@ -0,0 +1,69 @@
+# SPDX-FileCopyrightText: 2024 Thomas Buck <thomas@xythobuz.de>
+# SPDX-License-Identifier: CERN-OHL-S-2.0+
+#
+#  ------------------------------------------------------------------------------
+# | Copyright (c) 2024 Thomas Buck <thomas@xythobuz.de>                          |
+# |                                                                              |
+# | This source describes Open Hardware and is licensed under the CERN-OHL-S v2  |
+# | or any later version.                                                        |
+# |                                                                              |
+# | You may redistribute and modify this source and make products using it under |
+# | the terms of the CERN-OHL-S v2 (https://ohwr.org/cern_ohl_s_v2.txt)          |
+# | or any later version.                                                        |
+# |                                                                              |
+# | This source is distributed WITHOUT ANY EXPRESS OR IMPLIED WARRANTY,          |
+# | INCLUDING OF MERCHANTABILITY, SATISFACTORY QUALITY AND FITNESS FOR A         |
+# | PARTICULAR PURPOSE. Please see the CERN-OHL-S v2 (or any later version)      |
+# | for applicable conditions.                                                   |
+# |                                                                              |
+# | Source location: https://git.xythobuz.de/thomas/drumkit                      |
+# |                                                                              |
+# | As per CERN-OHL-S v2 section 4, should You produce hardware based on this    |
+# | source, You must where practicable maintain the Source Location visible      |
+# | on the external case of the Gizmo or other products you make using this      |
+# | source.                                                                      |
+#  ------------------------------------------------------------------------------
+
+name: PCB
+
+# build for each push and pull request
+on: [push, pull_request]
+
+jobs:
+  fabrication:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Checkout repo submodules
+        run: git submodule update --init
+
+      - name: Install dependencies
+        run: |
+          sudo add-apt-repository --yes ppa:kicad/kicad-7.0-releases
+          sudo apt update
+          sudo apt install -y --install-recommends kicad
+          sudo apt-get install -y zip
+
+      - name: Generate fabrication files
+        run: |
+          ./pcb/generate_fab.sh
+
+      - name: Upload board files
+        uses: actions/upload-artifact@v4.0.0
+        with:
+          name: prototype-pcb
+          path: pcb/fabrication
+
+      - name: Upload release files
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v1
+        with:
+          files: pcb/fab.zip

docs/generate_docs.sh

@@ -31,11 +31,11 @@ INPCB="drumkit.kicad_pcb"
 
 cd "$(dirname "$0")"
 
-echo "Generating plots"
-rm -rf src/plot
-../pcb/generate_plot.sh
-cp -r ../pcb/plot src
-echo
+#echo "Generating plots"
+#rm -rf src/plot
+#../pcb/generate_plot.sh
+#cp -r ../pcb/plot src
+#echo
 
 for IN in $INSCH
 do

docs/src/pcb1.md

@@ -2,3 +2,6 @@
 
 This is the hardware design for the initial prototype gifted as a birthday present.
 It's a single sided PCB layout suitable for hand etching at home.
+
+[![hand etching prototype pcb](https://www.xythobuz.de/img/lars_13_small.jpg)](https://www.xythobuz.de/img/lars_13.jpg)
+[![assembled prototype](https://www.xythobuz.de/img/lars_10_small.jpg)](https://www.xythobuz.de/img/lars_10.jpg)