Template:Refbegin/doc

<!--

refbegin and its complementary closing template refend are used to apply any of several optional styles or presentational choices for bibliographies or reference lists—that is, lists of fully-specified references, sources, or works cited, sorted alphabetically by author or contributor) that appear in Wikipedia articles.

These bibliographies or reference lists frequently appear in dedicated sections within an article, variously titled,  ,  ,  ,  , and so on.

Wikipedia referencing or citation systems that use bibliography-style reference lists include: 'shortened' footnotes, parenthetical referencing, and 'general' referencing. The 'full' footnote and embedded citations referencing systems do not use those lists, although articles using these latter two systems may also contain "Further reading" or other sections containing bibliography-style listings, that refbegin formatting could be applied to.

The formatting options provided by this template are: Each use of refbegin, with or without parameters, needs an accompanying refend closing template to 'turn off' the formatting; refend does not need any parameters.

Font size reduction is applied by default. Either one, the other, or both of multi-columns and hanging indent may be applied as well (though see specifics and caveats on browser differences in relevant sections, below).

Usage
This template is used only for references—it should not be used to create lists of text which are smaller, in columns, or which have other style data associated with them.

With all (optional) parameters shown:

Placement
The refbegin is placed immediately below the header of the bibliography/references section its formatting will be applied to. The closing refend template is placed within the same section, at the end of the bibliography/references list content.

When used, each occurrence of refbegin should always be paired with a corresponding closing refend template:

Option 1: Default behaviour
The default usage (without parameters) applies a style that reduces the text size of the bibliographies/reference list entries. This can be useful to make a long bibliography/list of references display more compactly, and it also mimics the formatting style applied to footnotes by the template.

The formats footnotes—any text in the article body that is placed between ref tags—that are auto-generated by the cite.php extension, called by. In the case of articles using the 'shortened' footnotes referencing system, these footnotes will typically contain an abbreviated citation such as p that corresponds with an entry in the bibliography/references list section (other text such as discursive notes may appear as well).

The font size is set to 90% in the corresponding TemplateStyles page.

If the 'full' footnotes referencing system is used (i.e. there is no separate bibliography/references list, all cites/references are defined in  tags), then use reflist alone:

Option 2: Multiple columns
If a value with a unit is supplied as the first parameter, i.e., the template will display the bibliography/references list in columns with a minimum width of that value, allowing the browser to determine the optimal number of columns. Using for instance is useful for short citations. If no parameter is specified, the default is a single column.

{{pre|

Browser support
Multiple columns are generated by using CSS3. See here for more information.

Option 3: Hanging indentation
A hanging indentation may be applied to bibliographies/reference lists by using the indent parameter. This option can be useful in long bibliographies/reference lists and in particular when individual entries in the list are long, i.e. they wrap over more than one line in the browser display window. Applying a hanging indent to the list makes it much easier to distinguish the keywords (i.e. normally the authors' names) in the bibliography and makes them stand out from preceding and succeeding lines of text. Hanging indents in bibliographies also form part of several widely used citation style implementations, such as APA, MLA, and Chicago.

To use, set.