Template:Lang-he/doc

From Wikisource
Jump to navigation Jump to search

This is a simple template that helps format Hebrew text. It defines the direction as right-to-left and HTML lang property to "he".

This template is not intended for formatting whole paragraphs, but only Hebrew passages in a paragraph that may be left-to-right. (In HTML terms, it's a <span>, not a <div>.)

It takes one required argument: "text". Example:

  • {{lang-he|text=ארץ זבת חלב ודבש}}

yields:

  • ארץ זבת חלב ודבש

It also takes the optional argument "vocalized". This argument sets the font to the free Frank Ruehl CLM font, and if it's not available, then next to other fonts that support cantillation marks, including Ezra SIL or Ezra SIL SR, SBL Hebrew.

Hebrew is usually written without vowel points ("Niqqud"), but Biblical texts, children books and poetry usually are printed with them. Most common Hebrew fonts do not support the vowel points well: although most of them include at least some of the required characters, the placement of the points and their combination with the consonant letters and with other points is buggy.

The fonts that are best suited for representing Hebrew text with vowel points are Taamey Frank CLM and Ezra SIL SR. They are specifically designed to be suited for complete display of Biblical vowels and cantillation and they are Free Software. If, for any reason, you cannot install them, try the "SBL Hebrew" font.

Compare:

  • With "vocalized": {{lang-he|vocalized=1|text=אָֽנָּ֫א‎}} -> אָֽנָּ֫א
  • Without "vocalized": {{lang-he|text=אָֽנָּ֫א‎}} -> אָֽנָּ֫א

This is the English Wikisource, Hebrew <span>s are expected to be embedded in left-to-right paragraphs; therefore by default this template ends with the left-to-right marker (‎). If you want to disable it, add the argument "nolrm=1":

  • Without "nolrm": {{lang-he|text=משה}}, {{lang-he|text=אהרן‎}} -> משה‎, אהרן
  • With "nolrm": {{lang-he|nolrm=1|text=משה}}, {{lang-he|text=אהרן‎}} -> משה, אהרן

See also[edit]