Template:Fixcaps/doc

The Template:Fixcaps sets the lowercase or capital-letter format of each word (or phrase) in a slash-encoded title, as with a book or film title.
 * Usage: &rarr;
 * {&#123;fixcaps|JOHN/DOE,/"/PROPER/PUNCTUATION/OF/TITLES"}} &rarr;
 * {&#123;fixcaps|SHOW| wikilinked |+TEXT.}} &rarr; Show wikilinked text.
 * {&#123;subst:fixcaps|"/SAVE/INSIDE/PAGE"}} &rarr; "Save&#32;Inside&#32;Page"&#32;

Most words will be displayed with a capital-letter, followed by all lowercase letters, while a preposition or article (a/an/the) will be shown in lowercase letters. A leading "+" forces lowercase. A leading caret symbol ("^") will cause the text to display unchanged, so "^woRDs" would show "woRDs". Prepositions include: about, above, after, at, before, by, for, in, of, on, with and without. Each word to capitalize must be preceded by a slash ("/"), but all spaces could be slashes, and prepositions would still display in lowercase letters. Only 25 slashes are allowed in each parameter, or about 40-45 words (2 lines of text) per parameter, and a wikilink must be in a separate parameter, not embedded inside other text (see below: Limitations). A total of 8 parameters are allowed, or about 320-360 words.

The resulting text, with mixed capital and lowercase letters, can be wp:Subst'ed into the page during edit SAVE, or copy-pasted back into the text, using the template as an editing gadget.

An extra space is added at the end of each slashed part except after a single quotation mark, left parenthesis, em dash, or apostrophes ( ''' ).

Examples
The following are some other examples:
 * &rarr;


 * &rarr;


 * &rarr;

A major use for the template would be in reformatting long lists of book titles entered as ALL-CAPS text, while inserting formatting codes for italics, footnotes or bolded volume numbers. Occasionally, entire sections or paragraphs of an article might contain ALL UPPERCASE TEXT, and the template can be used to more easily downcase all the improperly formatted text.

&rarr;


 * &rarr;

Just inserting a few slashes into the text, such as at the start of sentences and town names, and putting wikilinks as separate lowercase parameters, can easily salvage a whole paragraph of caps-only text, within 1 minute. Wikilinks are NOT allowed embedded within the text, only as separate parameters (each in vertical bars "&#124; link &#124;").

Limitations
Fixcaps is limited by restrictions set in the MediaWiki software, version, of about 40-45 words (255 characters, or about 2 lines of text) in each of the 8 parameters. Wikilinks must be separate parameters in bars( |Link| ), not embedded within the text, or else put between 2 {&#123;fixcaps}} around a wikilink; otherwise, an embedded wikilink will repeat 25 times. The encoding of the text is limited to 25 slashes in each parameter, and the enclosed text cannot display slashes, except using a slash-backslash-slash ("/\/") to display a forward slash. A total of eight (8) parameters are allowed, to handle 320-360 words or about 16 lines. For larger sections, use multiple {&#123;fixcaps}} to handle 700 or more words, or for each 16 lines of text.

Special conditions:
 * forcing lowercase letters - put "+" after slash ("/+LOWERS") to force text as "lowers"
 * forcing uppercase letters - put "^" after slash ("/^eXacT") to force as exact case "eXacT"
 * cannot split wikilinks      - invalid: "text||LINKED TEXT|+more"
 * 40-word parameters      - use multiple parameters for each 40 words
 * maximum 8 parameters - use multiple {&#123;fixcaps}} for longer text
 * using wp:Subst  - use {&#123;subst:fixcaps}} to store results upon SAVE of edit.

Any other character after the slash will cause the text to have all lowercase letters.