This page provides tips for people translating Mallard pages into other languages. Mallard was designed with localization in mind, and contains many features designed to support translation. Some of these features should be handled automatically by translation tools. Seeand for more information.
Mallard providesto support common needs in software documentation. Sometimes the markup in the original language is unnecessary in your language, or your language might need additional markup.
The em element emphasizes text. Mallard does not provide separate element for different semantic uses of emphasis, such as foreign words, introductions of terms, and titles of publications. In some languages, these uses don't all use font variations like italics. Non-latin scripts usually don't even have italics, although it is becoming more common to use an oblique font or other variant in those scripts.
If your language does not use italics or other font variants for a particular type of emphasis, you should leave out the em tag altogether and replace it with the correct text. For example, if the title of a publication is emphasized as <em>The Mallard Book</em>, but your language puts publication titles in quotations, you should replace this with «The Mallard Book», 『The Mallard Book』, or similar.