Template:Sourceheader/doc

From Pensapedia, the Pensacola encyclopedia
Revision as of 16:44, 21 September 2009 by Admin (talk | contribs) (JavaScript extraction)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

<section begin="Usage" />

{{sourceheader
 | title      = 
 | author     = 
 | year       = 
 | translator = 
 | section    = 
 | previous   = 
 | next       = 
 | notes      = 
}}

<section end="Usage" />

This template is meant to be used at the top of an article. Fill in any relevant information, and leave unknown or inapplicable parameters empty. Don't remove unused parameters, as this will break the template and make bot maintenance difficult.

Documentation

Relative links

With lengthy, multi-page works, using relative links is highly recommended. This shortens the code and ensures that a work remains linked together even if it is moved or reorganised. The three formats are [[/subpage]] (subpage), [[../]] (parent), and [[../sibling]] (sibling); see the example usage below. Note that [[../]] will expand to the title of the parent page, which is ideal if the work is renamed at a later time.

This depends on a page conforming to the page title standards in the naming conventions, with works in the form [[Work title]] and [[Work title/Subpage]].

Chapter titles

In general, include chapter titles in the "section" field, but avoid including them in the "previous" and "next" fields. For example:

How the Other Half Lives by Jacob Riis
Chapter XI: The Sweaters of Jewtown


Special cases

Translations

 |translator=Joe

The name of the translator. This will automatically be linked to an author page unless it contains the "[" character.

(A value of "?" or "unknown" adds {{No translator info}} to the page.)

(A value of "not mentioned" adds translator not mentioned to the page.)

No link to author page

| author= |override_author=Joe

Displays the author's name without a link to an author page (for works that don't have traditional authors).

Usage examples

Normal

{{sourceheader
 | title    = [[../]]
 | author   = Lewis Carroll
 | section  = Chapter 3: A Caucus-Race and a Long Tale
 | previous = [[../Chapter 2|Chapter 2]]
 | next     = [[../Chapter 4|Chapter 4]]
 | notes    =
}}
Alice's Adventures in Wonderland by Lewis Carroll
Chapter 3: A Caucus-Race and a Long Tale


No author link

{{sourceheader
 | title    = Peerage Act 1963
 | author   = |override_author= the United Kingdom Parliament
 | section  =
 | previous =
 | next     =
 | notes    =
}}
Peerage Act 1963
the United Kingdom Parliament


Translation

{{sourceheader
 | title    = Fables
 | author   = Jean de La Fontaine
 | translator= Elizur Wright
 | section  =
 | previous =
 | next     =
 | notes    =
}}
{{sourceheader
 | title    = Pantagruel
 | author   = François Rabelais
 | translator= [[Author:Thomas Urquhart|]] and [[Author:Peter Antony Motteux|]]
 | section  =
 | previous =
 | next     =
 | notes    =
}}
Fables
by Jean de La Fontaine , translated by Elizur Wright


Pantagruel
by François Rabelais , translated by Thomas Urquhart and Peter Antony Motteux


Advanced manipulation

JavaScript extraction

The header values can be extracted using JavaScript by accessing the text values of their span wrappers:

value wrapper id
title header_title_text
author header_author_text
translator header_translator_text
previous headerprevious
next headernext
notes none