====== 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 [[wiki:syntax#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 [[https://www.w3.org/TR/webvtt1/|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 [[https://atelier.u-sub.net/srt2vtt/|srt2vtt]].
But ask your favorite search engine, there exists many such free sites that can handle almost any subtitle format.