mkdocs

.gitattributes

@@ -0,0 +1,3 @@
+*.mp4 filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text

doc/de/KitBaumsatz.md → docs/KitBaumsatz.de.md

@@ -1,7 +1,7 @@
 # Bau(m)satz
 
-<img src="../img/baumsatz_front.png" width="200" height="200" alt="Bau(m)satz Vorderseite">
-<img src="../img/baumsatz_back.png" width="200" height="200" alt="Bau(m)satz Rückseite">
+<img src="../assets/images/baumsatz_front.png" width="200" height="200" alt="Bau(m)satz Vorderseite">
+<img src="../assets/images/baumsatz_back.png" width="200" height="200" alt="Bau(m)satz Rückseite">
 
 Diese Platine orientiert sich größtenteils am [Digistump](http://digistump.com/wiki/digispark/tutorials/connecting).
 Sie enthält auch den Microcontroller [ATtiny85](https://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-2586-AVR-8-bit-Microcontroller-ATtiny25-ATtiny45-ATtiny85_Datasheet.pdf) und die USB-Schaltung.

doc/de/KitUnicorn.md → docs/KitUnicorn.de.md

@@ -1,8 +1,8 @@
 # Unicorn
 
-<img src="../img/unicorn_front.png" width="200" height="200" alt="Unicorn Vorderseite">
-<img src="../img/unicorn_back.png" width="200" height="200" alt="Unicorn Rückseite">
-<img src="../img/unicorn_live.webp" width="260" height="200" alt="Unicorn Live">
+<img src="../assets/images/unicorn_front.png" width="200" height="200" alt="Unicorn Vorderseite">
+<img src="../assets/images/unicorn_back.png" width="200" height="200" alt="Unicorn Rückseite">
+<img src="../assets/images/unicorn_live.webp" width="260" height="200" alt="Unicorn Live">
 
 Diese Platine orientiert sich äußerlich am [Regenbogen Einhorn](https://shop.blinkyparts.com/de/Regenbogen-Einhorn-Loetbausatz-Einfacher-Anstecker-fuer-Anfaenger/blink232242). Die Bestückung ist allerdings gleich zum [Bau(m)satz](KitBaumsatz.md).
 

doc/de/KitUnicornS.md → docs/KitUnicornS.de.md

@@ -1,8 +1,8 @@
 # Unicorn S
 
-<img src="../img/unicorn_s_front.png" width="200" height="200" alt="Unicorn S Vorderseite">
-<img src="../img/unicorn_s_back.png" width="200" height="200" alt="Unicorn S Rückseite">
-<img src="../img/unicorn_s_live.jpg" width="200" height="200" alt="Unicorn S Rückseite">
+<img src="assets/images/unicorn_s_front.png" width="200" height="200" alt="Unicorn S Vorderseite">
+<img src="assets/images/unicorn_s_back.png" width="200" height="200" alt="Unicorn S Rückseite">
+<img src="assets/images/unicorn_s_live.jpg" width="200" height="200" alt="Unicorn S Rückseite">
 
 Diese Platine ist praktisch baugleich zum [Regenbogen Einhorn](https://shop.blinkyparts.com/de/Regenbogen-Einhorn-Loetbausatz-Einfacher-Anstecker-fuer-Anfaenger/blink232242).
 Es wurde nur ein anderer Schalter verwendet und die Beschriftung etwas modifiziert.

doc/de/ProgExamples.md → docs/ProgExamples.de.md

@@ -1,9 +1,16 @@
-Um vorhandene Beispielprogramme auf die Platine zu installieren musst du [unsere Quelldateien](https://github.com/HaCraFu/assembly-kits/archive/refs/heads/main.zip) entpackt haben. Ungefähr so:
+# Programmierbeispiele
 
+## Download
 
+Um vorhandene Beispielprogramme auf die Platine zu installieren musst du [unsere Quelldateien](https://github.com/HaCraFu/assembly-kits/archive/refs/heads/main.zip) entpackt haben. Ungefähr so:
 
-https://user-images.githubusercontent.com/569476/201182708-acaa4405-1dc1-4569-b38f-cbbf6431099c.mp4
+<figure class="video_container">
+  <video controls="true" allowfullscreen="true">
+    <source src="../assets/videos/extract.mp4" type="video/mp4">
+  </video>
+</figure>
 
+## Öffnen
 
 Öffne dann in Visual Studio Code Ordner `firmware` um die folgenden Installationsbefehle ausführen zu können. Du darfst die Platine erst mit dem PC verbinden, wenn dich der Befehl mit dem Text
 ```
@@ -12,13 +19,15 @@ https://user-images.githubusercontent.com/569476/201182708-acaa4405-1dc1-4569-b3
 dazu auffordert. Das ganze sieht dann ungefähr so aus:
 
 
-https://user-images.githubusercontent.com/569476/201183405-0103f8cb-6e34-4ea9-b6d8-c2079674172b.mp4
-
-
+<figure class="video_container">
+  <video controls="true" allowfullscreen="true">
+    <source src="../assets/videos/use_vscode.mp4" type="video/mp4">
+  </video>
+</figure>
 
-# Arrow
+## Beispiel Arrow
 
-Auf dem [Bau(m)satz](KitBaumsatz.md) zeigt dieses Programm eine kleine Pfeilanimation.
+Auf dem [Bau(m)satz](KitBaumsatz.de.md) zeigt dieses Programm eine kleine Pfeilanimation.
 
 Installieren mit dem Befehl 
 ```
@@ -28,7 +37,7 @@ pio run -e arrow -t upload
 Verändern des Programms in der Datei `firmware/src/arrow/main.cpp`
 
 
-# Random
+## Beispiel Random
 
 Lässt zufällig eine der sechs LED beim Start leuchten. Keine Gewähr für [Gleichverteilung](https://de.wikipedia.org/wiki/Stetige_Gleichverteilung)!
 
@@ -40,7 +49,7 @@ pio run -e random -t upload
 Verändern des Programms in der Datei `firmware/src/random/main.cpp`
 
 
-# Random LED
+## Beispiel Random LED
 
 Wechselt nach kurzer Pause zu einer zufälligen LED.
 
@@ -52,7 +61,7 @@ pio run -e random_led -t upload
 Verändern des Programms in der Datei `firmware/src/random_led/main.cpp`
 
 
-# Provisioning Bau(m)satz
+## Beispiel Provisioning Bau(m)satz
 
 Die initiale Firmware. Schaltet nacheinander alle LEDs an. Wechselt danach alle 8 Sekunden zwischen LED-Paaren weiter.
 
@@ -64,7 +73,7 @@ pio run -e provisioning_baumsatz_usb -t upload
 Verändern des Programms in der Datei `firmware/src/provisioning_baumsatz/main.cpp`
 
 
-# Provisioning Unicorn
+## Beispiel Provisioning Unicorn
 
 Die initiale Firmware. Schaltet nacheinander alle LEDs an. Danach folgt eine Animation.
 
@@ -76,7 +85,7 @@ pio run -e provisioning_unicorn_usb -t upload
 Verändern des Programms in der Datei `firmware/src/provisioning_unicorn/main.cpp`
 
 
-# Keyboard
+## Beispiel Keyboard
 
 Beispielprogramm für Keyboardemulation. 
 
@@ -91,7 +100,7 @@ pio run -e keyboard -t upload
 Verändern des Programms in der Datei `firmware/src/keyboard/main.cpp`
 
 
-# Touch dice
+## Beispiel Touch dice
 
 Beispielprogramm für Touch. Berührt man die USB-Pins mit dem feuchten Finger würfelt das Programm eine andere LED aus.
 

docs/ProgSetupLinux.de.md

@@ -0,0 +1,8 @@
+# Einrichtung der Programmierumgebung unter Linux
+
+Installiere dir das Paket `platformio` um die Firmware kompilieren zu können.
+
+Als Entwicklungsumgebung bietet sich [VS Code](https://code.visualstudio.com/docs/setup/linux) an. 
+Es bietet mit dem `platformio` Plugin eine gute Integration, aber jeder andere Editor tut es auch.
+
+Eine Übersicht zu Programmierbeispielen und wie du sie ausführst findest du [hier](ProgExamples.de.md).

doc/de/ProgSetupWindows.md → docs/ProgSetupWindows.de.md

@@ -4,14 +4,20 @@
 Die Programmierung unter Windows benötigt die Installation [dieses Treibers](https://github.com/digistump/DigistumpArduino/releases/download/1.6.7/Digistump.Drivers.zip). Hier eine kurze Videoanleitung:
 
 
-https://user-images.githubusercontent.com/569476/201181683-92534c1a-1d4b-48df-86cc-ece778e53c06.mp4
-
+<figure class="video_container">
+  <video controls="true" allowfullscreen="true">
+    <source src="../assets/videos/win_install_driver.mp4" type="video/mp4">
+  </video>
+</figure>
 
 ## 2. Installation Platformio
 Am einfachsten lässt sich der Microcontroller mit Hilfe von [Platformio](https://platformio.org/) unter Visual Studio Code programmieren. Hier eine kleine Videoanleitung:
 
-
-https://user-images.githubusercontent.com/569476/201181769-0e4393ec-65b8-4a6d-b767-c9183d24455c.mp4
+<figure class="video_container">
+  <video controls="true" allowfullscreen="true">
+    <source src="../assets/videos/win_install_vscode_pio.mp4" type="video/mp4">
+  </video>
+</figure>
 
 Wie im Video gezeigt, installiere bitte [Visual Studio Code](https://code.visualstudio.com/).
 In Visual Studio Code installierst du dann die Erweiterung `PlatformIO`.