Template:Portrait Gallery/doc

Description
This template is used to make portrait galleries.

This template uses File:NoPicAvailable.png, as well as several subtemplates.
 * Dependencies

Syntax
The template works is to be called as follows:

The "portrait code" is peculiar. It consists of three parts, separated by backslashes ("\"). For example, Caesar \ Caesar Clown Marine Portrait.png \ Caesar Clown is a portrait code.
 * The first part is the text that is to be showed below the portrait.
 * The second part is the name of the portrait picture (without link brackets or "File:"). It is optional: if it is not present, it is taken to be "XXX Portrait.png", with "XXX" being the text in the third part. Also, there is a special "NOPIC" value: it uses File:NoPicAvailable.png.
 * The third part is the name of the page the portrait and text link to. It is optional: if it is not present, it is taken to be the same as the text (excluding parentheses). Also, there is a special "NOLINK" value, for cases when the portrait should not link to any page.

The title and colorscheme are self-explanatory. The template parameter should be given the name of the template page (warning:  does not work!); if present, it allows the gallery to feature template links on the left of the title.

Examples
The following code

gives the following result:

An example with many differents cases, with comments:

An example with only one portrait:

Colors
It is not always possible to use a colorscheme; to use custom colors, there are parameters textcolor and backcolor.

Galleries with Sections
Sometimes, one needs to make sections in a portrait gallery. This can be done by joining several galleries together, thanks to the multi parameter. The section parameter is a shortcut: section=XXX is the same as multi=section|title=XXX. Here is an example of gallery with sections:
 * Use multi=header to start a gallery.
 * Use multi=section to make a section.
 * Use multi=footer to end the gallery.

Galleries used as Sections in Other Galleries
Sometimes, galleries are used as sections in bigger galleries (such as in Template:Marines Gallery). To allow for a gallery to be included in another, one needs to add the following little code snippet:. It must be added as a parameter. The following example is the code for Template:Macro Pirates Gallery:

Now we can include this template as a section in another gallery, using parameter included=yes:

In order to do the same for galleries that already have several sections, add the snippet in both the header and footer. Here is a simple example:

Putting this in "Template:Foobar Gallery", for example, we can include it in another gallery, exactly as a single-section template, by using.

To modify the number of columns in a gallery that is included in another, see below

Number of Columns
The default layout uses 5 columns. It is also possible to use 2, 3, or 4 if needed, thanks to the cols parameter, which must be added to every section. Note that if there are less than 5 portraits in a gallery, leaving the default works anyway.

Number of Columns in Included Galleries
Galleries included in other galleries won't respect the existing column number, instead using the default of 5 columns. However, this can be modified by adding  in the gallery to be included, similar as the   parameter defined above. The  can be set to any acceptable gallery column value, and will be used if the number of columns isn't specified in the gallery's inclusion in other templates.

To specify a custom number of columns in other galleries, simply specify a custom value for, the same as any other parameter.

Limitations
Each section is limited to 100 portraits. The number of columns is 2, 3, 4, or 5, with 5 the default.