Merge pull request #3981 from raspberrypi/develop

Release to production
raspberrypi · Dec 13, 2024 · 4fbe29f · 4fbe29f
2 parents 0d4117e + 7c2d655
commit 4fbe29f
Show file tree

Hide file tree

Showing 138 changed files with 31 additions and 1,357 deletions.
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -42,8 +42,6 @@ jobs:
         run: make build_doxygen_adoc
       - name: Build documentation
         run: make -j 2
-      - name: Run tests
-        run: ./tests/run_documentation_tests.sh
       - name: Deploy to Mythic Beasts
         if: ${{ github.ref == 'refs/heads/master' }}
         uses: ./.github/actions/deploy-action

diff --git a/documentation/asciidoc/accessories/ai-kit/images/ai-kit.jpg b/documentation/asciidoc/accessories/ai-kit/images/ai-kit.jpg
diff --git a/documentation/asciidoc/accessories/audio/getting_started.adoc b/documentation/asciidoc/accessories/audio/getting_started.adoc
@@ -130,7 +130,7 @@ Press *Ctrl X*, then *Y*, then *Enter* to save, then reboot your device with `su
 
 The final step is to ensure that everything is operating as expected. Press the button and release it when you hear the burp. The recording will now begin for a period of five seconds. Once you have released the button, press it briefly again to hear the recording. Repeat this process as many times as you wish, and your sounds will be played at random. You can delete all recordings by pressing and holding the button, keeping the button pressed during the first burp and recording process, and releasing it after at least 20 seconds, at which point you will hear another burp sound confirming that the recordings have been deleted.
 
-video::BjXERzu8nS0[youtube]
+video::BjXERzu8nS0[youtube,width=80%,height=400px]
 
 === Next steps
 

diff --git a/documentation/asciidoc/accessories/audio/images/Chatter_Box.jpg b/documentation/asciidoc/accessories/audio/images/Chatter_Box.jpg
diff --git a/documentation/asciidoc/accessories/audio/images/Chatterbox_Labels.png b/documentation/asciidoc/accessories/audio/images/Chatterbox_Labels.png
diff --git a/documentation/asciidoc/accessories/audio/images/Codec_Zero_Board_Diagram.png b/documentation/asciidoc/accessories/audio/images/Codec_Zero_Board_Diagram.png
diff --git a/documentation/asciidoc/accessories/audio/images/DAC+_Board_Diagram.png b/documentation/asciidoc/accessories/audio/images/DAC+_Board_Diagram.png
diff --git a/documentation/asciidoc/accessories/audio/images/DAC_Pro_Board_Diagram.png b/documentation/asciidoc/accessories/audio/images/DAC_Pro_Board_Diagram.png
diff --git a/documentation/asciidoc/accessories/audio/images/DigiAMP+_Board_Diagram.png b/documentation/asciidoc/accessories/audio/images/DigiAMP+_Board_Diagram.png
diff --git a/documentation/asciidoc/accessories/audio/images/dac_plus.png b/documentation/asciidoc/accessories/audio/images/dac_plus.png
diff --git a/documentation/asciidoc/accessories/audio/images/optional_xlr_board.jpg b/documentation/asciidoc/accessories/audio/images/optional_xlr_board.jpg
diff --git a/documentation/asciidoc/accessories/audio/images/wiring.jpg b/documentation/asciidoc/accessories/audio/images/wiring.jpg
diff --git a/documentation/asciidoc/accessories/audio/images/write_protect_tabs.jpg b/documentation/asciidoc/accessories/audio/images/write_protect_tabs.jpg
diff --git a/documentation/asciidoc/accessories/build-hat/images/blinking-light.gif b/documentation/asciidoc/accessories/build-hat/images/blinking-light.gif
diff --git a/documentation/asciidoc/accessories/build-hat/images/blinking-light.webm b/documentation/asciidoc/accessories/build-hat/images/blinking-light.webm
diff --git a/documentation/asciidoc/accessories/build-hat/images/connect-motor.gif b/documentation/asciidoc/accessories/build-hat/images/connect-motor.gif
diff --git a/documentation/asciidoc/accessories/build-hat/images/connect-motor.webm b/documentation/asciidoc/accessories/build-hat/images/connect-motor.webm
diff --git a/documentation/asciidoc/accessories/build-hat/images/fitting-build-hat.gif b/documentation/asciidoc/accessories/build-hat/images/fitting-build-hat.gif
diff --git a/documentation/asciidoc/accessories/build-hat/images/fitting-build-hat.webm b/documentation/asciidoc/accessories/build-hat/images/fitting-build-hat.webm
diff --git a/documentation/asciidoc/accessories/build-hat/images/powering-build-hat.gif b/documentation/asciidoc/accessories/build-hat/images/powering-build-hat.gif
diff --git a/documentation/asciidoc/accessories/build-hat/images/powering-build-hat.webm b/documentation/asciidoc/accessories/build-hat/images/powering-build-hat.webm
diff --git a/documentation/asciidoc/accessories/build-hat/images/tall-headers.png b/documentation/asciidoc/accessories/build-hat/images/tall-headers.png
diff --git a/documentation/asciidoc/accessories/build-hat/images/turning-motor.gif b/documentation/asciidoc/accessories/build-hat/images/turning-motor.gif
diff --git a/documentation/asciidoc/accessories/build-hat/images/turning-motor.webm b/documentation/asciidoc/accessories/build-hat/images/turning-motor.webm
diff --git a/documentation/asciidoc/accessories/build-hat/preparing-build-hat.adoc b/documentation/asciidoc/accessories/build-hat/preparing-build-hat.adoc
@@ -4,7 +4,7 @@ NOTE: Before starting to work with your Raspberry Pi Build HAT you should xref:.
 
 Attach 9mm spacers to the bottom of the board. Seat the Raspberry Pi Build HAT onto your Raspberry Pi. Make sure you put it on the right way up. Unlike other HATs, all the components are on the bottom, leaving room for a breadboard or LEGO® elements on top.  
 
-image::images/fitting-build-hat.gif[width="80%"]
+video::images/fitting-build-hat.webm[width="80%"]
 
 === Access the GPIO Pins
 
@@ -68,7 +68,7 @@ Connect an external power supply — the https://raspberrypi.com/products/build-
 The Build HAT cannot power Keyboard-series devices, since they do not support power supply over the GPIO headers.
 ====
 
-image::images/powering-build-hat.gif[width="80%"]
+video::images/powering-build-hat.webm[width="80%"]
 
 [NOTE]
 ====

diff --git a/documentation/asciidoc/accessories/build-hat/py-motors.adoc b/documentation/asciidoc/accessories/build-hat/py-motors.adoc
@@ -6,7 +6,7 @@ There are xref:build-hat.adoc#device-compatibility[a number of motors] that work
 
 Connect a motor to port A on the Build HAT. The LPF2 connectors need to be inserted the correct way up. If the connector doesn't slide in easily, rotate by 180 degrees and try again.
 
-image::images/connect-motor.gif[width="80%"]
+video::images/connect-motor.webm[width="80%"]
 
 
 ==== Work with Motors
@@ -24,11 +24,11 @@ motor_a.run_for_seconds(5)
 
 Run the program by clicking the play/run button. If this is the first time you're running a Build HAT program since the Raspberry Pi has booted, there will be a few seconds pause while the firmware is copied across to the board. You should see the red LED extinguish and the green LED illuminate. Subsequent executions of a Python program will not require this pause.
 
-image::images/blinking-light.gif[width="80%"]
+video::images/blinking-light.webm[width="80%"]
 
 Your motor should turn clockwise for 5 seconds.
 
-image::images/turning-motor.gif[width="80%"]
+video::images/turning-motor.webm[width="80%"]
 
 Change the final line of your program and re-run. 
 

diff --git a/documentation/asciidoc/accessories/camera/camera_hardware.adoc b/documentation/asciidoc/accessories/camera/camera_hardware.adoc
@@ -47,7 +47,7 @@ The flex cable inserts into the connector labelled CAMERA on the Raspberry Pi, w
 
 We have created a video to illustrate the process of connecting the camera. The following video shows how to connect the original camera on the original Raspberry Pi 1. The principle is the same for all Raspberry Pi boards with a camera connector, though the Raspberry Pi 5 and all Raspberry Pi Zero models require a https://www.raspberrypi.com/products/camera-cable/[different camera cable].
 
-video::GImeVqHQzsE[youtube]
+video::GImeVqHQzsE[youtube,width=80%,height=400px]
 
 Depending on the model, the camera may come with a small piece of translucent blue plastic film covering the lens. This is only present to protect the lens while it is being mailed to you, and needs to be removed by gently peeling it off.
 

diff --git a/documentation/asciidoc/accessories/camera/images/FILTER_OFF.jpg b/documentation/asciidoc/accessories/camera/images/FILTER_OFF.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/FILTER_ON.jpg b/documentation/asciidoc/accessories/camera/images/FILTER_ON.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/FLATLAY.jpg b/documentation/asciidoc/accessories/camera/images/FLATLAY.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/REMOVE_FILTER.jpg b/documentation/asciidoc/accessories/camera/images/REMOVE_FILTER.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/SCREW_REMOVED.jpg b/documentation/asciidoc/accessories/camera/images/SCREW_REMOVED.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/SOLVENT.jpg b/documentation/asciidoc/accessories/camera/images/SOLVENT.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/m12-lens.jpg b/documentation/asciidoc/accessories/camera/images/m12-lens.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/resistor.jpg b/documentation/asciidoc/accessories/camera/images/resistor.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/rpi_hq_cam_clear_filter.jpg b/documentation/asciidoc/accessories/camera/images/rpi_hq_cam_clear_filter.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/rpi_hq_cam_gasket.jpg b/documentation/asciidoc/accessories/camera/images/rpi_hq_cam_gasket.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/rpi_hq_cam_ir_filter.jpg b/documentation/asciidoc/accessories/camera/images/rpi_hq_cam_ir_filter.jpg
diff --git a/documentation/asciidoc/accessories/camera/images/rpi_hq_cam_sensor.jpg b/documentation/asciidoc/accessories/camera/images/rpi_hq_cam_sensor.jpg
diff --git a/documentation/asciidoc/accessories/display/images/display-rotation.png b/documentation/asciidoc/accessories/display/images/display-rotation.png
diff --git a/documentation/asciidoc/accessories/display/images/display.png b/documentation/asciidoc/accessories/display/images/display.png
diff --git a/documentation/asciidoc/accessories/m2-hat-plus/images/m2-hat-plus.jpg b/documentation/asciidoc/accessories/m2-hat-plus/images/m2-hat-plus.jpg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_1.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_1.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_10.png b/documentation/asciidoc/accessories/monitor/images/repair_10.png
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_11.png b/documentation/asciidoc/accessories/monitor/images/repair_11.png
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_12.png b/documentation/asciidoc/accessories/monitor/images/repair_12.png
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_13.png b/documentation/asciidoc/accessories/monitor/images/repair_13.png
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_14.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_14.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_15.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_15.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_16.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_16.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_17.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_17.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_19.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_19.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_2.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_2.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_20.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_20.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_21.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_21.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_22.png b/documentation/asciidoc/accessories/monitor/images/repair_22.png
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_23.png b/documentation/asciidoc/accessories/monitor/images/repair_23.png
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_25.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_25.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_3.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_3.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_4.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_4.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_5.jpeg b/documentation/asciidoc/accessories/monitor/images/repair_5.jpeg
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_6.png b/documentation/asciidoc/accessories/monitor/images/repair_6.png
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_7.png b/documentation/asciidoc/accessories/monitor/images/repair_7.png
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_8.png b/documentation/asciidoc/accessories/monitor/images/repair_8.png
diff --git a/documentation/asciidoc/accessories/monitor/images/repair_9.png b/documentation/asciidoc/accessories/monitor/images/repair_9.png
diff --git a/documentation/asciidoc/accessories/sense-hat/images/Sense-HAT.jpg b/documentation/asciidoc/accessories/sense-hat/images/Sense-HAT.jpg
diff --git a/documentation/asciidoc/computers/ai/getting-started.adoc b/documentation/asciidoc/computers/ai/getting-started.adoc
@@ -188,7 +188,7 @@ To install version 4.17 of Hailo's neural network tooling, run the following com
 +
 [source,console]
 ----
-$ sudo apt install hailo-tappas-core-3.28.2 hailort=4.17.0 hailo-dkms=4.17.0-1
+$ sudo apt install hailo-tappas-core=3.28.2 hailort=4.17.0 hailo-dkms=4.17.0-1
 ----
 +
 [source,console]

diff --git a/documentation/asciidoc/computers/camera/images/cam.jpg b/documentation/asciidoc/computers/camera/images/cam.jpg
diff --git a/documentation/asciidoc/computers/camera/images/cam2.jpg b/documentation/asciidoc/computers/camera/images/cam2.jpg
diff --git a/documentation/asciidoc/computers/compute-module/images/cm4.jpg b/documentation/asciidoc/computers/compute-module/images/cm4.jpg
diff --git a/documentation/asciidoc/computers/compute-module/images/cm4s.jpg b/documentation/asciidoc/computers/compute-module/images/cm4s.jpg
diff --git a/documentation/asciidoc/computers/compute-module/images/cm5io-case-front.png b/documentation/asciidoc/computers/compute-module/images/cm5io-case-front.png
diff --git a/documentation/asciidoc/computers/compute-module/images/cm5io-case.png b/documentation/asciidoc/computers/compute-module/images/cm5io-case.png
diff --git a/documentation/asciidoc/computers/compute-module/images/cm5io.png b/documentation/asciidoc/computers/compute-module/images/cm5io.png
diff --git a/documentation/asciidoc/computers/getting-started/images/peripherals/cable-all.png b/documentation/asciidoc/computers/getting-started/images/peripherals/cable-all.png
diff --git a/documentation/asciidoc/computers/getting-started/images/peripherals/cable-hdmi.png b/documentation/asciidoc/computers/getting-started/images/peripherals/cable-hdmi.png
diff --git a/documentation/asciidoc/computers/getting-started/images/peripherals/cable-key.png b/documentation/asciidoc/computers/getting-started/images/peripherals/cable-key.png
diff --git a/...mentation/asciidoc/computers/getting-started/images/peripherals/cable-mouse.png b/...mentation/asciidoc/computers/getting-started/images/peripherals/cable-mouse.png
diff --git a/documentation/asciidoc/computers/getting-started/images/peripherals/cable-net.png b/documentation/asciidoc/computers/getting-started/images/peripherals/cable-net.png
diff --git a/...mentation/asciidoc/computers/getting-started/images/peripherals/cable-power.png b/...mentation/asciidoc/computers/getting-started/images/peripherals/cable-power.png
diff --git a/documentation/asciidoc/computers/getting-started/images/peripherals/sd-card.png b/documentation/asciidoc/computers/getting-started/images/peripherals/sd-card.png
diff --git a/documentation/asciidoc/computers/getting-started/install.adoc b/documentation/asciidoc/computers/getting-started/install.adoc
@@ -24,7 +24,7 @@ If you have no other computer to write an image to a boot device, you may be abl
 === Install using Imager
 
 ////
-TODO: Update this video for the new Imager look & flow (video::ntaXWS8Lk34[youtube])
+TODO: Update this video for the new Imager look & flow (video::ntaXWS8Lk34[youtube,width=80%,height=400px])
 ////
 
 You can install Imager in the following ways:
@@ -127,7 +127,7 @@ Network Install enables a Raspberry Pi to install an operating system on a stora
 Network Install only runs on Flagship models since Raspberry Pi 4B and Keyboard models. If your Raspberry Pi runs an older bootloader, you may need to xref:raspberry-pi.adoc#bootloader_update_stable[update the bootloader] to use Network Install.
 
 ////
-TODO: Update this video for the new Imager look & flow video::b1SYVpM9lto[youtube]
+TODO: Update this video for the new Imager look & flow video::b1SYVpM9lto[youtube,width=80%,height=400px]
 ////
 
 Network Install requires the following:

diff --git a/documentation/asciidoc/computers/getting-started/setting-up.adoc b/documentation/asciidoc/computers/getting-started/setting-up.adoc
@@ -1,7 +1,7 @@
 [[setting-up-your-raspberry-pi]]
 == Getting started with your Raspberry Pi
 
-video::CQtliTJ41ZE[youtube]
+video::CQtliTJ41ZE[youtube,width=80%,height=400px]
 
 To get started with your Raspberry Pi, you'll need the following:
 

diff --git a/documentation/asciidoc/computers/raspberry-pi/images/500.png b/documentation/asciidoc/computers/raspberry-pi/images/500.png
diff --git a/documentation/asciidoc/computers/raspberry-pi/images/compute-module-4.jpg b/documentation/asciidoc/computers/raspberry-pi/images/compute-module-4.jpg
diff --git a/documentation/asciidoc/computers/raspberry-pi/images/compute-module-4s.jpg b/documentation/asciidoc/computers/raspberry-pi/images/compute-module-4s.jpg
diff --git a/documentation/asciidoc/computers/raspberry-pi/images/compute-module-5.png b/documentation/asciidoc/computers/raspberry-pi/images/compute-module-5.png
diff --git a/documentation/asciidoc/computers/raspberry-pi/images/j5.png b/documentation/asciidoc/computers/raspberry-pi/images/j5.png
diff --git a/documentation/asciidoc/computers/raspberry-pi/images/zero-2-wh.png b/documentation/asciidoc/computers/raspberry-pi/images/zero-2-wh.png
diff --git a/documentation/asciidoc/computers/remote-access/images/network-tooltip.png b/documentation/asciidoc/computers/remote-access/images/network-tooltip.png
diff --git a/...entation/asciidoc/computers/remote-access/images/raspberry-pi-configuration.png b/...entation/asciidoc/computers/remote-access/images/raspberry-pi-configuration.png
diff --git a/documentation/asciidoc/computers/remote-access/images/vnc-enable.png b/documentation/asciidoc/computers/remote-access/images/vnc-enable.png
diff --git a/documentation/asciidoc/computers/remote-access/images/vnc-tigervnc-desktop.png b/documentation/asciidoc/computers/remote-access/images/vnc-tigervnc-desktop.png
diff --git a/documentation/asciidoc/microcontrollers/c_sdk/images/Blink-an-LED-640x360-v2.gif b/documentation/asciidoc/microcontrollers/c_sdk/images/Blink-an-LED-640x360-v2.gif
diff --git a/documentation/asciidoc/microcontrollers/c_sdk/images/Blink-an-LED-640x360.gif b/documentation/asciidoc/microcontrollers/c_sdk/images/Blink-an-LED-640x360.gif
diff --git a/documentation/asciidoc/microcontrollers/c_sdk/images/Blink-an-LED-FINAL.gif b/documentation/asciidoc/microcontrollers/c_sdk/images/Blink-an-LED-FINAL.gif
diff --git a/documentation/asciidoc/microcontrollers/c_sdk/images/Blink-an-LED.webm b/documentation/asciidoc/microcontrollers/c_sdk/images/Blink-an-LED.webm
diff --git a/documentation/asciidoc/microcontrollers/c_sdk/images/Hello-World-640x360-v2.gif b/documentation/asciidoc/microcontrollers/c_sdk/images/Hello-World-640x360-v2.gif
diff --git a/documentation/asciidoc/microcontrollers/c_sdk/images/Hello-World-640x360.gif b/documentation/asciidoc/microcontrollers/c_sdk/images/Hello-World-640x360.gif
diff --git a/...mentation/asciidoc/microcontrollers/c_sdk/images/Hello-World-No-Wires-FINAL.gif b/...mentation/asciidoc/microcontrollers/c_sdk/images/Hello-World-No-Wires-FINAL.gif
diff --git a/documentation/asciidoc/microcontrollers/c_sdk/images/Hello-World.webm b/documentation/asciidoc/microcontrollers/c_sdk/images/Hello-World.webm
diff --git a/documentation/asciidoc/microcontrollers/c_sdk/your_first_binary.adoc b/documentation/asciidoc/microcontrollers/c_sdk/your_first_binary.adoc
@@ -4,7 +4,7 @@
 
 The first program anyone writes when using a new microcontroller is to blink an LED on and off. The Raspberry Pi Pico comes with a single LED on-board. The LED is connected to `GP25` on the board's Raspberry Pi RP2040 for Pico, and `WL_GPIO0` on the Infineon 43439 wireless chip for Pico W.
 
-image:images/Blink-an-LED-640x360-v2.gif[]
+video::images/Blink-an-LED.webm[width="80%"]
 
 You can blink this on and off by,
 
@@ -21,7 +21,7 @@ You can see the code on Github for the https://github.com/raspberrypi/pico-examp
 
 The next program anyone writes is to say 'Hello World' over a USB serial connection.
 
-image:images/Hello-World-640x360-v2.gif[]
+video::images/Hello-World.webm[width="80%"]
 
 . Download the https://datasheets.raspberrypi.com/soft/hello_world.uf2['Hello World' UF2].
 . Push and hold the BOOTSEL button and plug your Pico into the USB port of your Raspberry Pi or other computer.

diff --git a/documentation/asciidoc/microcontrollers/debug-probe/getting-started.adoc b/documentation/asciidoc/microcontrollers/debug-probe/getting-started.adoc
@@ -4,7 +4,7 @@ image:images/labelled-wiring.jpg[width="100%"]
 
 Depending on your setup, there are several ways to wire the Debug Probe to a xref:pico-series.adoc[Pico-series device]. Below, we connect the Debug Probe to a Raspberry Pi Pico H which has the newer three-pin JST-SH connector for SWD.
 
-video::4RCZBZsfsek[youtube]
+video::4RCZBZsfsek[youtube,width=80%,height=400px]
 
 Connect the following:
 

diff --git a/documentation/asciidoc/microcontrollers/debug-probe/images/labelled-wiring-old.png b/documentation/asciidoc/microcontrollers/debug-probe/images/labelled-wiring-old.png
diff --git a/documentation/asciidoc/microcontrollers/debug-probe/images/labelled-wiring.jpg b/documentation/asciidoc/microcontrollers/debug-probe/images/labelled-wiring.jpg
diff --git a/documentation/asciidoc/microcontrollers/debug-probe/images/wiring-real.jpg b/documentation/asciidoc/microcontrollers/debug-probe/images/wiring-real.jpg
diff --git a/documentation/asciidoc/microcontrollers/micropython/drag-and-drop.adoc b/documentation/asciidoc/microcontrollers/micropython/drag-and-drop.adoc
@@ -2,7 +2,7 @@
 
 You can program your Pico by connecting it to a computer via USB, then dragging and dropping a file onto it so we've put together a downloadable UF2 file to let you install MicroPython more easily.
 
-image::images/MicroPython-640x360-v2.gif[]
+video::images/MicroPython.webm[width="80%"]
 
 Download the correct MicroPython UF2 file for your board:
 

diff --git a/...ntation/asciidoc/microcontrollers/micropython/images/MicroPython-640x360-v2.gif b/...ntation/asciidoc/microcontrollers/micropython/images/MicroPython-640x360-v2.gif
diff --git a/documentation/asciidoc/microcontrollers/micropython/images/MicroPython-640x360.gif b/documentation/asciidoc/microcontrollers/micropython/images/MicroPython-640x360.gif
diff --git a/documentation/asciidoc/microcontrollers/micropython/images/MicroPython-640x480.gif b/documentation/asciidoc/microcontrollers/micropython/images/MicroPython-640x480.gif
diff --git a/documentation/asciidoc/microcontrollers/micropython/images/MicroPython-OLD.gif b/documentation/asciidoc/microcontrollers/micropython/images/MicroPython-OLD.gif
diff --git a/...entation/asciidoc/microcontrollers/micropython/images/MicroPython-Update-v1.gif b/...entation/asciidoc/microcontrollers/micropython/images/MicroPython-Update-v1.gif
diff --git a/documentation/asciidoc/microcontrollers/micropython/images/MicroPython.webm b/documentation/asciidoc/microcontrollers/micropython/images/MicroPython.webm
diff --git a/documentation/asciidoc/microcontrollers/silicon/rp1.adoc b/documentation/asciidoc/microcontrollers/silicon/rp1.adoc
@@ -8,7 +8,7 @@ image::images/rp1.jpg[alt="Architecture diagram of the RP1",width="70%"]
 
 RP1 is a 12×12mm, 0.65mm-pitch BGA southbridge, which provides the majority of the I/O capabilities for Raspberry Pi 5.
 
-video::aioB40BGQYU[youtube]
+video::aioB40BGQYU[youtube,width=80%,height=400px]
 
 It provides:
 

diff --git a/jekyll-assets/css/style.css b/jekyll-assets/css/style.css
@@ -924,7 +924,7 @@ span.mlabel {
 
 #content table.tableblock th {
   font-size: 0.85em;
-  background-color: var(--code-bg-colour);
+  background-color: var(--tab-bg-colour);
   text-align: left;
   padding: 5px 7px 5px 7px;
   border: 1px solid var(--subtle);
@@ -1081,18 +1081,8 @@ div.admonitionblock td.content {
 div.videoblock {
   position: relative;
   overflow: hidden;
-  padding-top: 56.25%;
+  padding-top: 20px;
   padding-bottom: 20px;
-  margin-bottom: 30px;
-}
-
-div.videoblock iframe {
-  position: absolute;
-  top: 0;
-  left: 0;
-  width: 100%;
-  height: 100%;
-  border: 0;
 }
 
 /* WHITEPAPER SIDEBARS */

diff --git a/scripts/create_auto_ninjabuild.py b/scripts/create_auto_ninjabuild.py
@@ -27,14 +27,23 @@ def scan_adoc(adoc_filename, apparent_filename, includes, src_images, dest_image
             includes[adoc_filename].add(include_adoc)
             scan_adoc(include_adoc, apparent_filename, includes, src_images, dest_images, parents.copy())
         # look for image files
-        for image in re.findall(r'image::?(.+?)\[.*\]', contents):
-            if not (image.startswith('http:') or image.startswith('https:')):
-                image_filename = resolve_url(adoc_filename, image)
-                dest_image = resolve_url(apparent_filename, image)
+        for file in re.findall(r'image::?(.+?)\[.*\]', contents):
+            if not (file.startswith('http:') or file.startswith('https:')):
+                image_filename = resolve_url(adoc_filename, file)
+                dest_image = resolve_url(apparent_filename, file)
                 if dest_image in dest_images and dest_images[dest_image] != image_filename:
                     raise Exception("{} and {} would both end up as {}".format(dest_images[dest_image], image_filename, dest_image))
                 src_images[image_filename] = dest_image
                 dest_images[dest_image] = image_filename
+        # look for video webm files, ignore youtube videos and all other formats for now (must update later if this changes)
+        for file in re.findall(r'video::?(.+?)\[.*\]', contents):
+            if file.endswith('.webm'):
+                video_filename = resolve_url(adoc_filename, file)
+                dest_video = resolve_url(apparent_filename, file)
+                if dest_video in dest_images and dest_images[dest_video] != video_filename:
+                    raise Exception("{} and {} would both end up as {}".format(dest_images[dest_video], video_filename, dest_video))
+                src_images[video_filename] = dest_video
+                dest_images[dest_video] = video_filename
 
 def add_entire_directory(tab_dir, dir_path, pages_set, src_images, dest_images):
     #print("Adding all files from {} directory".format(tab_dir))

diff --git a/tests/fixtures/_config.yml b/tests/fixtures/_config.yml
diff --git a/tests/fixtures/build_jekyll_data_index.json b/tests/fixtures/build_jekyll_data_index.json
diff --git a/tests/fixtures/github_edit.adoc b/tests/fixtures/github_edit.adoc