Extension:Phonos

The Phonos extension is a Community Tech project for implementing the IPA Audio Renderer wish from the 2022 Community Wishlist Survey.

Configuration parameters

 * $wgPhonosEngine: Which engine to use. One of  (default), , or.
 * $wgPhonosApiEndpointLarynx: The API endpoint to use for the Larynx engine.
 * $wgPhonosApiEndpointGoogle: The API endpoint to use for the Google engine.
 * $wgPhonosApiKeyGoogle: The API key for the Google engine.
 * $wgPhonosApiProxy: HTTP proxy to use for API requests. If not set, will be used.
 * $wgPhonosFileBackend: Which file backend to use for caching. Defaults to a custom Phonos backend using FSFileBackend.
 * $wgPhonosFileBackendDirectory: Which directory to use for file caching, if $wgPhonosFileBackend is . Defaults to.
 * $wgPhonosEspeak: Path to the eSpeak executable. Defaults to
 * $wgPhonosLame: Path to the Lame executable used for converting WAV to MP3. Defaults to
 * $wgPhonosPath: Relative URL path to where Phonos files are publicly available. Defaults to
 * $wgPhonosWikibaseUrl: The URL to a Wikibase installation, including the and trailing slash.
 * $wgPhonosWikibaseProperties: An object containing the following:
 * wikibasePronunciationAudioProp: Property for pronunciation audio.
 * wikibaseLangNameProp: Property for language of work or name.
 * wikibaseIETFLangTagProp: Property for IETF language tag.


 * $wgPhonosCommonsMediaUrl: URL to Special:FilePath on a shared media repository including the trailing slash.

Usage
For all usage information, see the extension's help page.

Maintenance
Phonos does not automatically delete files that have become orphaned. Over time, these files can build up and needlessly occupy space on your file system. To assist with this problem, Phonos offers two maintenance scripts:

countOrphanedFiles.php
This script will count orphaned files. You can pass the  flag to also delete the files.

On large wiki farms that use a config setting to control where extensions are deployed, use the  flag to indicate which setting to use for Phonos, i.e.  . If not provided, the script will iterate over all sites on the farm, as specified by the sites table. If the sites table is not populated, the script will act only on the current wiki.

deleteOldPhonosFiles.php
This script will delete all Phonos files created before the date specified with the  option. This is useful if you for instance changed the engine, and want to force recreation of Phonos files.