Template:Script/Hebrew

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search

Template documentationview · edit · history · purge ]
This documentation is transcluded from Template:Script/Hebrew/doc.

Usage

[edit]

This template marks a string as Hebrew script. It is transcluded by {{Script}} and by {{Lang-he-n}}. Do not include it directly, but instead use: {{script|Hebr|‹Hebrew script string›}}.

This template only marks a string as Hebrew script, not as Hebrew language. Therefore, it is not appropriate for actual words in Hebrew. Hebrew words are marked instead like this: {{lang|he|‹Hebrew language string›}}. For entire paragraphs in Hebrew, use {{rtl-para|he|‹Hebrew language string›}}.

Under the hood

[edit]

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|}}}" dir="rtl">{{{1}}}</span>

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.

Examples

[edit]

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}}:

א

Please mark all Hebrew text with either {{script|Hebr}} or {{lang|he}}. This will allow users to format all examples of Hebrew text consistently, with their choice of fonts, colours, etc.

How to override fonts in user's preferences

[edit]

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.