Template:Linkable phrase start/doc

This document covers both the linkable phrase start and linkable phrase end templates, which must be used together as a pair.

The abbreviated forms lps and lpe can also be used.

Usage
These templates can be used when an HTML link is split between two pages. They must be used together: at the bottom of the first page, and at the top of the following page, respectively.

They can also be used without any HTML link, for instance to duplicate the functionality of hyphenated word start and hyphenated word end.


 * The link may optionally have non-linked text concatenated before and/or after the linked text (for instance, quote marks).
 * The link text may optionally contain an embedded hyphenated word, as in hyphenated word start and hyphenated word end.
 * The link target may even be omitted, in which case ordinary text is displayed.


 * The linkable phrase start template is used at the bottom of a page, to start an HTML link that will continue onto the next page
 * The linkable phrase end template must then be used at the top of the next page, to end the HTML link.

All field names must be lowercase. See also the complete description of fields.

Example 1 is taken from Page:Men of the Time, eleventh edition.djvu/42, Page:Men of the Time, eleventh edition.djvu/43, and Men of the Time, eleventh edition/Allibone, Samuel Austin

Example 2 is taken from Page:Men of the Time, eleventh edition.djvu/196, Page:Men of the Time, eleventh edition.djvu/197, and Men of the Time, eleventh edition/Browning, Robert.

Example 3 shows that it is not even necessary to use a link: this example duplicates the functionality of and . Note that doing a mouseover on the or the produces a tooltip that displays the full word " ".

Example 3a is an alternate way to do the same thing, using parameters  and   instead of   and.

Example 3b is a case where the hyphen must not be dropped when the two halves of a hyphenated word are joined together.

Example 3c is an alternate way to do the same thing, using parameters  and   instead of   and. A workaround is needed: hardcoding the hyphen into the  parameter and using the   parameter to set the normally-occurring hyphen to blank.

Example 4 is subtly different than simply putting  on the first page and   on the second page. If you do that, the transcluded version will be Robert Browning: the difference is that here the blank space between "Robert" and "Browning" is not part of the link, whereas in Example 4, it is.

Example 5 shows the use of the  parameter, which can be used to replace the hyphen that normally occurs to indicate a word split with a different character or string, or in this case, to suppress it entirely, for a language like Chinese which doesn't use hyphens when splitting a word that consists of multiple Chinese characters (eg, 中华人民共和国 = People's Republic of China).

Note: specifying this parameter and leaving it blank is not the same as omitting it. Omitting results in an ordinary ASCII hyphen (U+002D) being displayed; leaving it blank results in no hyphen character at all being displayed.

Example 6 is a repeat of Example 3, except the word is in boldface, and we want the hyphen to be in boldface too. The  parameter can be used to accomplish this (the visual difference between a regular hyphen and a boldface hyphen is admittedly barely perceptible).

Description of fields
Any of these fields may be omitted or left blank.


 * link: The link target, ie, the name of a page. Must not be wikilinked itself (ie, do not place it within  and  ).  Can be omitted, in which case no link is created.
 * lq: The name is intended to be suggestive of "left-quote". This (optional) text is pre-pended before the link, but is not linked itself: for instance, the "«" in «Bonjour»
 * rq: The name is intended to be suggestive of "right-quote". This (optional) text is appended after the link, but is not linked itself: for instance, the "»" in «Bonjour»
 * pre: This is the beginning of the link text, up to but not including the split-page hyphenated word (if any). It displays on the first page, after lq but before hw1 (if applicable)
 * post: This is the end of the link text: after, but not including, the split-page hyphenated word (if any). It displays on the second page, after hw2 but before rq (if applicable)
 * hw1: This works exactly the same way as the first (unnamed) parameter of hyphenated word start or hyphenated word end. For linkable phrase start, this is the first part of the split-page hyphenated word; for linkable phrase end, this is the second part of the split-page hyphenated word.
 * hw2: This works exactly the same way as the second (unnamed) parameter of hyphenated word start or hyphenated word end. This is the complete reunited word, as it appears in normal use when it is not split across two lines or two pages.
 * hws, hwe: These can be used as an alternative to hw1 and hw2. These are the first part ("s" for "start") and the second part ("e" for "end") of the split-page hyphenated word.  Note: this variant is more compact but less flexible: for instance, a workaround is needed to handle cases like   and , where the hyphen must not be dropped when joining the word back together (see example in the table above).  This variant cannot handle situations involving ligatures or variant letterforms in non-English languages, where letters may change their form depending on the surrounding letters; or, in general, any situation where the unsplit word is not merely a simple unmodified fusion of the split halves.
 * hyph: Only meaningful if hw1, hw2 (or hws, hwe) were specified. This 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. This is useful for a language like Chinese, which splits words without using any hyphen. Note: specifying this parameter but leaving it blank is not the same as omitting it.
 * namespace: This can be used to force the template to think it is being invoked in the Page namespace, by setting .  This is useful for testing purposes, or to make the examples in the table above work correctly even though this documentation page is not within the Page namespace.  It would not be used under normal circumstances.

How the result is displayed
The following describes how text is displayed, on the original pages and on the transcluded page:


 * (Note that the hyph parameter can be used to change the hyphen after  into something else, or suppress it altogether)


 * linkable phrase start


 * linkable phrase end

If the link parameter is omitted or blank, then the following is displayed:


 * linkable phrase start


 * linkable phrase end

In this case the distinction between lq and pre, or between post and rq, is no longer meaningful.