Template:Dir/doc

From Wikitech
Usage
Outputs "rtl" for right-to-left languages else "ltr".
The default returned values "rtl" and "ltr" can also be customized by optional parameters.
Syntax
  • {{dir|language-code}}
    The language-code parameter should be conforming to BCP47, as required by web standards (HTML/CSS...), rather than Wikimedia labels for designating languages in domain names (in some cases, Wikimedia language codes are not conforming and only used for interwikis and URLs; most of them are being migrated to BCP47, which is based on some parts of the ISO649 standard).
    If no language-code parameter is specified, it defaults to the preferred UI language of the visitor viewing the current page, which for you is currently en.
  • {{dir|language-code|2=return value for RTL scripts|3=return value for LTR scripts}}
  • {{dir|language-code|rtl=return value for RTL scripts|ltr=return value for LTR scripts}}
    The 2nd and 3rd (optional) parameters (which may be explicitly numbered or named, but must be numbered or named if no language code is provided in the 1st parameter) allow changing the default return values for languages written in RTL and LTR scripts, whose default are respectively "rtl" and "ltr".
    This can be used to customize CSS styles such as text alignment or floatting side or lateral margins/borders/paddings, or to change the displayed text/symbols or names of images/icons depending on the script direction.
Note
  • Currently it recognizes the following codes of languages usually written in a right-to-left script (such as Hebrew, Imperial Aramaic, Arabic, Old North Arabian, Old South Arabian, Divehi, or N’ko):
    aaf-arab | aao | abh | abq-arab | abv | ace-arab | acm | acq | acw | acx | acy-arab | adf | ady-arab | aeb | aeb-arab | aec | afb | aic | ajp | apc | apd | ar | ara | arb | arc | arq | ars | ary | arz | auz | avl | ayh | ayl | ayn | ayp | az-arab | azb | bal | bbz | bcc | bej-arab | ber-arab | bft | bgn | bgp | bjm | bjn-arab | bms-arab | bqi | bqp | brh-arab | bsk | cja-arab | cjm-arab | ckb | ckb-arab | crh-arab | deh | dgo-arab | dng-arab | doi-arab | dv | dyu-arab | en-rtl | fa | fa-af | ff-arab | ffm-arab | fub-arab | fuc-arab | fuf-arab | fuh-arab | fui-arab | fuv-arab | gbz-arab | gda | gju-arab | glk | gwc | ha-arab | hac | haz | hbo | he | hnd | hno | jat | kbd-arab | kbl-arab | kby-arab | kcn | kfr | khw | kk-arab | kk-cn | kls-arab | kmr-arab | knc-arab | kr-arab | krt-arab | ks | ks-arab | ktl | ku-arab | ky-arab | lad-hebr | lah | lki | lrc | lrk | luz | mad-arab | man-arab | mge-arab | mhj | mki-arab | mne-arab | mnk-arab | mrt-arab | ms-arab | mve | mvy | mwr-arab | mzb | mzn | nqo | ota | pa-arab | pbt | pbu | pga | phl | phn | phr | phv | pnb | prd | prs | ps | pst | raj-arab | rif-arab | rmt-arab | scl | sd | sdb | sdf | sdh | shi-arab | shu | shy-arab | skr | skr-arab | sqr | ssh | su-arab | sw-arab | swh | tg-arab | tig-arab | tk-arab | tly | tly-arab | trw | tt-arab | txj-arab | ug | ug-arab | ur | uz-arab | uzs | wbl | wlc-arab | wne | wni-arab | wo-arab | xhe | xng-arab | xpu | ydd | ydg | yhd | yhd-arab | yhd-hebr | yi | yih | zdj-arab
  • All other non-recognized codes (including the default English language) are considered to be using a left-to-right script (such as Latin, Greek, Cyrillic, Georgian, Armenian, Unified Canadian Syllabics, Cherokee, Deseret, Braille, Egyptian Hieroglyphs, Devanagari, Bengali, Gurmukhi, Gujarati, Oriya, Tamil, Telugu, Kannada, Malayalam, Sinhalese, Burmese, Thai, Khmer, Lao, Tibetan, Korean, Katakana, Hiragana, Emojis, Bopomofo, Yi, Traditional Mongolian, or CJK sinograms).
Examples
  • {{dir}}, for the current user language which is English (English), returns ltr.
  • {{dir|en}}, for English (English), returns ltr.
  • {{dir|ar}}, for Arabic (العربية), returns rtl.
  • {{dir|yi}}, for Yiddish (ייִדיש), returns rtl.
  • {{dir|2=right|3=left}}, for the current user language which is English (English), returns left.
  • {{dir|rtl=right|ltr=left}}, for the current user language which is English (English), returns left.
  • {{dir|en|right|left}}, for English (English), returns left.
  • {{dir|en|rtl=right|ltr=left}}, for English (English), returns left.
  • {{dir|ar|right|left}}, for Arabic (العربية), returns right.
  • {{dir|yi|right|left}}, for Yiddish (ייִדיש), returns right.