Help:Extension:Phonos/QA

Project documentation

edit

meta:Community_Wishlist_Survey_2022/Generate_Audio_for_IPA

Phabricator board: https://phabricator.wikimedia.org/tag/mediawiki-extensions-phonos/

Feature documentation

edit

Usage

edit

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

Test documentation

edit

Where to test it

edit

The feature is currently available on:

How to install locally

edit

Download extension from Gerrit: Phonos Repo

See MediaWiki-Docker/Extension/Phonos.

Capabilities

edit
  • Pronounce strings written in IPA
  • Pull pronunciation audio and/or IPA from wikidata
  • Pull audio from Commons

Techniques we have used

edit

Does it have full coverage of IPA?

edit
  • Extract IPA from pages like w:International_Phonetic_Alphabet
  • There are some IPA characters (or encodings of IPA characters) which the Google TTS engine does not support. See phab:T313711.
  • WikiEditor has a list of IPA characters (in the toolbar under "Special characters" > IPA). Do we support all of these?
  • The IPA an engine supports often varies with the language

Quality of pronunciation

edit

Wikidata

edit

It can be hard to find Wikidata items and lexemes which contain IPA transcriptions and/or pronunciation audio. See Help:Extension:Phonos#Usage for requirements that the item/lexeme must meet to be picked up.

Example with IPA transcription: https://www.wikidata.org/wiki/Q1364834

Example with pronunciation audio: https://www.wikidata.org/wiki/Lexeme:L7993

Example with both: https://www.wikidata.org/wiki/Q32

Other examples can be found on https://en.wikipedia.beta.wmflabs.org/wiki/Phonos_Wikidata.

There are also queries you can run against https://query.wikidata.org to find Wikidata Items and Lexemes. See /Wikidata.

Validation

edit

Accessibility

edit

See /Accessibility for a list of accessibility concerns we concentrated on and which may need retesting in the future (depending on changes).

Bear in mind that Browserstack allows you to use the screenreaders NVDA on Windows, VoiceOver on Mac and iOS and TalkBack on Android (although Android does not have audio).

Browser compatibility

edit

We have found that different browsers and OSes can behave differently, not only from the UI perspective but also functionally (e.g. phab:T322368).

We have not done much mobile testing so far.

Skins

edit

Vector 2022, Vector 2010, Minerva, MonoBook and Timeless.

Maintaining consistency of the Phonos button across skins is quite hard.

Languages

edit

In particular, we have found UI bugs by testing in a right-to-left language (e.g. phab:T320415).

Zoom and font sizes

edit

We have had problems when zooming in/out on the browser, changing the browser's default font, and changing the font of the wikitext.

Example bug: phab:T320820.

See also /Accessibility#Resizing_text.

VisualEditor

edit

We have not done much testing on VisualEditor.

Other considerations

edit
  • Testing without JavaScript
  • Performance and scalability (see phab:T321084)
  • Cost
  • Interaction with other extensions
    • e.g. Extension:Popups
      • Other features/extensions which show article previews/summaries
  • Usability
    • Are the error messages helpful?
  • Obscure things
    • EBook exports

Common bugs

edit

Test data

edit

You will find lots of Phonos buttons we have generated as part of our testing on the various beta sites, particularly the pages in this category: https://en.wikipedia.beta.wmflabs.org/wiki/Category:Pages_that_use_Phonos.

Test tools

edit