الگو:Citation Style documentation

توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

{{csdoc}}

Usage

This template is used to build consistent documentation pages for شیوه یادکرد ۱ 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

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

Lead section

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

الگو:Citation Style documentation/edit الگو:Citation Style documentation/opt

نشانه‌گذاری	نمایش
{{csdoc\|lead\|books}}	This شیوه یادکرد ۱ template is used to create citations for books.

Lua notice

الگو:Citation Style documentation/edit

Usage section

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

Copy a blank version to use. All parameter names must be in lowercase. Use the "|" (pipe) character between each parameter. Delete unused parameters to avoid clutter in the edit window. Some samples 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.

Full horizontal style

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 book |last1= |first1= |author1-link= |last2= |first2= |author2-link= |editor1-first= |editor1-last= |editor1-link= |others= |title= |trans-title= |url= |archive-url= |archive-date= |format= |access-date= |type= |edition= |series= |volume= |date= |year= |orig-year= |publisher= |location= |language= |isbn= |oclc= |doi= |id= |page= |pages= |at= |trans-chapter= |chapter= |chapter-url= |quote= |ref= |bibcode= |lay-url= |lay-source= |lay-date= |author-mask= |display-authors= |postscript= |last-author-amp=}}</nowiki></code>
{{end}}

همه پارامترها در قالب افقی
{{cite book \|last1= \|first1= \|author1-link= \|last2= \|first2= \|author2-link= \|editor1-first= \|editor1-last= \|editor1-link= \|others= \|title= \|trans-title= \|url= \|archive-url= \|archive-date= \|format= \|access-date= \|type= \|edition= \|series= \|volume= \|date= \|year= \|orig-year= \|publisher= \|location= \|language= \|isbn= \|oclc= \|doi= \|id= \|page= \|pages= \|at= \|trans-chapter= \|chapter= \|chapter-url= \|quote= \|ref= \|bibcode= \|lay-url= \|lay-source= \|lay-date= \|author-mask= \|display-authors= \|postscript= \|last-author-amp=}}

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= |year= |publisher= |location= |isbn= |page= |pages=}}</nowiki></code>
{{end}}

پر استفاده‌ترین پارامترها به صورت افقی
`{{cite book \|last= \|first= \|author-link= \|title= \|url= \|access-date= \|year= \|publisher= \|location= \|isbn= \|page= \|pages=}}`

Full vertical style

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                 =
| 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}}

Full parameter set in vertical format
Vertical list	Prerequisites	Brief instructions / notes
{{cite book \| last = \| first = \| author-link = }}	last	same as last1 same as first1

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

Sub-templates

Usage

الگو:Citation Style documentation/edit

|}

Usage full

الگو:Citation Style documentation/edit

|}

Usage common

الگو:Citation Style documentation/edit

|}

Usage vertical

الگو:Citation Style documentation/edit

|}

Usage vertical mid

الگو:Citation Style documentation/edit

|}

Usage vertical end

الگو:Citation Style documentation/edit

Examples section

Use {{markup2}} to format the examples (see that template's documentation for use).

{{markup2 |t=Basic usage with url (and accessdate) and edition
|m={{cite book |title=Mysterious book}}
|r={{cite book |title=Mysterious book}}
}}

Basic usage with url (and accessdate) and edition

{{cite book |title=Mysterious book}}

Mysterious book.

Parameters section

ن ب و راهنما:شیوه یادکرد ۱ · noticeboard
General templates	{{Cite arXiv}} آرکایو (بایگانی نوشتارهای علمی) preprint {{Cite AV media}} audio and visual {{Cite AV media notes}} audio and visual liner notes {{Cite book}} books {{Cite conference}} conference papers {{Cite DVD notes}} DVD liner notes {{Cite encyclopedia}} edited collections {{Cite episode}} radio or television episodes {{Cite interview}} interviews {{Cite journal}} magazines, journals, academic papers {{Cite mailing list}} public mailing lists {{Cite map}} maps {{Cite news}} news articles {{Cite newsgroup}} online newsgroups {{Cite podcast}} audio or video podcast {{Cite press release}} press releases {{Cite serial}} audio or video serials {{Cite sign}} signs, plaques {{Cite speech}} speeches {{Cite techreport}} technical reports {{Cite thesis}} theses {{Cite web}} web sources
Identifier-based templates	{{Cite doi}} DOI {{Cite hdl}} Handle {{Cite isbn}} ISBN {{Cite jstor}} جی‌استور {{Cite pmid}} ({{CitePMIDs}}) PMID
Categories	Citation Style 1 templates
Documentation	{{Citation Style documentation}}

Usage

Section usage

Lead section

Lua notice

Usage section

Full horizontal style

Most commonly used horizontal style

Full vertical style

Sub-templates

Usage

Usage full

Usage common

Usage vertical

Usage vertical mid

Usage vertical end

Examples section

Parameters section

syntax

COinS

sep_period

sep_comma

required

deprecated

author

editor

title

web

chapter

type

journal

edition

series

series_episode

event

agency

volume

date

publisher

newsgroup

language

pages

time

id1

id2

url

chapterurl

lay

quote

ref

ref2

display

Subscription or registration required

map_series

map_pages

interview_id

interview_author

interview_interviewer

album_name

season

network

transcript

conference

See also