====== Language Attributes, Multilingual Content, and Screen Reader Pronunciation ====== Each page must have a primary language set via the lang attribute on the tag. Any changes in language within the page should be marked using additional lang attributes on the surrounding HTML tag to ensure that screen readers pronounce things in the correct language. Without this attribute, all words will be pronounced using the primary language’s accent. See [[https://bugs.launchpad.net/evergreen/+bug/2001720|#2001720 Add language attributes to display fields for screen reader support]] While accessibility guidelines state that regional variants (such as a change from American to British English) should be marked accordingly, in practice most users prefer not to hear their screen reader switch accents unexpectedly. It’s therefore best to stick to the two-letter language code rather than the more specific four-letter variation unless the four-letter code is necessary to distinguish significant differences (as with Chinese languages) or there is another excellent reason to force an accent change. ===== Pronouncing date/time, names, acronyms, and abbreviations ===== Note that some things, like dates, names, and acronyms, may be pronounced in unwanted ways despite proper lang attributes. This is normal, and [[https://adrianroselli.com/2023/04/dont-override-screen-reader-pronunciation.html|you should not attempt to override the screen reader’s pronunciation]].