编辑“︁Template:DNB/doc”︁

{{Documentation subpage}}<!-- 在本行下編輯模板說明 -->

{{About|國家人物傳記大辭典的連結|[[德國國家圖書館]]網站連結的模板|Template:DNB portal|short IDN links to entries in the German National Library|Template:DNB-IDN}}

===Quick explanation (''aide-mémoire'')===
The template can be placed in different locations and depending on the what it is required the parameters can be mixed and matched:
{|class=wikitable
|-
!Location||Parameters||Example||Note
|-
|==References==
|<nowiki>{{DNB|wstitle=</nowiki>''DNB name''<nowiki>}}</nowiki>
|{{DNB|wstitle=Abbadie, Jacques}}
|'''''DNB name''''' is the name of the article on [[Wikisource]]. All DNB articles are available there.
|-
|==References==
|<nowiki>{{DNB|wstitle=|first=|last=|authorlink=|volume=|page=}}</nowiki>
|{{DNB|last=Firth  |first=Charles Harding |authorlink=Charles Harding Firth|wstitle=Reynolds, John (d.1657)|volume=48 |page=47}}
|some additional information: '''first''' and '''last''' names of the author of the article, link to the author's page on WP, the '''volume''' and '''page [number]'''.
|-
|[[WP:CITE#Inline citations|inline citation]]
|<nowiki>{{DNB|inline=1|wstitle=</nowiki>''DNB name''<nowiki>}}</nowiki>
|{{DNB|inline=1|wstitle=Abbadie, Jacques}}
|'''inline=1'''. Alters the prescript from "This article..." to "One or more...". Suitable for noting that a paragraph is copied from DNB.
|-
|inline citation
|<nowiki>{{DNB|prescript=|wstitle=</nowiki>''DNB name''<nowiki>}}</nowiki>
|{{DNB|wstitle=Abbadie, Jacques|prescript=}}
|'''prescript='''.  Removes the prescript suitable for a citation where a paragraph is a summary of a paragraph from an DNB article and not a copy. '''title=''' for no copy on Wikisource. NB. {{Tlx|Cite DNB}} is more appropriate for this task.
|-
|==Further reading==
|<nowiki>{{DNB|no-icon=1|prescript=|wstitle=</nowiki>''DNB name''<nowiki>}}</nowiki>
|{{DNB|no-icon=1|prescript=|wstitle=Abbadie, Jacques}}
|'''no-icon=1''' remove the lead icon, '''prescript='''  removes the prescript.  NB. {{Tlx|Cite DNB}} is more appropriate for this task.
|-
|==External links==
|<nowiki>{{DNB|no-icon=1|prescript=|wstitle=</nowiki>''DNB name''<nowiki>}}</nowiki>
|{{DNB|no-icon=1|prescript=|wstitle=Abbadie, Jacques}}
|'''no-icon=1''', remove the lead icon '''prescript=''' removes the prescript as the source is not used in the article. NB. {{Tlx|Cite DNB}} is more appropriate for this task.
|}

===Deprecated historical template usage===
The DNB template predates the availability of the DNB articles at Wikisource and has evolved over time. In the past, editors used the "title=" and "url=" parameters to point to articles in non-Wikisource copies of the DNB, often scans of marginal quality. As of 2013, [[s:Dictionary of National Biography, 1885-1900|all DNB articles are available at Wikisource]], so pointing non-Wikisource articles is deprecated: use wstitle instead to point to the Wikisource DNB article. If you encounter one of these older template instances, please convert it. If you feel that the pointer to a non-wikisource instance is better for some reason, please put a wiki comment next to the template to explain why and comment on the talk page at [[Wikipedia talk:WikiProject Dictionary of National Biography]].  Except for a very few anonymous articles, each article has an attributed author. Please use the information at Wikisource to fill in the "last=", "first=", and (when it exists) "authorlink=" parameters.  The "volume=" and "page=" parameters are also easy to fill in, but are less critical.

===Detailed notes===
This template is wrapper around {{Tlx|Cite DNB}}. In its default mode it attributes text to an article from the [Old] [[Dictionary of National Biography]].

{{Tlx|Cite DNB}} automatically sets some of the parameters before calling {{Tlx|Cite encyclopedia}} for example "publisher = [[Smith, Elder & Co]]". Over and above the standard parameter passed into {{Tlx|Cite encyclopedia}} there are some additional parameters and those are listed below in a separate table from the table of parameters passed into {{Tlx|Cite encyclopedia}}.

Minimum is: '''<nowiki>{{DNB|wstitle=</nowiki>''DNB article name''<nowiki>}}</nowiki>'''<ref group=nb>It will also work with no parameters, but that sets a category flagging that no article name has been given, as it is not much use to the reader to inform them that a Wikipedia article contains some text copied from somewhere in the 64-volumes of the Dictionary of National Biography!</ref>
Full set is:'''<nowiki>{{DNB|wstitle=|display=|prescript=|no-icon=|inline=|author=|last=|first=|authorlink=|coauthors=|title=|url=|accessdate=|volume=|page=|pages=|ref=|mode=|supplement=}}</nowiki>'''

{|class=wikitable
|+Additional parameters
!Parameter ||Note
|-
|wstitle=''name of the article on wikisource'' ||Should always be present. Sets link to DNB article on wikisource. (unsets ''title'' and ''url'' if they are also set.)
|-
|inline=1 ||Changes the default prescript from "This article" to "One or more of the preceding sentences". Useful for inline citations (see inline examples in the [[#Quick explanation (aide-mémoire)|previous section]]).
|-
|no-icon=1 ||Suppresses the lead icon (useful with {{Tlx|Wikisource-inline}}).
|-
|section=''name of a section in a DNB article on  wikisource'' ||Optional. Sometimes the subject of a biography may be appended to a more prominent family member. This parameter can be used as an addition to wstitle to link to such an appended biography.
|-
|display=''text'' ||Optional. It will display the ''text'' on the wikipedia page in place of content of the parameters wstitle= or title=. This can be useful when the name of the article on Wikisource does not match the original (eg for disambiguation purposes), or to allow the display on Wikipedia of an ndash for date ranges in place of the dash currently used on Wikisource 
|-
|prescript=''alternative prescript''||''prescript'' can either be set to an alternative string of text (in which case add ''&#38;nbsp;'' to the end of the string as a separator from the first word of the citation); or if set with no string it will remove prescript string from in front of the citation.
|-
|}

{|class=wikitable
|+Parameters passed into {{Tlx|Cite encyclopedia}}
!Parameter||Set to||Notes
|-
|last= ||author= or last= ||Set the value of ''last='' or not set.
|-
|first= ||first= ||Set to the value of ''first='' or not set
|-
|authorlink= ||  authorlink= || Set to the value of ''authorlink='' or not set
|-
|coauthors= ||  coauthors= || Do not use. each DNB article has a single author
|-
|editor= ||Sidney Leslie [or Stephen Lee]||Not set, unless the volume parameter then the editor parameter is automatically set within the template.
|-
|encyclopedia= || [[Dictionary of National Biography]]||Automatically set within the template
|-
|title= ||wstitle= or title= ||Set to ''wstitle='' if set, if not to ''title='', if not set then left blank.
|-
|url= ||url= || Set to the value of url= unless ''wstitle='' is set in which case it is not set.
|-
|accessdate= || accessdate= || Set to the value of ''accessdate='' or not set
|-
| language=||en  ||Set by default within the wrapped template
|-
| edition= ||  ||Not set
|-
| date= || ||Not set (see year)
|-
| year= || ||Not set, or if the volume parameter is set, then set to the year that the volume was first published. Can be overwritten by explicitly setting year eg year=1900b
|-
| month= || ||Not set
|-
| publisher= ||[[Smith, Elder & Co]] ||automatically set within the template
|-
| volume= ||volume= ||Set to the value of ''volume='' or not set
|-
| location= ||London ||Automatically set within the template
|-
| id= || ||Not set
|-
| isbn= || ||Not set
|-
| oclc= || ||Not set
|-
| doi= || ||Not set
|-
| page= ||page=||Set to the value of ''page='' or not set
|-
| pages= ||pages=||Set to the value of ''pages='' or not set
|-
| quote=||quote=||Set to the value of ''quote='' or not set
|-
| ref=|| ||Set to the value of ''ref='' or set automatically within the template. This means that {{tl|sfn}} and {{tl|harvnb}} link to this template as intended. (If you need to ask don't worry about it)
|-
|mode=|| ||Not set. Sets element separator, default terminal punctuation, and certain capitalization according to the value provided (see {{tl|cite encyclopedia}} for details)
|}

===隱藏分類===
This template includes one of three hidden subcategories of category [[:Category:Wikipedia articles incorporating text from the Dictionary of National Biography]].
* If '''<code><nowiki>{{</nowiki>DNB|wstitle=''name''}}</code>''' is used: [[:Category:有維基文庫來源的包含DNB文本的條目]] is included.
* otherwise [[:Category:無維基文庫來源的包含DNB文本的條目]] is included.
* If an unnamed parameter is set then the article name is listed in [[:Category:包含不知名參數的包含DNB文本的條目]]

The categories do not appear at the bottom of the article page, but the article is listed on the category page.

==參見==
{{excerpt|Template:Cite DNB/doc|參見}}

==註釋==
{{reflist|group=nb}}

<includeonly>{{Sandbox other||<!-- 本行下加入模板的分類 -->
{{DEFAULTSORT:Dnb}}
[[Category:引據模板]]
[[Category:國家人物傳記大辭典模板]]
}}</includeonly>