Template:Script/Hebrew/doc

From The League Wiki
Jump to navigation Jump to search

Lua error in Module:TNT at line 159: Missing JsonConfig extension; Cannot load https://commons.wikimedia.org/wiki/Data:I18n/Uses TemplateStyles.tab.

Usage

This template marks a string as Hebrew script. It is transcluded by {{Script}}.

This template only marks a string as Hebrew script, not as Hebrew language. Therefore, it is not appropriate for Hebrew text, which should be marked instead like this: {{Lang-he|‹Hebrew language string›}}. For entire paragraphs in Hebrew, please use {{Rtl-para|he|‹Hebrew language string›}}.

Under the hood

This defines font-families, font-size and a CSS class:

<templatestyles src="Script/styles_hebrew.css" /><span class="script-hebrew" style="font-size: {{{size|115%}}}; {{{style|}}}" {{{attributes|}}} {{#ifeq: {{{no_rtl_mark|+}}} | {{{no_rtl_mark|-}}}||dir="rtl"}}>{{{1}}}</span>{{#ifeq: {{{no_rtl_mark|+}}} | {{{no_rtl_mark|-}}}||&lrm;}}

This template has two goals:

  1. The font-family definitions provided by Template:Script/styles_hebrew.css, which will bring an appropriate font to render Hebrew texts for better rendering, especially for texts with nikud.
  2. The CSS class allows Wikipedia users to specify their own style for Hebrew script text by including a custom font declaration for .script-hebrew in their user CSS, see Help:User style.

Please mark all Hebrew script with either {{Lang-he}} if the text is in Hebrew, or with {{Script/Hebrew}} if it isn't. This will facilitate consistent formatting of Hebrew text and script.

Examples

Placing a Hebrew sign in {{Script}}:

{{Script/Hebr|א}}

The result will be a span with a class attribute, like this:

<span class="script-hebrew" style="font-size: 115%;" dir="rtl">א</span>

Which appears in your browser as:

א

Without {{Script}}:

א

How to override fonts in user's preferences

Any user can use another font with a different size by writing the following on his custom CSS. (see Help:User style)

An example making the font size 137%, and choosing SBL Hebrew to be the main font with 5 additional fonts:

.script-hebrew {
    font-size: 137% !important;
    font-family: "SBL Hebrew", David, Narkisim,
    "Times New Roman", FrankRuehl, Gisha, sans-serif !important; 
}
  • Font names containing spaces (or any other character than a letter) need to be put between " or '.
  • The list of fonts should always be terminated by the pseudo-font names "sans-serif" and/or "serif", to allow using the fonts defined in user preferences in their browser, or the fonts set by default in browsers.
  • Remember to add the phrase !important at the end of the font-size line and at the end of the font-family line, since they are already specified by the template and you want to override them.
  • You may choose to add the line-height phrase if you wanted to make lines in a paragraph more spaced from each other, or less spaced. line-height: 125%; Remember to put it before the }. The more number percentage, the more space is added. If you wanted to decrease the line height spacing, decrease the percentage. You may use any number (e.g. 85% or 140%) or use the special value normal which will properly use the minimum setting of the line-height recommended by each candidate font.