ਫਰਮਾ:Hyphenated word start/doc ਲਈ ਸਰੋਤ ਵੇਖੋ

{{Documentation subpage}}
{{high-use|120000}}
{{notice|For simple hyphenations, use of this template is not necessary since the transclusion software connects the hyphenated word automatically.<ref name=nohws>See: [[Wikisource:Scriptorium/Archives/2018-09#hyphenated_words]].</ref> See also [[H:HYPHEN]].}}

{{template shortcut|hws|hwe}}
This document covers both the {{tl|hyphenated word start}} and {{tl|hyphenated word end}} templates, which must be used together as a pair. The abbreviated forms {{tl|hws}} and {{tl|hwe}} can be used instead. Together they allow the hyphenated word to be displayed in fragmented form in the {{code|Page:}} environment, while the whole word is displayed when the pages are transcluded.  In addition, in the {{code|Page:}} environment, the whole word is displayed in the formatted version of the page when the pointer hovers over the word fragment.

The {{tl|hws}} template appears on the individual page, but its contents are not transcluded into the book when pages are assembled; that is done by {{tl|hwe}}.  Therefore, italics must be placed ''within'' the template to prevent unwanted bold formatting (see below).

For more specialized usage—if the hyphenated word is part of an HTML link, for instance—see {{tl|linkable phrase start}} and {{tl|linkable phrase end}}.

==Usage==
The {{tl|hyphenated word start}} template is used for the beginning of a word that is hyphenated and split between two pages; {{tl|hyphenated word end}} is used for the end of the word.  They must be used together: at the bottom of the first page, and at the top of the following page, respectively.

===Regular version (using unnamed parameters, 1 and 2)===
The {{tl|hyphenated word start}} template displays param 1 (1st word-fragment) followed by a hyphen (-) in the "Page" namespace, and nothing in the "main" namespace.  An optional parameter can be used to change this hyphen to something else, or suppress it entirely.

The {{tl|hyphenated word end}} template displays param 1 (2nd word-fragment) in the "Page" namespace, and param 2 in the "main" namespace.

In both cases, Param 2 (the full-word) is used as the title-attribute for the text; i.e. a tooltip appears, showing the complete word, when you mouseover the word fragments in the "Page" namespace.

===Alternate version (using named parameters, "s" and "e")===
The {{tl|hyphenated word start}} template displays param "s" (1st or "start" word-fragment) followed by a hyphen (-) in the "Page" namespace, and nothing in the "main" namespace.  An optional parameter can be used to change this hyphen to something else, or suppress it entirely.

The {{tl|hyphenated word end}} template displays param "e" (2nd or "end" word-fragment) in the "Page" namespace, and a concatenation of param "s" and param "e" in the "main" namespace.

In both cases, the full-word (concatenation of params "s" and "e") is used as the title-attribute for the text; i.e. a tooltip appears, showing the complete word, when you mouseover the word fragments in the "Page" namespace. 

=== Examples ===

{| class="wikitable"
! colspan="4" | Regular version (copy and paste text below)
|- width="50%" style="vertical-align:top;"
| colspan="4" | 
:<code><nowiki>{{hyphenated word start |  |  }}</nowiki></code>
:<code><nowiki>{{hws |  |  }}</nowiki></code>
:<code><nowiki>{{hyphenated word end |  |  }}</nowiki></code>
:<code><nowiki>{{hwe |  |  }}</nowiki></code>
|- width="50%" style="vertical-align:top;"
! colspan="4" | Alternate version (copy and paste text below)
|- width="50%" style="vertical-align:top;"
| colspan="4" | 
:<code><nowiki>{{hyphenated word start |s=  |e=  }}</nowiki></code>
:<code><nowiki>{{hws |s=  |e=  }}</nowiki></code>
:<code><nowiki>{{hyphenated word end |s=  |e=  }}</nowiki></code>
:<code><nowiki>{{hwe |s=  |e=  }}</nowiki></code>
|- width="50%"  style="vertical-align:top;"
!
! 
! Page namespace
! Transcluded
|- width="50%"  style="vertical-align:top;"
! Example 1 (start)
| style="vertical-align: top;" |
<code><nowiki>{{hws |antici|anticipation}}</nowiki></code>
| style="vertical-align: top;" |
{{hws |antici|anticipation| namespace=Page }}
| style="vertical-align: top;" |
{{hws |antici|anticipation| namespace= }}
|- width="50%"  style="vertical-align:top;"
! Example 1 (end)
| style="vertical-align: top;" |
<code><nowiki>{{hwe |pation|anticipation}}</nowiki></code>
| style="vertical-align: top;" |
{{hwe |pation|anticipation| namespace=Page }}
| style="vertical-align: top;" |
{{hwe |pation|anticipation| namespace= }}<ref name=simple>For this case, use of these templates is not necessary if there are no footnotes since the transclusion software connects the hyphenated word automatically.</ref>
|- width="50%"  style="vertical-align:top;"
! Example 1a (start)
| style="vertical-align: top;" |
<code><nowiki>{{hws |s= antici |e= pation }}</nowiki></code>
| style="vertical-align: top;" |
{{hws |s= antici |e= pation | namespace=Page }}
| style="vertical-align: top;" |
{{hws |s= antici |e= pation | namespace= }}
|- width="50%"  style="vertical-align:top;"
! Example 1a (end)
| style="vertical-align: top;" |
<code><nowiki>{{hwe |s= antici |e= pation }}</nowiki></code>
| style="vertical-align: top;" |
{{hwe |s= antici |e= pation | namespace=Page }}
| style="vertical-align: top;" |
{{hwe |s= antici |e= pation | namespace= }}<ref name=simple />
|- width="50%"  style="vertical-align:top;"
! Example 2 (start)
| style="vertical-align: top;" |
<code><nowiki>{{hws |mother|mother-in-law}}</nowiki></code>
| style="vertical-align: top;" |
{{hws |mother|mother-in-law| namespace=Page }}
| style="vertical-align: top;" |
{{hws |mother|mother-in-law| namespace= }}
|- width="50%"  style="vertical-align:top;"
! Example 2 (end)
| style="vertical-align: top;" |
<code><nowiki>{{hwe |in-law|mother-in-law}}</nowiki></code>
| style="vertical-align: top;" |
{{hwe |in-law|mother-in-law| namespace=Page }}
| style="vertical-align: top;" |
{{hwe |in-law|mother-in-law| namespace= }}
|- width="50%"  style="vertical-align:top;"
! Example 2a (start)
| style="vertical-align: top;" |
<code><nowiki>{{hws |s=mother- |hyph= |e=in-law }}</nowiki></code>
| style="vertical-align: top;" |
{{hws |s=mother- |hyph= |e=in-law |namespace=Page }}
| style="vertical-align: top;" |
{{hws |s=mother- |hyph= |e=in-law |namespace= }}
|- width="50%"  style="vertical-align:top;"
! Example 2a (end)
| style="vertical-align: top;" |
<code><nowiki>{{hwe |s=mother- |hyph= |e=in-law }}</nowiki></code>
| style="vertical-align: top;" |
{{hwe |s=mother- |hyph= |e=in-law |namespace=Page }}
| style="vertical-align: top;" |
{{hwe |s=mother- |hyph= |e=in-law |namespace= }}
|- width="50%"  style="vertical-align:top;"
! Example 3 (start)
| style="vertical-align: top;" |
<code><nowiki>{{hws |'''antici| hyph=-''' |'''anticipation'''}}</nowiki></code>
| style="vertical-align: top;" |
{{hws |'''antici| hyph=-''' |'''anticipation'''| namespace=Page }}
| style="vertical-align: top;" |
{{hws |'''antici| hyph=-''' |'''anticipation'''| namespace= }}
|- width="50%"  style="vertical-align:top;"
! Example 3 (end)
| style="vertical-align: top;" |
<code><nowiki>{{hwe |'''pation'''|'''anticipation'''}}</nowiki></code>
| style="vertical-align: top;" |
{{hwe |'''pation'''|'''anticipation'''| namespace=Page }}
| style="vertical-align: top;" |
{{hwe |'''pation'''|'''anticipation'''| namespace= }}
|- width="50%"  style="vertical-align:top;"
! Example 4 (start)
| style="vertical-align: top;" |
<code><nowiki>{{hws |punc|punctuation}}</nowiki></code>
| style="vertical-align: top;" |
{{hws |punc|punctuation| namespace=Page }}
| style="vertical-align: top;" |
{{hws |punc|punctuation| namespace= }}
|- width="50%"  style="vertical-align:top;"
! Example 4 (end)
| style="vertical-align: top;" |
<code><nowiki>{{hwe |tuation|punctuation}}!</nowiki></code>
| style="vertical-align: top;" |
{{hwe |tuation|punctuation| namespace=Page }}!
| style="vertical-align: top;" |
{{hwe |tuation|punctuation| namespace= }}!<ref name=simple />
|- width="50%"  style="vertical-align:top;"
|}

Note: in Example 1, you cannot use any blank spaces around the input data ("antici" and "anticipation", or "pation" and "anticipation").  This is due to the Mediawiki implementation of templates: leading and trailing blank spaces are not stripped when using unnamed (numbered) parameters.

Example 1a reproduces Example 1, using the alternate version with named parameters "s" and "e".  You can leave blank spaces around the input data ("antici" and "pation") for readability.  This is because in the Mediawiki implementation of templates, leading and trailing blanks are stripped when using named parameters.

This alternate version is more compact but less flexible (see Example 2).

Example 2 is a case where the hyphen must ''not'' be dropped when the two halves of a hyphenated word are joined together.  This is easily handled with the regular version; however, using the alternate version with <code>s</code> and <code>e</code> parameters in the obvious way would give "<code>motherin-law</code>". A workaround, shown in Example 2a, is to hardcode the hyphen into the "s" parameter and use the "hyph" parameter to set the normally-occurring hyphen to blank.

However, there are more general situations where the unsplit word is not merely a simple unmodified fusion of the split halves: cases involving ligatures or variant letterforms in non-English languages, where letters may change their form depending on the surrounding letters; or, German-language hyphenation rules prior to the 1996 orthography reform (''bäcker'' hyphenated to ''bäk-ker''). These can only be handled by the regular version, not the alternate version.

In Example 3 the word is in boldface, and we want the hyphen to be in boldface too. The <code>hyph</code> parameter can be used to accomplish this (the visual difference between a regular hyphen and a boldface hyphen is admittedly barely perceptible).

=== "hyph" parameter ===
The <code>hyph</code> parameter is usually omitted, which results in an ordinary ASCII hyphen (U+002D) being added at the end of the first part of a split word.
*If specified, then the given character (or string of characters) is displayed instead of a hyphen, which could be useful for some situations or for non-English languages: eg, Unicode hyphen (U+2010), Armenian hyphen (U+058A), etc.
*If specified and left blank, then no hyphen at all is displayed.  '''Note''': specifying this parameter but leaving it blank '''is not the same''' as omitting it.

=== "Namespace" parameter ===
This parameter is only used for special purposes: by setting <code>|namespace=Page</code> you can force the templates to act as though they have been invoked within the "Page" namespace.  This can be useful for testing; it is also used within this documentation page to create the examples in the table above.

=== "title" parameter ===
This parameter is normally omitted but may be used to override the tool tip pop up generated in Page: space when the default behaviour becomes problematic (for example any hyphenation component involving additional &lt;span&gt;s can generate invalid HTML.)

=== Notes ===

A real world example can be found with the word "approach-ing" at Page namespace [[Page:Wind in the Willows (1913).djvu/306]] and [[Page:Wind in the Willows (1913).djvu/307]]; observe also the results in the main namespace at [[The Wind in the Willows (1913)/Chapter 10]]. 

Invalid invocations are placed into [[:Category:Invalid template invocation]].

(There have been problems in the past with spurious blank lines added to main namespace versions with the use of this template. Check the template code history/discussion for the latest scoop.)

====Formatting====
There are occasions where formatting is required to the hyphenated word, eg. italics. Due to the means of wiki-coding, it is recommended that formatting be done ''inside'' {{tl|hyphenated word start}} and ''outside'' of {{tl|hyphenated word end}}, for example,
* <code><nowiki>{{hyphenated word start|''format''|formatting}}</nowiki></code>
* <code><nowiki>''{{hyphenated word end|ing|formatting}}''</nowiki></code>, alternatively <code><nowiki>{{hyphenated word end|''ing''|''formatting''}}</nowiki></code>

==TemplateData==
<templatedata>
{
	"params": {
		"1": {
			"aliases": [
				"s"
			],
			"label": "Start",
			"description": "The hyphenated half of the word or phrase (without the hyphen).",
			"example": "antici",
			"type": "string",
			"required": true
		},
		"2": {
			"aliases": [
				"e"
			],
			"label": "Full word",
			"description": "The full word or phrase (without the hyphen)",
			"example": "anticipation",
			"type": "string",
			"required": true
		},
		"namespace": {
			"label": "Namespace",
			"description": "This parameter is only used for special purposes: by setting it you can force the templates to act as though they have been invoked within the 'Page' namespace. This can be useful for testing; it is also used within this documentation page to create the examples in the table above.",
			"type": "string"
		},
		"title": {
			"label": "Title",
			"description": "This parameter is normally omitted but may be used to override the tool tip pop up generated in Page: space when the default behaviour becomes problematic (for example any hyphenation component involving additional <span>s can generate invalid HTML.)"
		},
		"hyph": {
			"label": "Hyphen",
			"description": "The hyph parameter is usually omitted, which results in an ordinary ASCII hyphen (U+002D) being added at the end of the first part of a split word.\n* If specified, then the given character (or string of characters) is displayed instead of a hyphen, which could be useful for some situations or for non-English languages: eg, Unicode hyphen (U+2010), Armenian hyphen (U+058A), etc.\n* If specified and left blank, then no hyphen at all is displayed. Note: specifying this parameter but leaving it blank is not the same as omitting it.",
			"type": "string",
			"default": "-",
			"suggested": true
		}
	},
	"description": "Used to format a hyphenated word or phrase that is split over a page break (in the Page namespace).",
	"format": "inline",
	"paramOrder": [
		"1",
		"2",
		"hyph",
		"title",
		"namespace"
	]
}
</templatedata>

==See also==
* {{tl|page end hyphen}}
* {{tl|linkable phrase start}} & {{tl|linkable phrase end}}

== Footnotes ==
{{smallrefs}}

<!-- template categories and interwiki links -->
<includeonly>
[[Category:Typography templates]]
[[Category:Namespace manipulation templates]]
</includeonly>