Template:Hidden multi-line/doc

This is a "wrapper" for Template:Hidden and provides the following additional facilities:
 * Long or right-aligned captions do not overlap the "show"/"hide" link.
 * The header text can be multi-line, and automatically increases its height as needed.
 * Separate background colours for the header text and "show"/"hide" link.
 * Options to control the font-size of the header text, content text and "show"/"hide" link.
 * Options to control the line-spacing and font-weight of the header text and content text.
 * Options to provide additional CSS for the header text, content text and "show"/"hide" link if you want more detailed control of their appearance.

In the example on the right, Template:HiddenMultiLine is used within the caption area of Template:Chess diagram. Sorry about the lurid colours, the example tries to show as many options in use as possible - all the default colours are "transparent".

If you want to enhance this template or produce a special-purpose version of it:
 * see Help:Template for technical guidance.
 * do not change the default values of parameters, as this may break existing uses of the template.

Usage

 * Example - caption and content un-named

USSR Championship 1933}}
 * Example - caption and content parameters are named
 * content-text= After sacrificing a piece to expose Black's King, Botvinnik played 1. Bh5+ and Yudovich resigned as mate is inevitable, e.g. 1. ... Kxh5; 2. Ng3+ followed by 3. Qe4+ Rf4; 4. Qxf4#.
 * caption-text= Botvinnik-Yudovich,
 * caption-text= Botvinnik-Yudovich,

Required parameters
This template has been tested with plain text, with HTML codes that generate special characters and with wiki-links. It has not been tested with text containing HTML tags. In particular, attempts to use HTML tags that are not allowed within the HTML  tag (paragraph) may break the layout. If you want to split the caption text into multiple lines, as in the example, insert the HTML tag in the right place (including the &lt; and &gt;). The simple syntax for external web links, Some page at that site, does not work in the caption-text - in fact it makes the caption-text invisible! This appears to be a limitation of Template:Hidden, which this template uses. However the "cite web" template is OK, provided you are prepared to handle complaints about there being no "accessdate" parameter ("accessdate" would add the text "Retrieved on ...", which you would not want in the caption). You can even include a tag in the title, as the example shows.
 * caption-text : Text for the caption. If unnamed, this must be the 1st parameter.

Most HTML tags should work here if correctly coded. If they do not, there may be a fault in Template:Hidden, as Template:HiddenMultiLine simply passes the content text to Template:Hidden. At present external links (e.g. [www.anyoldsite.com/somepage.htm About any subject at all] ) do not work; they show e.g. [www.anyoldsite.com/somepage.htm About any subject at all] - this appears to be a limitation of Template:Hidden, which this template uses. However the "cite web" template is OK, provided you are prepared to handle complaints about there being no "accessdate" parameter ("accessdate" would add the text "Retrieved on ...", which you probably would not want in the content).
 * content-text : Text for the hidden content that is revealed when the user clicks "show". If unnamed, this must be the 2nd parameter.

Optional parameters
These have defaults that work in the context for which Template:HiddenMultiLine was originally designed (chess diagrams):

General notes

 * 1) It seems impossible to make the "show"/"hide" link bold.