Table of Contents
Video
You can include external and internal videos with curly brackets. The basic syntax is
{{video.mp4|A funny video}}
See images for the full syntax, alignment and resizing. DokuWiki should at least support ogv
, webm
and mp4
format, but see supported media formats for a more up to date list.
Fallback Formats
Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility.
For example consider this embedded mp4 video:
{{video.mp4|A funny video}}
When you upload a video.webm
and video.ogv
next to the referenced video.mp4
, DokuWiki will automatically add them as alternatives so that one of the three files is understood by your browser.
Poster image
Additionally DokuWiki supports a “poster” image which will be shown before the video has started. That image needs to have the same filename as the video and be either a jpg or png file. In the example above a video.jpg
file would work.
Subtitles
Starting with version that are newer than 2017-02-19e “Frusterick Manners”, DokuWiki supports video subtitles. As for the poster image, or the alternate video format, nothing special is needed. Just upload your subtitles files in Web Video Text Tracks Format (vtt) alongside the video file and you're done. This means you can easily add subtitles to existing videos. vtt-files have to be named after the video file but with extensions that indicate both the kind of track and the language. Most of the time, the kind will be sub
which means “standard subtitle”. See the table below for the full list.
For example, to add French and German subtitles to video foo.mp4
simply upload vtt files foo.sub.fr.vtt
and foo.sub.de.vtt
. DokuWiki and your browser will take care of the details.
DokuWiki supports all kinds defined by the W3C, but user experience may vary, depending on browser and installed software.
Kind code | Meaning | Description |
---|---|---|
sub | subtitles | Usual subtitles |
cap | captions | Subtitles for the hard of hearing |
des | descriptions | Audio description for the visually impaired |
cha | chapters | Chapter titles used when the user is navigating the media resource |
met | metadata | Technical info about the media |
Hint: If you need to convert existing subtitles to web vtt format, you can use an online subtitle converter. For example, to convert your SubRip Text (SRT) subtitles, you can use srt2vtt. But ask your favorite search engine, there exists many such free sites that can handle almost any subtitle format.