Port to MkDocs and update BeagleY-AI guide (#1)

* Apply MkDocs template

* Remove "viewed as webpage" note

* Use admonition for wire peeling

* Use main branch for Pages builds

* Add link to original guide

* Correct formatting and layout

* Fix Home page formatting

* Add mkdocs-material scheme

* Enable emojis & icons

* Enable keyboard styled

* Add branding to site

* Fix ordering of top nav items

* Fix nav headers

* Fix links in Beagle guide

* Add prototype Q&A section

* Add instruction to enable wlan0

* Add blurb about kernels

* Reorder Beagle instructions

* Move board-specific info to own directories

* Fix cable section

* Add link to getting started guide in computing doc

* Update OS setup to use bb-imager

* Use requirements.txt

Author: yoshiask

.github/workflows/mkdocs_ghp.yml

@@ -0,0 +1,34 @@
+# https://squidfunk.github.io/mkdocs-material/publishing-your-site/#with-github-actions-material-for-mkdocs
+name: mkdocs_ghp 
+on:
+  push:
+    branches:
+      - main
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      - run: pip install pymdown-extensions
+      - run: pip install mkdocs-material
+      - run: pip install mkdocs-callouts
+      - run: pip install mkdocs-pagetree-plugin
+      - run: pip install mkdocs-material
+      - run: pip install mkdocs-awesome-nav
+      - run: mkdocs gh-deploy --force

README.md

@@ -0,0 +1,13 @@
+nav:
+  - Home: index.md
+  - Power: power.md
+  - Computing: computing.md
+  - Tools: tools.md
+  - Wiring: wiring.md
+  - Parts: parts.md
+  - Boards:
+    - BeagleY-AI: boards/beagley-ai
+    - Raspberry Pi: boards/raspberry-pi
+    - TI TDA4VM: boards/tda4vm
+  - Brand: brand.md
+  - Archive: archive.md

beagley-ai.md

@@ -1,6 +1,4 @@
-# Applications.md
-
-[view as WEB PAGE](https://qr.page/g/15vgHvaHTAe ':class=button')
+# Applications
 
 *This page is intended to serve the same function as the SCUTTLE [Applications Guide](https://www.scuttlerobot.org/resource/guide/applications-guide/) (in PDF) but to become more dynamic, open, and easily navigable.
 
@@ -11,9 +9,11 @@ Robotic projects, listed by their application, which focus a project on a mechan
 ## Example 1.17 Pole-mounted Maintenance
 
 **Discussion of problem:**
+
 * Tasks that require a broomstick are often tedious, located in narrow spaces, or requiring frequent repetition.  The fact that we have attached an item to a broomstick indicates right away that the human arm is not sufficient to do a job easily. 
 
 **Discussion of solution:**
+
 * Achieve painting, cleaning, or other maintenance functions with your SCUTTLE by attaching any off-the-shelf tool that uses the standard ACME (broomstick) thread.
 
 **Why it's easy**
@@ -24,13 +24,15 @@ Here's a 3D Model you can print for threads, credit to FredSWUG on GrabCAD.  [vi
 ## Example 1.18 Ship Painter
 
 **Discussion of problem:**
+
 * The most expensive part of a ship is the maintenance, which relies on continuous painting to prevent corrosion
 * Every crew member of a ship is costly, so docking the ships may be required to dock for painting.
 * Discovery of rust & deteriorated paint may be more important than applying paint.
 * It is tedious to search a whole ship for rust so currently there is no affordable solution.
 * Remote communication is unreliable on the sea, so remote expertise cannot help very much with identifying rust, etc.
 
 **Discussion of solution:**
+
 * A robot painter could make continuous scanning for rust, 24 hours per day, reducing docking time for the ship.
 * The robot painter can utilize edge AI to take photos and evaluate paint
 * While automation is still expensive, only high-cost problems are feasible and this is a high-cost problem.