Use folder structure instead of underscores in filenames
[GitHub/WoltLab/woltlab.github.io.git] / docs / view / languages.md
1 # Languages
2
3 WoltLab Suite offers full i18n support with its integrated language system,
4 including but not limited to dynamic phrases using template scripting and the
5 built-in support for right-to-left languages.
6
7 Phrases are deployed using the [language](../package/pip/language.md) package
8 installation plugin, please also read the [naming conventions for language items](languages-naming-conventions.md).
9
10 ## Special Phrases
11
12 ### `wcf.date.dateFormat`
13
14 !!! warning "Many characters in the format have a special meaning and will be replaced with date fragments. If you want to include a literal character, you'll have to use the backslash `\` as an escape sequence to indicate that the character should be output as-is rather than being replaced. For example, `Y-m-d` will be output as `2018-03-30`, but `\Y-m-d` will result in `Y-03-30`."
15
16 _Defaults to `M jS Y`._
17
18 The date format without time using PHP's format characters for the
19 [`date()`](https://secure.php.net/manual/en/function.date.php) function. This
20 value is also used inside the JavaScript implementation, where the characters
21 are mapped to an equivalent representation.
22
23 ### `wcf.date.timeFormat`
24
25 _Defaults to `g:i a`._
26
27 The date format that is used to represent a time, but not a date. Please see the
28 explanation on `wcf.date.dateFormat` to learn more about the format characters.
29
30 ### `wcf.date.firstDayOfTheWeek`
31
32 _Defaults to `0`._
33
34 Sets the first day of the week:
35 * `0` - Sunday
36 * `1` - Monday
37
38 ### `wcf.global.pageDirection` - RTL support
39
40 _Defaults to `ltr`._
41
42 Changing this value to `rtl` will reverse the page direction and enable the
43 right-to-left support for phrases. Additionally, a special version of the
44 stylesheet is loaded that contains all necessary adjustments for the reverse
45 direction.