Template:Cite map

[edit] [purge] Template documentation

This template employs intricate features of template syntax. You are encouraged to familiarise yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. Remember that you can conduct experiments, and should test all improvements, in either the local /sandbox or your user space before changing anything here.

Notes

This template is used to cite sources in Wikipedia, specifically maps and related products.

There are also:

• {{Bing maps}}
• {{Google maps}}
• {{Yahoo maps}}

for citing those specific mapping services.

Usage

Copy one of these three blank versions to use. Note that all fields must be lowercase, and remember to use the "|" (pipe) character between each field. Please delete any unused fields to avoid clutter in the edit window.

Horizontal list
{{cite map |publisher= |title= |url= |trans_title= |language= |format= |edition= |year= |cartography= |scale= |series= |page= |section= |inset= |accessdate=2011-11-22 |isbn= |id= |ref= |archiveurl= |archivedate=}}
Horizontal list (without current date)
{{cite map |publisher= |title= |url= |trans_title= |language= |format= |edition= |date= |year= |cartography= |scale= |series= |page= |pages= |section= |inset= |accessdate= |isbn= |id= |ref= |archiveurl= |archivedate=}}

Vertical list	Prerequisites *
{{cite map |publisher = |title = |url = |trans_title= |language= |format = |edition = |date = |year = |cartography= |scale = |series = |page = |pages = |section = |inset = |accessdate = |isbn = |id = |ref = |archiveurl= |archivedate= }}	REQUIRED REQUIRED Use date or year, not both.

*	The field listed below is a prerequisite for the field to the left. For example title is a prerequisite to url meaning url will NOT be displayed even if it has a value unless title also has a value.

Fields

Wikilinks

Except where specifically prohibited in the parameter descriptions below, most parameters can be wikilinked (e.g. title = [[book article|book title]]), but should generally only be linked to an existing Wikipedia article. Wikilinked parameters must escape the characters <>[]{} rather than including them directly.

Description of parameters

Syntax (for the technical-minded)

Nested parameters rely on their parent parameters:

• parent
• OR: parent2—may be used instead of parent
  • child—may be used with parent (and is ignored if parent is not used)
  • OR: child2—may be used instead of child (and is ignored if parent2 is not used)

Description

• last: Surname of author. Do not wikilink (use authorlink instead).
  • first: Given or first name(s) of author, including title(s) (e.g. Firstname Middlename or Firstname M. or Dr. Firstname M., Snr.). Do not wikilink (use authorlink instead).
    • The 'last' and 'first' parameters are not ideally suited to authors whose surname is usually written first (e.g. as in Chinese). Use the same format as the source uses to handle these cases.
  • authorlink: Title of Wikipedia article about author (not the author's personal website). Article should already exist. Must not be wikilinked itself. Do not use this on its own, but along with author or first and last.
  • coauthors: Full name of additional author or authors, separated by ", " (e.g. Joe Bloggs, John F. Kennedy, H. R. Dent).
• For multiple authors, use the parameters first1, last1, ...,firstn, lastn to 'correctly' record all the information about the document (the first nine authors are printed, then et al. is appended if even more authors were specified). Do not wikilink as there are corresponding authorlink1, ..., authorlink9 parameters as well. This usage is preferred to the use of coauthors.
• editor: Name of editor/editors; not usually used for a map, but supported. Do not Wikilink any values in the editor parameter but use editor-link instead. The template automatically adds "ed." after the editor's name unless the chapter parameter is used in which case the template adds "in" before the editor's name which appears after the chapter and before the title. This implies that the author is responsible only for part of the document (including the cited chapter) and the editor responsible for the whole document. If, however, the author(s) and editor(s) are responsible for the whole document, then the editor parameter or its alternates described below should not be used if the chapter parameter is being used. Instead, the editor(s) should be included in an author parameter with possibly "(ed.)" after the surname(s). Alternatively, the editor parameter may be used if the chapter detail is included in the title parameter instead of using the chapter parameter.
• OR: alternatively editor-first and editor-last can be used in the same way as first and last.
• OR: for multiple editors up to four in number, use the parameters editor1-first, editor1-last, ...,editorn-first, editorn-last to 'correctly' record all the information about the document in the same way as firstn and lastn.
  • editor-link or editor1-link...editorn-link is used in the same way as authorlink or authorlinkn.
• others: To record other contributors to the work, such as "Illustrated by Smith" or "Trans. Smith".
• title: Title of map. This is the only required parameter. Can be wikilinked but only to an existing Wikipedia article. Do not use italics.
  • trans_title: If the map cited is in a foreign language, an English translation of the title can be given here. The template will display this in square brackets after the title parameter and it will point to the url link, if used. Use of language parameter is recommended if this parameter is used.
• url: URL of an online location where map can be found. Cannot be used if you wikilinked title. If applicable, should point to the specific page(s) referenced.
  • format: Format, e.g. PDF. HTML implied if not specified.
  • accessdate: Full date when url was accessed. Should be used when url parameter is used. Should be in the same format as other dates in citations in the same article. Must not be wikilinked.
• archive parameters (if used, both must be provided)
  • archiveurl: The URL of an archived copy of a web page, if (or in case) the url becomes unavailable. Typically used to refer to services like WebCite and Archive.org.
  • archivedate: Date when the item was archived. Should not be wikilinked.
• type: An optional parameter which can be used to provide additional information about a document type. Defaults to Map in parenthesis.
• edition: When the map has more than one edition. e.g.: "2nd.", "Revised" etc.. Note that the template automatically displays " ed." after this parameter, so edition=2nd produces "2nd ed.".
• series: When the map is part of a series of publications.
• volume: For one map set published in several volumes. However, this template displays the text in this parameter in bold type after the title and series parameters. An alternative is to include the volume information in the title parameter after the main title (see example below).
• publisher: Publisher should not include corporate designation such as "Ltd" or "Inc".
  • location: Geographical place of publication.
• language: The language the map is written in, if it is not English. The template automatically puts parentheses around the text and adds "in" before the language name.
• isbn: International Standard Book Number such as 1-111-22222-9. Note that |isbn=, like all parameter names, must be in lowercase. The parameter must not be wikilinked as the template automatically creates a link. The template is insensitive to formatting so an ISBN number without dashes ("-") may be used (e.g. |isbn=1111222229), though ISBNs with correctly formatted dashes are preferred (see Wikipedia:ISBN and ISBN). Please use the 13-digit ISBN where possible; this can normally be found beneath the barcode as a number beginning 978 or 979. For documents with the older SBN system (9 digits), use this parameter but prefix the number with a zero; thus SBN 902888-45-5 should be entered as |isbn=0-902888-45-5. More information about this feature and its advantages is available at Wikipedia:ISBN.
• oclc: Online Computer Library Center ID number, such as 3185581. The parameter must not be wikilinked as the template automatically creates a link.
• doi: A digital object identifier such as 10.1016/j.coi.2004.08.001. The parameter must not be wikilinked as the template automatically creates a link.
  • doi_brokendate: The date that a digital object identifier link was found to be broken.
• bibcode: A nineteen character Bibcode identifier. The parameter must not be wikilinked as the template automatically creates a link.
• Several other parameters are available for catalogue or other identifying numbers; these include |arxiv=, |asin=, |issn= (International Standard Serial Number), |jfm=, |jstor=, |lccn=, |mr=, |ol= (Open Library), |osti=, |pmc=, |pmid=, |rfc=, |ssrn= and |zbl=.
• id: A unique identifier, used if none of the above are applicable. In this case, you need to specify the kind of identifier you are using, preferably with a template like {{ASIN}} or {{ISSN}}. (Use one of the more specialized parameters if possible; they are linked automatically. In other words, do not use |id=ISBN 1-111-22222-9 anymore; use |isbn=1-111-22222-9. If the document has a SBN but not an ISBN, see |isbn=.)
• section: The map coordinate of the feature being referenced (e.g. 6A, 9B, 11L, etc).
• inset: The name of the small focused inset being referenced (Downtown Fooburg, etc).
• pages or page: These parameters are for listing the pages relevant to the citation, not the total number of pages in the map. "|pages= 5–7" produces "pp. 5–7", while "|page= 5" produces "p. 5". The "pp." notation indicating multiple pages, and "p." notation indicating a single page, are placed automatically when you choose between the plural (pages) or singular (page) form of the parameter. Page ranges should be separated by an unspaced en dash (–).
  • nopp: using "page" or "pages", automatically places the p. or pp. notations. If this is inappropriate—for instance, if page=Front cover, placing any value after nopp (e.g. nopp=y will hide the p. or pp. notation.
• quote: Relevant quote from the document. Should not be excessive in length: More than a few sentences is rarely needed, and if needed then the Wikipedia article's prose should probably more adequately address the topic and/or quote the material directly, e.g. with {{quote}}. The template will automatically provide quotation marks, but not a terminal period/full stop (or diaeresis as appropriate), nor initial capitalization, both of which should be added manually. Example:

  |quote=[I]t was not only competition, but the introduction of new techniques that drew spectators to the events...

• ref: ID for anchor. By default, no anchor is generated. The ordinary nonempty value |ref=ID generates an anchor with the given ID; such a linkable reference can be made the target of wikilinks to full references, especially useful in short citations like shortened notes and parenthetical referencing. The special value |ref=harv generates an anchor suitable for the {{harv}} template; see anchors for Harvard referencing templates. See "Wikilinks to full references" in Examples below for using the ref parameter in citation templates in conjunction with short <ref>...</ref> citations.
• laysummary: Link to a non-technical summary (or review) of the document
  • laydate: Date of summary
• separator: The separator to use in lists of authors, editors, etc. Defaults to ".", but "," may be useful also. If the parameter is present, but blank, no separator will be used.
• author-separator: Parameter allowing punctuation style to be altered
• author-name-separator: Parameter allowing punctuation style to be altered
• display-authors: By default, the number of authors displayed is limited to 8; if 9 are provided, the ninth is displayed as "et al.". This parameter allows display of fewer authors before the "et al." (e.g., |display-authors=2); alternatively, the "et al." may be suppressed by the use of |display-authors=9.
• postscript: The closing punctuation for the citation. If specified, over-rides the default behaviour of terminating the citation with a full stop. If the parameter is present, but blank, no terminating punctuation will be used. This may be useful when generating an output consistent with other templates. It is preferred to manually adding ending punctuation, as the punctuation occurs within the <cite> tag, so will appear before any icons added by browser plugins. Ignored if |quote= is specified.
• lastauthoramp: The separator to use between the last two names in lists of authors. Defaults to "", but "&" may be useful as well.

Examples

1. {{Cite map | publisher = Skelly Oil Company | title = Highway Map of Oklahoma | cartography = Diversified Map Co | year = 1966 | section = 11C }}
   • Skelly Oil Company (1966). Highway Map of Oklahoma (Map). Cartography by Diversified Map Co. Section 11C. 
2. {{Cite map | publisher = Rand McNally | title = Discovery Atlas of the United States | year = 1993 | page = 7 | section = 7G }}
   • Rand McNally (1993). Discovery Atlas of the United States (Map). p. 7, section 7G. 
3. {{Cite map | publisher = Stanley Maps | title = Mt. Rainier National Park | scale = 1 : 30,000 | year = 2000 | edition = Centennial | cartography = Charles B. Kitterman / Kulshan Cartographic Services | isbn = 0-9662209-4-3 }}
   • Stanley Maps (2000). Mt. Rainier National Park (Map). 1 : 30,000. Cartography by Charles B. Kitterman / Kulshan Cartographic Services (Centennial ed.). ISBN 0-9662209-4-3. 
4. {{Cite map | publisher = Kansas Department of Transportation | title = Official State Transportation Map | url = http://www.ksdot.org/burtransplan/maps/state-pdf/kansas0708.pdf | edition = 2005-2006 | section = F9 | accessdate = 2007-03-30 }}
   • Kansas Department of Transportation. Official State Transportation Map (Map) (2005-2006 ed.). Section F9. http://www.ksdot.org/burtransplan/maps/state-pdf/kansas0708.pdf. Retrieved 2007-03-30. 
5. {{Cite map | publisher = [[New Zealand Department of Conservation]] | title = Kepker Track | series = Parkmap | scale = 1 : 50,000 | edition = 3rd | year = 2003 | cartography = GeoSmart (NZ) Ltd }}
   • New Zealand Department of Conservation (2003). Kepker Track (Map). 1 : 60,000. Parkmap. Cartography by GeoSmart (NZ) Ltd (3rd ed.). 
6. {{Cite map | publisher = [[Ordnance Survey Ireland]] | title = Kerry | series = Discovery Series | scale = 1 : 60,000 | edition = 2nd | year = 2000 | isbn = 1-901496-59-7 }}
   • Ordnance Survey Ireland (2000). Kerry (Map). 1 : 50,000. Discovery Series (2nd ed.). ISBN 1-901496-59-7. 
7. {{Cite map | publisher = [[United States Geological Survey]] | title = Mount Adams East Quadrangle - Washington - Yakima Co. | year = 1998 | scale = 1 : 24,000 | series = 7,5 Minute Series (Topographic) | isbn = 0-607-92088-2 }}
   • United States Geological Survey (1998). Mount Adams East Quadrangle - Washington - Yakima Co. (Map). 1 : 24,000. 7,5 Minute Series (Topographic). ISBN 0-607-92088-2. 

The above documentation is transcluded from Template:Cite map/doc. (edit | history) Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages. Please add categories and interwikis to the /doc subpage. Subpages of this template.