Multi Languages
YAMLResume is designed to support multi languages out of the box.
Technically, there are two categories of things to do when supporting multi languages:
- Internationalization: often abbreviated as "i18n" (where the number 18 represents the 18 characters between "i" and "n"), is basically a set of practices that allow a product support multi languages, i18n main consists of translating the product into mutli languages and dynamically switching the language according to the user's choice
- Localization: often abbreviated as "l10n" (the number 10 represents the characters between "l" and "n"), it goes beyond mere translation and instead adapts the product to the cultural specifics of the target language.
In practice, i18n always comes first, l10n comes after.
For all supported languages, we have the following concerns from a design and implementation perspective:
- Linguistics: the theorectical side of a language, including but not limited to the language's character set, syntax and grammar, history, etc.
- Idioms: common conventions and idioms that are generally followed by a language.
- Typesetting: best typesetting practices often followed by a language, such as italics, text figures, font style, kerning, ligature, etc.
- Translations: mere translations for a fixed set of terms and options used by resumes generated by YAMLResume.
Supported Languages
You can use yamlresume languages list
to list all supported languages. At the
time of writing, YAMLResume supports the following languages:
$ yamlresume languages list
| `layout.locale.language` | Language Name |
| ------------------------ | ------------------------------- |
| en | English |
| zh-hans | Simplified Chinese |
| zh-hans-hk | Traditional Chinese (Hong Kong) |
| zh-hans-tw | Traditional Chinese (Taiwan) |
| es | Spanish |
Check the following pages for more details about each language:
English
English is the default language for YAMLResume when you create a new resume.
Chinese
Simplified Chinese and Traditional Chinese (Hong Kong and Taiwan) are supported.
Spanish
Spanish also uses Latin script as the primary writing system.
Glossaries
We have used the following glossaries throughout this section:
- Latin script languages: languages that use Latin script as the writing systems. Most germanic languages, romance languages and many other languages like https://en.wikipedia.org/wiki/Indonesian_language use Latin script as the primary writing system.
- CJK: Chinese, Japanese and Korean languages.
- Character Set: the complete collection of characters, symbols, glyphs, and punctuation marks available within a specific typeface or font.
- Glyph: the specific shape, design, or representation of a character in typography.
- Hyphenation, the practice of breaking words at the end of lines to improve the overall appearance and readability of text.
- Justification: the alignment of text within a block so that it is flush with both the left and right margins, generally achieved by adjusting the spacing between words and letters, creating a uniform appearance across each line of text.
- Kerning: the process of adjusting the spacing between characters in a proportional font, usually to achieve a visually pleasing result.
- Ligature: a glyph that joins two or more letters together in order to enhance the visual appeal of text and get better readability.