سانچہ:Citation Style documentation

دستاویز [نمائش] [ترمیم] [تاریخچہ] [تطہیر]

استعمال

Citation Style 1 سانچوں کے لیے موافق اور ہم آہنگ دستاویزی صفحات تخلیق کرنے کے لیے یہ سانچہ استعمال کیا جاتا ہے۔

مثال کے طور پر: {{Citation Style documentation|author}} مصنف کی دستاویز ظاہر کرے گا۔

جب دستاویز کا کوئی مخصوص قطعہ یا ٹکڑا ایک خاص سانچے میں مناسب نہ بیٹھتا ہو تو خود ہی متن شامل کرنے پر اکتفا کیجیے یا ایک نیا ضمنی سانچہ تخلیق کیجیے۔

متن کا ہر ماڈیول ایک ضمنی سانچہ ہوتا ہے جس میں ربط کا استعمال کرتے ہوئے ترمیم کی جاسکتی ہے۔

استعمالِ قطعہ

جب آپ دستاویزی سانچے تخلیق کر رہے ہوں تو قطعات اور مواد کی درج ذیل ترتیب اپنائیے:

• راہنمائی: سانچے کے مقصد کا مختصر بیان
• استعمال: خالی مقداروں (پیرامیٹر) کے چند نمونے جنھیں نقل اور چسپاں کیا جاسکے
• مثالیں: متعدد استعمال کی مثالیں
• مقداریں (پیرامیٹر): ہر مقدار کی تفصیلی وضاحت
  • نحو: سانچے کی نحو کا جائزہ
  • ناپسندیدہ: ناپسندیدہ مقداروں کی فہرست
  • کوائف: مقداروں کے کوائف جو درج ذیل عمومی ترتیب میں بلحاظ عمل علاحدہ ہوں:
    • مصنفین
    • عنوان
    • تاریخ
    • مطبع
    • طباعت، سلسلہ، جلد
    • مآخد میں جگہ
    • URL
    • Anchor
    • شناخت کنندگان
    • اقتباس
    • مدیر
    • پوشیدہ خلاصہ
    • اختیارات دکھائیں

Lead section

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

اس Citation Style 1 سانچے کو citations تخلیق کرنے کے لیے استعمال کریں۔

یہاں کے اختیارات:

One unnamed parameter is used to create the trailing text.

مارک اپ	بطور نتیجہ
{{csdoc|lead|books}}	اس Citation Style 1 سانچے کو citations books تخلیق کرنے کے لیے استعمال کریں۔

Lua notice

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 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= |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= |layurl= |laysource= |laydate= |author-mask= |author-name-separator= |author-separator= |display-authors= |separator= |postscript= |lastauthoramp=}}</nowiki></code>
{{end}}

Full parameter set in horizontal format

{{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= |layurl= |laysource= |laydate= |author-mask= |author-name-separator= |author-separator= |display-authors= |separator= |postscript= |lastauthoramp=}}

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

Most commonly used parameters in horizontal format

{{cite book |last= |first= |authorlink= |title= |url= |accessdate= |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                 =
| authorlink            =
}}
</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 = | authorlink = }}	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

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 the page. |}

Usage full

Full parameter set in horizontal format

Usage common

Most commonly used parameters in horizontal format

Usage vertical

Full parameter set in vertical format

Vertical list	Prerequisites	Brief instructions / notes

Usage vertical mid

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

Usage vertical end

|}

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

Examples section

Use {{markup2}} to format the examples; see the template 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

syntax

پیوستہ پیرا میٹر، یہ اپنے اصلی پیرا میٹرز (منبع) پر انحصار کرتے ہیں:

• منبع
• یا: منبع2—اسے منبع کی جگہ استعمال کیا جاسکتا ہے
  • شاخ—کے ساتھ منبع استعمال کیا جا سکتا ہے (اور اگر منبع کا استعمال نہیں کیا جاتا تو اسے نظر انداز کر دیا جاتا ہے)
  • یا: شاخ2—کی بجائے شاخ استعمال کیا جا سکتا ہے (اور اگر منبع2 کا استعمال نہیں کیا جاتا تو اسے نظر انداز کر دیا جاتا ہے)

جہاں عرفی نام درج کر رہے ہوں، صرف پیرامیٹرز میں سے ایک تعریف یوں کی جا سکتی ہے; ایک سے زیادہ عرفی نام پیرامیٹرز کی وضاحت کر رہے ہوں تو، پھر صرف ایک ہی دکھائے گا۔

coins

This template embeds COinS metadata in the HTML output, allowing reference management software to retrieve bibliographic metadata. See: Wikipedia:COinS. As a general rule, only one data item per parameter. Do not include explanatory or alternate text:

• Use |date=27 September 2007 not |date=27 September 2007 (print version 25 September)

Use of templates within the citation template, is discouraged because many of these templates will add extraneous HTML or CSS that will be rendered in the metadata. Also, HTML entities, for example  , –, etc, should not be used in parameters that contribute to the metadata. Do not include Wiki markup '' (italic font) or ''' (bold font) because these markup characters will contaminate the metadata.

COinS metadata is created for these parameters 

• |periodical=, |journal=, |newspaper=, |magazine=, |work=, |website=, |encyclopedia=, |encyclopaedia=, |dictionary=
• |chapter=, |contribution=, |entry=, |article=, |section=
• |title=
• |publicationplace=, |publication-place=, |place=, |location=
• |date=, |year=, |publicationdate=, |publication-date=
• |series=, |version=
• |volume=
• |issue=, |number=
• |page=, |pages=, |at=
• |edition=
• |publisher=, |distributor=, |institution=
• |url=
• |chapterurl=, |chapter-url=, |contributionurl=, |contribution-url=, |sectionurl=, |section-url=
• |author#=, |Author#=, |authors#=, |author#-last=, |author-last#=, |last#=, |surname#=
• |"author#-first=, |author-first#=, |first#=, |given#=
• any of the named identifiers (|isbn=, |issn=, |doi=, |pmc=, etc)

sep_period

sep_comma

required

This parameter is required and will generate an error if not defined. On errors, main, help and template pages are placed into Category:Articles with incorrect citation syntax. Set |template doc demo=true to disable categorization; mainly used for documentation where the error is demonstrated.

deprecated

یہاں کے اختیارات:

• |date2=yes adds:
  • date2
  • month2
  • year2

author

یہاں کے اختیارات:

• |coauthors=yes adds "coauthors: (deprecated) Names of coauthors. Use the same format as the authors."
• |others=yes adds "others: To record other contributors to the work, such as "Illustrated by Smith" or "Trans. Smith"."
• |aliases= add aliases for last.
• lua: When set, changes descriptions to update Lua versions.

editor

یہاں کے اختیارات:

• lua: When set, changes descriptions to update Lua versions.

title

یہاں کے اختیارات:

title_title sets the display title:

• encyclopedia = encyclopedia
• default = title

web

• title: Title of source page on website. Displays in quotes. If script-title is defined, title holds romanized transliteration of title in script-title.
  • script-title: Original title for languages that do not use a Latin-based alphabet (Arabic, Chinese, Hebrew, Japanese, etc); follows transliteration defined in title. May be prefixed with an ISO 639-1 two-character code to help browsers properly display the script:

    ... |title=Tōkyō tawā |script-title=ja:東京タワー |trans-title=Tokyo Tower ...

  • trans-title: English translation of the title if the source cited is in a foreign language. Displays in square brackets after title; trans-title is included in the link. Use of the language parameter is recommended.

Titles containing certain characters will display and link incorrectly unless those characters are encoded.

نئی سطر	[	]	|
خالی جگہ (سپیس)	[	]	|

This parameter is required and will generate an error if not defined. On errors, main, help and template pages are placed into Category:Articles with incorrect citation syntax. Set |template doc demo=true to disable categorization; mainly used for documentation where the error is demonstrated.

• website: Title of website; may be wikilinked. Displays in italics. Aliases: work

chapter

یہاں کے اختیارات:

title_format sets the display format:

• italics = Displays in italics.
• work = If work is defined, then title is displayed in quotes, else displays in italics.
• default = Displays in quotes.

title_title sets the display title:

• booktitle = booktitle
• default = chapter

type

• قسم: ذرائع ابلاغ کے مآخذ کےمتعلق اضافی معلومات مہیا کرتا ہے; جملے کی صورت میں۔ عنوان مندرجہ ذیل قوسین میں دکھاتا ہے۔ مثالیں: مقالات، کتابچہ، سی ڈی لائنر، خبری اعلامیہ۔

یہاں کے اختیارات:

• type_default: Adds "Defaults to type_default"

journal

یہاں کے اختیارات:

• department adds:

• department: Regular department within the periodical. Displays after work and is in plain text.

edition

series

series_episode

event

agency

volume

یہاں کے اختیارات:

• lua: When set, changes descriptions to update Lua versions.

date

• date: Date of source being referenced. Can be full date (day, month, and year) or partial date (month and year, season and year, or year). Use same format as other publication dates in the citations. Required when year is used to disambiguate {{sfn}} links to multiple-work citations by the same author in the same year.^{سانچہ:Sfn]} Do not wikilink. Displays after the authors and is enclosed in parentheses. If there is no author, then displays after publisher. For acceptable date formats, see Help:Citation Style 1 § Dates.

For approximate year, precede with "c. ", like this: |date=c. 1900.

For no date, or "undated", add as |date=n.d.

• year: Year of source being referenced. Use of |date= is recommended unless all of the following conditions are met:
  1. The template uses |ref=harv, or the template is {{citation}}, or |mode=cs2
  2. The |date= format is YYYY-MM-DD.
  3. The citation requires a CITEREF سانچہ:Sfn.
• orig-year: Original publication year; displays after the date or year. For clarity, please supply specifics. For example: |orig-year=First published 1859 or |orig-year=Composed 1904.
• df: date format; sets rendered dates to the specified format; does not support date ranges or seasonal dates. Accepts one value which may be one of these:

  dmy – set publication dates to day month year format; access- and archive-dates are not modified;

  mdy – as above for month day, year format

  ymd – as above for year initial numeric format YYYY-MM-DD

  dmy-all – set publication, access-, and archive-dates to day month year format;

  mdy-all – as above for month day, year format

  ymd-all – as above for year initial numeric format YYYY-MM-DD

یہاں کے اختیارات:

• aliases includes aliases for date
• began adds:

• OR: began: Full date the first part of the program or episode aired.
  • AND: ended: Full date the last part of the program or episode aired.

publisher

یہاں کے اختیارات:

• |work=no suppresses "; if work is defined, then publisher and location are enclosed in parentheses"
• |map=yes changes:
  • publisher: Name of publisher. The publisher is the company that publishes the work being cited. Do not use the publisher parameter for the name of a work (e.g., a book, encyclopedia, newspaper, magazine, journal, website). Displays before title. Do not wikilink—use publisher-link instead.
  • publisher-link: Title of existing Wikipedia article about the publisher—not the publisher's website; do not wikilink.

newsgroup

language

• زبان: The language the source is written in, if not English. Displays in parentheses with "in" before the language name. Use the full language name; do not use templates.

pages

یہاں کے اختیارات:

• work adds "or work (or an alias) is defined"

time

id1

id2

url

• url: URL of an online location where the text of the publication can be found. Cannot be used if title is wikilinked. If applicable, the link may point to the specific page(s) referenced. Remove spurious tracking parameters from URLs, e.g. #ixzz2rBr3aO94 or ?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=.... See WP:PAGELINKS. Do not link to any commercial booksellers, such as Amazon.com.
  • access-date: Full date when the content pointed to by url was last verified to support the text in the article; do not wikilink; requires url; use the same format as other access and archive dates in the citations. Not required for linked documents that do not change. For example, access-date is not required for links to copies of published research papers accessed via DOI or a published book, but should be used for links to news articles on commercial websites (these can change from time to time, even if they are also published in a physical medium). Note that access-date is the date that the URL was checked to not just be working, but to support the assertion being cited (which the current version of the page may not do). Can be hidden or styled by registered editors. Alias: accessdate.
  • archive-url: 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 (see Wikipedia:Using WebCite) and انٹرنیٹ آرکائیو (see Wikipedia:Using the Wayback Machine); requires archive-date and url. Alias: archiveurl.
    • archive-date: Date when the original URL was archived; preceded by default text "archived from the original on". Use the same format as other access and archive dates in the citations. This does not necessarily have to be the same format that was used for citing publication dates. Do not wikilink. Alias: archivedate.
    • dead-url: When the URL is still live, but pre-emptively archived, then set |dead-url=no. This changes the display order with the title retaining the original link and the archive linked at the end. When the original url has been usurped for the purposes of spam, advertising, or is otherwise unsuitable, setting |dead-url=unfit or |dead-url=usurped will not link to the original url in the rendered citation; |url= is still required. Other accepted values are y, yes, or true. Alias: deadurl.
  • template-doc-demo: The archive parameters will be error checked to ensure that all the required parameters are included, or else {{citation error}} is invoked. With errors, main, help and template pages are placed into one of the subcategories of Category:Articles with incorrect citation syntax. Set |template-doc-demo=true to disable categorization; mainly used for documentation where the error is demonstrated.
• format: Format of the work referred to by url; for example: PDF, DOC, or XLS; displayed in parentheses after title. HTML is implied and should not be specified. Automatically added when a PDF icon is displayed. Does not change the external link icon. Note: External link icons do not include alt text; thus, they do not add format information for the visually impaired.

URLs must begin with a supported URI scheme. http:// and https:// will be supported by all browsers; however, ftp://, gopher://, irc://, ircs://, mailto: and news: will require a plug-in or an external application and should normally be avoided. IPv6 host-names are currently not supported.

If URLs in citation template parameters contain certain characters, then they will not display and link correctly. Those characters need to be percent-encoded. For example, a space must be replaced by %20. To encode the URL, replace the following characters with:

sp	"	'	<	>	[	]	{	|	}
%20	%22	%27	%3c	%3e	%5b	%5d	%7b	%7c	%7d

Single apostrophes do not need to be encoded; however, unencoded multiples will be parsed as italic or bold markup. Single curly closing braces also do not need to be encoded; however, an unencoded pair will be parsed as the double closing braces for the template transclusion.

یہاں کے اختیارات:

• pmc adds:

" If url is not defined but pmc is, then url is set to the pmc link.

• Embargo: Date that pmc goes live; if this is in the future, then url is not set to the pmc link until that date."

chapterurl

lay

quote

یہاں کے اختیارات:

• |cs2=yes suppresses "When supplied, the citation terminator (a period by default) is suppressed, so the quote needs to include terminating punctuation."

ref

ref2

display

• author-mask: Replaces the name of the first author with em dashes or text. Set author-mask to a numeric value n to set the dash n em spaces wide; set author-mask to a text value to display the text without a trailing author separator; for example, "with". You must still include the values for all authors for metadata purposes. Primarily intended for use with bibliographies or bibliography styles where multiple works by a single author are listed sequentially such as Shortened footnotes. Do not use in a list generated by {{reflist}}, <references /> or similar as there is no control of the order in which references are displayed.
• author-name-separator: Controls the separator between last and first names; defaults to a comma and space (, ); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as   do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.
• author-separator: Controls the separator between authors; defaults to a semicolon and space (; ); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as   do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.
• display-authors: Controls the number of author names that are displayed when a citation is published. To control the displayed number of author names, set display-authors to the desired number. For example, |display-authors=2 will display only the first two authors in a citation. By default, the only the first eight cited authors are displayed; subsequent authors beyond eight are represented in the published citation by "et al." If a citation contains nine author names and one wishes all nine author names to display, "et al." may be suppressed by setting |display-authors=9. Aliases: displayauthors.

• lastauthoramp: Switches the separator between the last two names of the author list to space ampersand space ( & ) when set to any value. Example: |lastauthoramp=yes
• postscript: Controls the closing punctuation for a citation; defaults to a period (.); if the parameter is present, but blank, no terminating punctuation will be used. Ignored if quote is defined.
• separator: Controls the punctuation used to separate lists of authors, editors, etc. Defaults to a period (.); if the parameter is present, but blank, no separator punctuation will be used; a space must be encoded as   do not use an asterisk (*), colon (:) or hash (#) as they will be interpreted as wikimarkup.

یہاں کے اختیارات:

• cs2: When set, changes:
  • postscript to "defaults to none"
  • separator to "Defaults to a comma (,)"
• lua: When set, changes descriptions to update Lua versions.

Subscription or registration required

تفصیلی مضمون کے لیے WP:PAYWALL ملاحظہ کریں۔

These parameters add a link note to the end of the citation:

• registration: For online sources that require registration, set |registration=yes; superseded by subscription if both are set.
• subscription: For online sources that require a subscription, set |subscription=yes; supersedes registration if both are set.

map_series

map_pages

interview_id

interview_author

interview_interviewer

album_name

season

network

transcript

conference