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.

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.

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

A gallery added as a section in another gallery will have the default 5 columns, regardless of the columns set in either gallery (Example).