Jump to content

ထႅမ်းပလဵတ်ႉ:Citation Style documentation/doc

လုၵ်ႉတီႈ ဝီႇၶီႇၽီးတီးယႃး ဢၼ်လွတ်ႈလႅဝ်းထၢင်ႇႁၢင်ႈ ၼၼ်ႉမႃး

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.

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
      • Lay summary
      • Display options

Use {{csdoc|lead|content}} to create consistent content for the lead:

[edit subtemplate]

This Citation Style 1 template is used to create citations for .

Options for this field: One unnamed parameter is used to create the trailing text.

MarkupRenders as
{{csdoc|lead|books}}

This Citation Style 1 template is used to create citations for books.

[edit subtemplate]

Start the usage section with {{csdoc|usage}}:

Copy a blank version to use. Almost all parameter names are supported only in lower case (some initialisms, such as |isbn= have upper-case aliases like |ISBN=, which are acceptable for use). Use the "|" (pipe) character between each parameter. Unused parameters may be deleted to avoid clutter in the edit window. Some samples on this documentation page may include the current date. If the date is not current, then purge the page.

Parameters to copy are enclosed in tables created by sub-templates.

  • Start with {{csdoc|usage full}}
  • Precede the sample markup with : to create an indent
  • Enclose the sample in <code><nowiki>...</nowiki></code>
  • Close the table with {{end}}

{{csdoc|usage full}}
:<code><nowiki>{{cite xxxxx |last1= |first1= |author-link1= |last2= |first2= |author-link2= |last3= |first3= |author-link3= |last4= |first4= |author-link4= |last5= |first5= |author-link5= |name-list-style= |vauthors= |translator-last1= |translator-first1= |translator-link1= |translator-last2= |translator-first2= |translator-link2= |collaboration= |contributor-last1= |contributor-first1= |contributor-link1= |contributor-last2= |contributor-first2= |contributor-link2= |others= |editor-last1= |editor-first1= |editor-link1= |editor-last2= |editor-first2= |editor-link2= |editor-last3= |editor-first3= |editor-link3= |veditors= |title= |script-title= |trans-title= |work= |script-work= |trans-work= |issue= |department= |chapter= |script-chapter= |trans-chapter= |contribution= |type= |edition= |series= |series-link= |episode= |event= |agency= |volume= |date= |year= |orig-date= |df= |publisher= |location= |publication-place= |via= |language= |page= |pages= |no-pp= |at= |minutes= |time= |time-caption= |id= |arxiv= |asin= |asin-tld= |bibcode= |biorxiv= |citeseerx= |doi= |doi-broken-date= |eissn= |hdl= |sbn= |isbn= |ismn= |issn= |jfm= |jstor= |lccn= |mr= |oclc= |ol= |osti= |pmc= |embargo= |pmid= |rfc= |ssrn= |zbl= |url= |format= |archive-url= |archive-format= |url-status= |archive-date= |chapter-url= |chapter-format= |lay-url= |lay-format= |lay-source= |lay-date= |access-date= |no-tracking= |quote= |ref= |mode= |author-mask1= |author-mask2= |author-mask3= |author-mask4= |author-mask5= |display-authors= |translator-mask1= |translator-mask2= |display-translators= |contributor-mask1= |contributor-mask2= |display-contributors= |editor-mask1= |editor-mask2= |editor-mask3= |display-editors= |postscript= |url-access= |chapter-url-access= |bibcode-access= |doi-access= |hdl-access= |jstor-access= |ol-access= |osti-access= |map= |script-map= |trans-map= |map-url= |map-format= |map-url-access= |scale= |cartography= |inset= |sections= |interviewer-last1= |interviewer-first1= |interviewer-link1= |interviewer-last2= |interviewer-first2= |interviewer-link2= |interviewer-mask1= |interviewer-mask2= |display-interviewers= |season= |series-number= |series-separator= |network= |station= |transcript= |transcript-url= |transcript-format= |conference= |conference-url= |conference-format=}}</nowiki></code>
{{end}}
Full parameter set in horizontal format
{{cite xxxxx |last1= |first1= |author-link1= |last2= |first2= |author-link2= |last3= |first3= |author-link3= |last4= |first4= |author-link4= |last5= |first5= |author-link5= |name-list-style= |vauthors= |translator-last1= |translator-first1= |translator-link1= |translator-last2= |translator-first2= |translator-link2= |collaboration= |contributor-last1= |contributor-first1= |contributor-link1= |contributor-last2= |contributor-first2= |contributor-link2= |others= |editor-last1= |editor-first1= |editor-link1= |editor-last2= |editor-first2= |editor-link2= |editor-last3= |editor-first3= |editor-link3= |veditors= |title= |script-title= |trans-title= |work= |script-work= |trans-work= |issue= |department= |chapter= |script-chapter= |trans-chapter= |contribution= |type= |edition= |series= |series-link= |episode= |event= |agency= |volume= |date= |year= |orig-date= |df= |publisher= |location= |publication-place= |via= |language= |page= |pages= |no-pp= |at= |minutes= |time= |time-caption= |id= |arxiv= |asin= |asin-tld= |bibcode= |biorxiv= |citeseerx= |doi= |doi-broken-date= |eissn= |hdl= |sbn= |isbn= |ismn= |issn= |jfm= |jstor= |lccn= |mr= |oclc= |ol= |osti= |pmc= |embargo= |pmid= |rfc= |ssrn= |zbl= |url= |format= |archive-url= |archive-format= |url-status= |archive-date= |chapter-url= |chapter-format= |lay-url= |lay-format= |lay-source= |lay-date= |access-date= |no-tracking= |quote= |ref= |mode= |author-mask1= |author-mask2= |author-mask3= |author-mask4= |author-mask5= |display-authors= |translator-mask1= |translator-mask2= |display-translators= |contributor-mask1= |contributor-mask2= |display-contributors= |editor-mask1= |editor-mask2= |editor-mask3= |display-editors= |postscript= |url-access= |chapter-url-access= |bibcode-access= |doi-access= |hdl-access= |jstor-access= |ol-access= |osti-access= |map= |script-map= |trans-map= |map-url= |map-format= |map-url-access= |scale= |cartography= |inset= |sections= |interviewer-last1= |interviewer-first1= |interviewer-link1= |interviewer-last2= |interviewer-first2= |interviewer-link2= |interviewer-mask1= |interviewer-mask2= |display-interviewers= |season= |series-number= |series-separator= |network= |station= |transcript= |transcript-url= |transcript-format= |conference= |conference-url= |conference-format=}}

The above set is organised contextually rather than alphabetically. The following parameters, which are usually available for at least a few cite templates, are not included in the full parameter set above: |authors=; |book-title=; |class=; |degree=; |docket=; |encyclopedia=; |mailing-list=; |message-id=; |number=; |publication-date=; |section=; |sheet=; |sheets=; |title-link=; |s2cid=.

Most commonly used horizontal style

[မႄးထတ်းငဝ်ႈငႃႇ]
  • Start with {{csdoc|usage common}}
  • Precede the sample markup with : to create an indent
  • Enclose the sample in <code><nowiki>...</nowiki></code>
  • Close the table with {{end}}

{{csdoc|usage common}}
:<code><nowiki>{{cite book |last= |first= |author-link= |title= |url= |access-date= |date= |publisher= |location= |isbn= |page= |pages=}}</nowiki></code>
{{end}}
Most commonly used parameters in horizontal format
{{cite book |last= |first= |author-link= |title= |url= |access-date= |date= |publisher= |location= |isbn= |page= |pages=}}

The full vertical style can be implemented in a three-columns format (only practical when the number of parameters is not too extended) or in a four-columns format.

The full vertical style in three columns consists of a "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 <code>&nbsp;</code>
* Separate the next column with:
-->
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
<!--
* Create the instructions column; blank lines must include a <code>&nbsp;</code>
* End with:
-->
</pre>
{{csdoc|usage vertical end}}

Example:

{{csdoc|usage vertical}}
<pre style="margin:0px;">
{{cite book
| last                  =
| first                 =
| author-link           =
}}
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
&nbsp;
last
&nbsp;
&nbsp;
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
same as last1
same as first1
&nbsp;
&nbsp;
</pre>
{{csdoc|usage vertical end}}
{{csdoc|usage vertical}}
<pre style="margin:0px;">
{{cite book
| last                  =
| first                 =
| author-link           =
}}
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
&nbsp;
last
&nbsp;
&nbsp;
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
same as last1
same as first1
&nbsp;
&nbsp;
{{csdoc|usage vertical end}}
{| class="wikitable"
|+ Full parameter set in vertical format
! Parameters !! Prerequisites !! Brief instructions / notes !! Vertical list
|-
| {{Hover title|or any of its aliases, including: last; author1; author; author-last1; author-last; (etc.)|last1}}
| 
| Author's last name or single name author. Don't link.
| rowspan="3" style="vertical-align:top;" | <pre style="margin:0px; border:none;">
{{cite xxxxx 
 |last1                =
 |first1               =
 |author-link1         =
}}
</pre>
|-
| {{Hover title|or any of its aliases, including: first; given1; given; author-first1; author-first; (etc.)|first1}}
| {{Hover title|or any of its aliases, including: last; author1; author; author-last1; author-last; (etc.)|last1}}
| Author's first name. Don't link.
|-
| {{Hover title|or any of its aliases, including: author-link; subject-link1; subject-link; (etc.)|author-link1}}
| {{Hover title|or any of its aliases, including: last; author1; author; author-last1; author-last; (etc.)|last1}}
| Title of Wikipedia article about the first author. Don't link.
|}
Full parameter set in vertical format
ParametersPrerequisitesBrief instructions / notesVertical list
last1 Author's last name or single name author. Don't link.
{{cite xxxxx 
 |last1                =
 |first1               =
 |author-link1         =
 |last2                =
 |first2               =
 |author-link2         =
 |last3                =
 |first3               =
 |author-link3         =
 |last4                =
 |first4               =
 |author-link4         =
 |last5                =
 |first5               =
 |author-link5         =
 |name-list-style      =
 |vauthors             =
 |translator-last1     =
 |translator-first1    =
 |translator-link1     =
 |translator-last2     =
 |translator-first2    =
 |translator-link2     =
 |collaboration        =
 |contributor-last1    =
 |contributor-first1   =
 |contributor-link1    =
 |contributor-last2    =
 |contributor-first2   =
 |contributor-link2    =
 |others               =
 |editor-last1         =
 |editor-first1        =
 |editor-link1         =
 |editor-last2         =
 |editor-first2        =
 |editor-link2         =
 |editor-last3         =
 |editor-first3        =
 |editor-link3         =
 |veditors             =
 |title                =
 |script-title         =
 |trans-title          =
 |work                 =
 |script-work          =
 |trans-work           =
 |issue                =
 |department           =
 |chapter              =
 |script-chapter       =
 |trans-chapter        =
 |contribution         =
 |type                 =
 |edition              =
 |series               =
 |series-link          =
 |episode              =
 |event                =
 |agency               =
 |volume               =
 |date                 =
 |year                 =
 |orig-date            =
 |df                   =
 |publisher            =
 |location             =
 |publication-place    =
 |via                  =
 |language             =
 |page                 =
 |pages                =
 |no-pp                =
 |at                   =
 |minutes              =
 |time                 =
 |time-caption         =
 |id                   =
 |arxiv                =
 |asin                 =
 |asin-tld             =
 |bibcode              =
 |biorxiv              =
 |citeseerx            =
 |doi                  =
 |doi-broken-date      =
 |eissn                =
 |hdl                  =
 |sbn                  =
 |isbn                 =
 |ismn                 =
 |issn                 =
 |jfm                  =
 |jstor                =
 |lccn                 =
 |mr                   =
 |oclc                 =
 |ol                   =
 |osti                 =
 |pmc                  =
 |embargo              =
 |pmid                 =
 |rfc                  =
 |ssrn                 =
 |zbl                  =
 |url                  =
 |format               =
 |archive-url          =
 |archive-format       =
 |url-status           =
 |archive-date         =
 |chapter-url          =
 |chapter-format       =
 |lay-url              =
 |lay-format           =
 |lay-source           =
 |lay-date             =
 |access-date          =
 |no-tracking          =
 |quote                =
 |ref                  =
 |mode                 =
 |author-mask1         =
 |author-mask2         =
 |author-mask3         =
 |author-mask4         =
 |author-mask5         =
 |display-authors      =
 |translator-mask1     =
 |translator-mask2     =
 |display-translators  =
 |contributor-mask1    =
 |contributor-mask2    =
 |display-contributors =
 |editor-mask1         =
 |editor-mask2         =
 |editor-mask3         =
 |display-editors      =
 |postscript           =
 |url-access           =
 |chapter-url-access   =
 |bibcode-access       =
 |doi-access           =
 |hdl-access           =
 |jstor-access         =
 |ol-access            =
 |osti-access          =
 |map                  =
 |script-map           =
 |trans-map            =
 |map-url              =
 |map-format           =
 |map-url-access       =
 |scale                =
 |cartography          =
 |inset                =
 |sections             =
 |interviewer-last1    =
 |interviewer-first1   =
 |interviewer-link1    =
 |interviewer-last2    =
 |interviewer-first2   =
 |interviewer-link2    =
 |interviewer-mask1    =
 |interviewer-mask2    =
 |display-interviewers =
 |season               =
 |series-number        =
 |series-separator     =
 |network              =
 |station              =
 |transcript           =
 |transcript-url       =
 |transcript-format    =
 |conference           =
 |conference-url       =
 |conference-format    =
}}
first1 last1 Author's first name. Don't link.
author-link1 last1 Title of Wikipedia article about the first author. Don't link.
last2 last1 Like last1, but for 2nd author.
first2 last2 Like first1, but for 2nd author.
author-link2 last2 Like author-link1, but for 2nd author.
last3 last2 Like last1, but for 3rd author.
first3 last3 Like first1, but for 3rd author.
author-link3 last3 Like author-link1, but for 3rd author.
last4 last3 Like last1, but for 4th author.
first4 last4 Like first1, but for 4th author.
author-link4 last4 Like author-link1, but for 4th author.
last5 last4 Like last1, but for 5th author. Similar: last6, etc.
first5 last5 Like first1, but for 5th author. Similar: first6, etc.
author-link5 last5 Like author-link1, but for 5th author. Similar: author-link6, etc.
name-list-stylevanc to emulate Vancouver style
vauthors
translator-last1
translator-first1translator-last1
translator-link1translator-last1
translator-last2translator-last1Additional translators: translator-last3, etc.
translator-first2translator-last2
translator-link2translator-last2
collaboration
contributor-last1
contributor-first1
contributor-link1
contributor-last2
contributor-first2
contributor-link2
others
editor-last1
editor-first1editor-last1
editor-link1editor-last1
editor-last2editor-last1
editor-first2editor-last2
editor-link2editor-last2
editor-last3editor-last2
editor-first3editor-last3
editor-link3editor-last3
veditors
title
script-title
trans-titletitle or script-title
work
script-work
trans-workwork or script-work
issue
department
chapterChapter title can be wikilinked unless when a chapter-url is given
script-chapter
trans-chapterchapter or script-chapter
contribution
type
editionOrdinal number
series
series-link
episode
event
agency
volume
date
year
orig-datedate or year
df
publisher
locationpublisher
publication-place
via
language
pagechoose one: "page", "pages", or "at"
pageschoose one: "page", "pages", or "at". Use when content on multiple pages supports the article text.
no-pppage or pagesset no-pp to "yes" to suppress the "p." or "pp." before page numbers
atchoose one: "page", "pages", or "at"
minutes
time
time-caption
id
arxiv
asin
asin-tld
bibcode
biorxiv
citeseerx
doi
doi-broken-datedoi
eissn
hdl
sbn
isbnalways include ISBN, if one has been assigned
ismn
issn
jfm
jstor
lccn
mr
oclc
ol
osti
pmc
embargo
pmid
rfc
ssrn
zbl
urltitle or script-title
formaturl
archive-urlarchive-date, url
archive-format
url-statusarchive-url
archive-datearchive-url
chapter-urlchapter or script-chapter
chapter-formatchapter-url
lay-url
lay-formatlay-url
lay-sourcelay-url
lay-datelay-url
access-dateurl
no-tracking
quote
ref
modecs1 or cs2
author-mask1last1
author-mask2last2
author-mask3last3
author-mask4last4
author-mask5last5
display-authors last1 number (number of authors displayed) or etal (more authors)
translator-mask1translator-last1
translator-mask2translator-last2
display-translators
contributor-mask1
contributor-mask2
display-contributors
editor-mask1editor-last1
editor-mask2editor-last2
editor-mask3editor-last3
display-editors
postscript
url-access
chapter-url-access
bibcode-access
doi-access
hdl-access
jstor-access
ol-access
osti-access
map
script-map
trans-map
map-url
map-format
map-url-access
scale
cartography
inset
sections
interviewer-last1
interviewer-first1
interviewer-link1
interviewer-last2
interviewer-first2
interviewer-link2
interviewer-mask1
interviewer-mask2
display-interviewers
season
series-number
series-separator
network
station
transcript
transcript-url
transcript-format
conference
conference-url
conference-format
If a field name is listed in the Prerequisites column it is a prerequisite for the field to the left.
Additional parameters (available for at least some cite templates)
|authors=
|book-title=
|class=
|degree=
|docket=
|encyclopedia=
|mailing-list=
|message-id=
|number=
|publication-date=
|section=
|sheet=
|sheets=
|title-link=
(available from late April 2020)|s2cid=

[edit subtemplate]

Copy a blank version to use. Almost all parameter names are supported only in lower case (some initialisms, such as |isbn= have upper-case aliases like |ISBN=, which are acceptable for use). Use the "|" (pipe) character between each parameter. Unused parameters may be deleted to avoid clutter in the edit window. Some samples on this documentation page may include the current date. If the date is not current, then purge the page. |}

[edit subtemplate]

Full parameter set in horizontal format

[edit subtemplate]

Most commonly used parameters in horizontal format

[edit subtemplate]

Full parameter set in vertical format
Vertical listPrerequisitesBrief instructions / notes

[edit subtemplate]

| style="vertical-align:top;" | |}

[edit subtemplate]

|}

  • If a field name is listed in the Prerequisites column, it is a prerequisite for the field to the left.

Use {{markup2}} to format the examples