Template:Citation Style documentation
When updating this template keep in mind that it is used on a number of template documentation pages. If the parameters in question are unique to a template, then either add it manually to the template documentation or create a new section here for transclusion. |
Contents
- 1 Usage
- 2 Section usage
- 3 Lead section
- 4 Usage section
- 5 Examples section
- 6 Parameters section
- 6.1 syntax
- 6.2 coins
- 6.3 sep_period
- 6.4 sep_comma
- 6.5 required
- 6.6 deprecated
- 6.7 author
- 6.8 editor
- 6.9 title
- 6.10 web
- 6.11 chapter
- 6.12 type
- 6.13 journal
- 6.14 edition
- 6.15 series
- 6.16 series_episode
- 6.17 event
- 6.18 agency
- 6.19 volume
- 6.20 date
- 6.21 publisher
- 6.22 newsgroup
- 6.23 language
- 6.24 pages
- 6.25 time
- 6.26 id1
- 6.27 id2
- 6.28 url
- 6.29 chapterurl
- 6.30 lay
- 6.31 quote
- 6.32 ref
- 6.33 ref2
- 6.34 display
- 6.35 map_series
- 6.36 map_id
- 6.37 map_pages
- 6.38 interview_id
- 6.39 interview_author
- 6.40 interview_interviewer
- 6.41 album_name
- 6.42 album_artist
- 6.43 season
- 6.44 network
- 6.45 transcript
- 6.46 notestitle
- 6.47 conference
- 7 See also
Usage[edit]
This template is used to build consistent documentation pages for Citation Style 1 templates.
- For example:
{{Citation Style documentation|author}}
will show the author documentation.
Where a particular section of documentation is not appropriate for a certain template, simply add the text manually or create a new subtemplate.
Each module of text is a subtemplate that can be edited using the link.
Section usage[edit]
When creating template documentation, use the following order of sections and content:
- Lead: a brief overview of the template intent
- Usage: samples of blank parameters that can be copied and pasted
- Examples: examples of various usage
- Parameters: detailed descriptions of each parameter
- Syntax: overview of the template syntax
- Deprecated: list of deprecated parameters
- Description: parameter descriptions separated by function in this general order:
- Authors
- Title
- Date
- Publisher
- Edition, series, volume
- In-source locations
- URL
- Anchor
- Identifiers
- Quote
- Editors
- Laysummary
- Display options
Lead section[edit]
Use {{csdoc|lead|content}}
to create consistent content for the lead:
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
Markup | Renders as |
---|---|
[markup] |
[rendering] |
Lua notice[edit]
Template:Citation Style documentation/edit
Usage section[edit]
Start the usage section with {{csdoc|usage}}
:
Parameters to copy are enclosed in tables created by sub-templates.
Full horizontal style[edit]
- Start with
{{csdoc|usage full}}
- Precede the sample markup with
:
to create an indent - Enclose the sample in
<code><code class="nowrap" style=""><nowiki>...</nowiki>
</code></code> - Close the table with
{{end}}
{{csdoc|usage full}} :<code><nowiki>{{cite book |last1= |first1= |authorlink1= |last2= |first2= |authorlink2= |editor1-first= |editor1-last= |editor1-link= |others= |title= |trans_title= |url= |archiveurl= |archivedate= |format= |accessdate= |type= |edition= |series= |volume= |date= |year= |month= |origyear= |publisher= |location= |language= |isbn= |oclc= |doi= |id= |page= |pages= |at= |trans_chapter= |chapter= |chapterurl= |quote= |ref= |bibcode= |laysummary= |laydate= |author-mask= |author-name-separator= |author-separator= |display-authors= |separator= |postscript= |lastauthoramp=}}</nowiki></code> {{end}}
Template:Citation Style documentation/usage full
{{cite book |last1= |first1= |authorlink1= |last2= |first2= |authorlink2= |editor1-first= |editor1-last= |editor1-link= |others= |title= |trans_title= |url= |archiveurl= |archivedate= |format= |accessdate= |type= |edition= |series= |volume= |date= |year= |month= |origyear= |publisher= |location= |language= |isbn= |oclc= |doi= |id= |page= |pages= |at= |trans_chapter= |chapter= |chapterurl= |quote= |ref= |bibcode= |laysummary= |laydate= |author-mask= |author-name-separator= |author-separator= |display-authors= |separator= |postscript= |lastauthoramp=}}
Most commonly used horizontal style[edit]
- Start with
{{csdoc|usage common}}
- Precede the sample markup with
:
to create an indent - Enclose the sample in
<code><code class="nowrap" style=""><nowiki>...</nowiki>
</code></code> - Close the table with
{{end}}
{{csdoc|usage common}} :<code><nowiki>{{cite book |last= |first= |authorlink= |title= |url= |accessdate= |year= |publisher= |location= |isbn= |page= |pages=}}</nowiki></code> {{end}}
Template:Citation Style documentation/usage common
{{cite book |last= |first= |authorlink= |title= |url= |accessdate= |year= |publisher= |location= |isbn= |page= |pages=}}
Full vertical style[edit]
The full vertical style is created in three columns: Vertical list, Prerequisites and Brief instructions / notes.
- Start with:
{{csdoc|usage vertical}} <pre style="margin:0px;">
- Create the vertical list column
- Separate the next column with:
</pre> {{csdoc|usage vertical mid}} <pre style="margin:0px;">
- Create the prerequisites column; blank lines must include a
- Separate the next column with:
</pre> {{csdoc|usage vertical mid}} <pre style="margin:0px;">
- Create the instructions column; blank lines must include a
- End with:
</pre> {{csdoc|usage vertical end}}
Example:
{{csdoc|usage vertical}} <pre style="margin:0px;"> {{cite book | last = | first = | authorlink = }} </pre> {{csdoc|usage vertical mid}} <pre style="margin:0px;"> last </pre> {{csdoc|usage vertical mid}} <pre style="margin:0px;"> same as last1 same as first1 </pre> {{csdoc|usage vertical end}}
Template:Citation Style documentation/usage vertical
{{cite book | last = | first = | authorlink = }}
Template:Citation Style documentation/usage vertical mid
last
Template:Citation Style documentation/usage vertical mid
same as last1 same as first1
Template:Citation Style documentation/usage vertical end
Sub-templates[edit]
Usage[edit]
Template:Citation Style documentation/edit Template:End
Usage full[edit]
Template:Citation Style documentation/edit Template:End
Usage common[edit]
Template:Citation Style documentation/edit Template:End
Usage vertical[edit]
Template:Citation Style documentation/edit Template:End
Usage vertical mid[edit]
Template:Citation Style documentation/edit Template:End
Usage vertical end[edit]
Template:Citation Style documentation/edit
Examples section[edit]
When creating examples, use these styles for consistency:
- A title before the example, formatted in bold by the use of
'''
- The sample markup for the example: preceded by
*
to create a bullet, then the markup enclosed in<code><code class="nowrap" style=""><nowiki>...</nowiki>
</code></code> - The live markup: preceded by
:
to create an indent
Markup | Renders as |
---|---|
[markup] |
[rendering] |
Parameters section[edit]
syntax[edit]
Template:Citation Style documentation/edit
coins[edit]
Template:Citation Style documentation/edit
sep_period[edit]
Template:Citation Style documentation/edit
sep_comma[edit]
Template:Citation Style documentation/edit
required[edit]
Template:Citation Style documentation/edit
deprecated[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
author[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
editor[edit]
Template:Citation Style documentation/edit
title[edit]
Template:Citation Style documentation/edit
Template:Citation Style documentation/opt
web[edit]
Template:Citation Style documentation/edit
chapter[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
type[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
journal[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
edition[edit]
Template:Citation Style documentation/edit
series[edit]
Template:Citation Style documentation/edit
series_episode[edit]
Template:Citation Style documentation/edit
event[edit]
Template:Citation Style documentation/edit
agency[edit]
Template:Citation Style documentation/edit
volume[edit]
Template:Citation Style documentation/edit
date[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
publisher[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
newsgroup[edit]
Template:Citation Style documentation/edit
language[edit]
Template:Citation Style documentation/edit
pages[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
time[edit]
Template:Citation Style documentation/edit
id1[edit]
Template:Citation Style documentation/edit
id2[edit]
Template:Citation Style documentation/edit
url[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
chapterurl[edit]
Template:Citation Style documentation/edit
lay[edit]
Template:Citation Style documentation/edit
quote[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
ref[edit]
Template:Citation Style documentation/edit
ref2[edit]
Template:Citation Style documentation/edit
display[edit]
Template:Citation Style documentation/edit Template:Citation Style documentation/opt
map_series[edit]
Template:Citation Style documentation/edit
map_id[edit]
Template:Citation Style documentation/edit
map_pages[edit]
Template:Citation Style documentation/edit
interview_id[edit]
Template:Citation Style documentation/edit
interview_author[edit]
Template:Citation Style documentation/edit
interview_interviewer[edit]
Template:Citation Style documentation/edit
album_name[edit]
Template:Citation Style documentation/edit
album_artist[edit]
Template:Citation Style documentation/edit
season[edit]
Template:Citation Style documentation/edit
network[edit]
Template:Citation Style documentation/edit
transcript[edit]
Template:Citation Style documentation/edit
notestitle[edit]
Template:Citation Style documentation/edit
conference[edit]
Template:Citation Style documentation/edit
See also[edit]
The above documentation is transcluded from Template:Citation Style documentation/doc. (edit | history) Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages. Please add categories to the /doc subpage. Subpages of this template. |