Video¶
Important
To include videos in your Git repository, you must install the Git Large File Storage Git extension and then enable it in your local repository using the following command:
git lfs install
The command must be run by every user after cloning the Git repository. If any user deletes their local copy of the repository and clones it again, then the command must be re-run.
Additionally, for every video file type you want to use, the following command needs to be run once (replacing the
mp4 part of the command with the required file extension):
git lfs track '*.mp4'
This command only has to be run once per repository.
The {video} block is used to embed a video, with the filename of the video:
:::{video} videos/installing-podman-desktop.mp4
:title: Installing Podman Desktop
:name: vid:installing-podman-desktop
:::
Transcript
Welcome to this short video in which we will install Podman Desktop and then also run through the basic onboarding process. So I’ve downloaded Podman Desktop for my operating system and I’m now just going to run the installer to start the installation process. This will take a few seconds and then Podman Desktop will start automatically.
Here we go. This is Podman Desktop after the initial start and you will see that there’s a notification saying that Podman needs to be set up. So we’re going to now click on the setup and run through this onboarding process. The first thing it will tell us is that it can’t find Podman. Now Podman Desktop is just the graphical interface we will use. The actual software for running the virtual computing environment is called Podman and that we now need to install and for that we’re just going to follow the on-screen instructions here.
So yeah it’s not installed. Yes we want to install it. We need to install WSL so the Windows subsystem for Linux as well just because that’s how the software then actually runs. So we just click on install and run through and it runs through the installation process and when that’s completed we just click on close and go back into the onboarding.
Now we can set Podman to start automatically when we launch Podman Desktop and that’s generally useful so we’re going to set that and click on next and then it’ll tell us that it can’t find the Podman machine. This is essentially a virtual machine in which the virtual computing environments will then run so we just need to walk through the process of creating one and again we don’t need a machine with privileges and we want to start the machine now and so then we just go ahead. Everything else we can leave in its default settings.
This process can take a bit so you just need to be patient.
Now we’ve got everything set up we can click on next and we’re back at the dashboard. We can see that Podman is running and so now we are ready to move on to running our virtual computing environment.
For accessibility reasons you must have a WebVTT subtitles file in the same
location and with the same filename as your video file, but with the extension .vtt.
If you want to have an initial image shown instead of the first frame of the video, then add a PNG image into the
same location, with the same filename as your video file, but with the extension .png.
Videos with a :name: attribute can be cross-referenced using the standard roles
(such as {numref}`vid:installing-podman-desktop`, which produces Video 1).
