Some articles on the wiki, such as articles about locations, often contain the audio found in that location. Being able to listen to the audio while browsing an article makes a better experience, as the audio is also part of the content that is included in that article.
There are multiple ways to get an audio source onto an article, but most have certain drawbacks. As of writing this guide, you can add in audio on articles in the following ways. Some of the pros/cons might be a little technical, but are not required knowledge to proceed with this guide.
Support for timeline, volume and general play/pause/stop.
Readers can stay on the article without interruptions.
Browsers / devices have different native display of audio on websites, so this solution is inconsistent to use.
Limited to 1 type of audio format, with no fallback mechanism.
Native audio display is hidden behind a button by default, which causes an initial interaction to get information on the audio source.
Using the specially made AudioPlayer widget
Consistent to use across different browsers/devices.
Minimal dependencies needed.
Support for multiple audio formats with fallback mechanism.
Support for timeline, volume and general play/pause/stop.
Readers can stay on the article without interruptions.
- Work in progress
Limited to the types of audio formats allowed to be uploaded to the wiki.
- Work in progress
From the above table, we can conclude that using the specifically made AudioPlayer has the most benefits to us, and is the recommended way of adding audio to articles on the wiki.