MediaWiki-Docker/Extension/Phonos

This page instructs you to install Extension:Phonos inside MediaWiki-Docker. Follow the Quickstart instructions at MediaWiki-Docker page. Once MediaWiki is running and available at http://localhost:8080, then continue with instructions on this page. All commands should be run in the directory where you installed MediaWiki. All mentioned files are also located there.

Clone the repository and its dependencies

git clone "https://gerrit.wikimedia.org/r/mediawiki/skins/Vector" skins/Vector
git clone "https://gerrit.wikimedia.org/r/mediawiki/extensions/Phonos" extensions/Phonos

Modify LocalSettings.php

If not already there, add this to the end of LocalSettings.php.

wfLoadSkin( 'Vector' );
wfLoadExtension( 'Phonos' );

You may also need to add extra configuration options as detailed here Extension:Phonos#Configuration_parameters.

If you use the espeak text-to-speech engine (the default) you will need to install espeak on both the mediawiki and mediawiki-jobrunner docker images (the jobrunner needs it as well because Phonos audio can also be generated as a job):

docker-compose exec -u root mediawiki bash -c "apt-get update && apt-get install espeak -y"
docker-compose exec -u root mediawiki-jobrunner bash -c "apt-get update && apt-get install espeak -y"

Also, if you use the espeak or Larynx text-to-speech engine, you will need to install lame, unless $wgPhonosStoreFilesAsMp3 = false:

docker-compose exec -u root mediawiki bash -c "apt-get update && apt-get install lame -y"
docker-compose exec -u root mediawiki-jobrunner bash -c "apt-get update && apt-get install lame -y"

Run maintenance scripts

docker compose exec mediawiki composer update
docker compose exec mediawiki php maintenance/run.php update.php

Validate Installation in Local

Navigate to Special:Version on your wiki to verify that the extension is successfully installed under Installed extensions.