الگو:Citation/توضیحات: تفاوت میان نسخه‌ها

صفحه‌ای تازه حاوی «{{Documentation subpage}} <!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE --> {{الگوی نامطابق با شیوه یادکرد منابع|یادکرد}} {{چپ‌چین}} <!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE --> {{For2|the {{fake citation needed}} template|{{الگو|citation needed}}}} {{Citation Style documentation|lua}} The '''Citation''' template generates a citation for a book, periodical, contribution in a c...» ایجاد کرد
 
بدون خلاصۀ ویرایش
 
خط ۶۹۵: خط ۶۹۵:


==Anchored citations==
==Anchored citations==
This template can generate a citation that can be combined with [[ویکی‌پدیا:شیوه ارجاع به منابع|shortened footnotes]] or [[Wikipedia:Parenthetical referencing|parenthetical referencing]]. It does this by creating an [[عنصر اچ‌تی‌ام‌ال|HTML anchor]] containing an ID. The special parameter {{پارا|ref|harv}} generates an ID suitable for [[Harvard referencing]] templates such as {{الگو|harv}} as specified in the next section; this is the default for the {{الگو|citation}} template. To disable anchor generation, specify {{پارا|ref|none}} – leaving {{پارا|ref}} empty has the same effect but is ambiguous; this is the default for the Cite templates such as {{الگو|cite book}} and {{الگو|cite news}}. You can also specify the ID directly, using the {{پارا|ref|<var>ID</var>}} parameter. For example, suppose an article's ''References'' section contains the markup:
This template can generate a citation that can be combined with [[ویکی‌هزاره:شیوه ارجاع به منابع|shortened footnotes]] or [[Wikipedia:Parenthetical referencing|parenthetical referencing]]. It does this by creating an [[عنصر اچ‌تی‌ام‌ال|HTML anchor]] containing an ID. The special parameter {{پارا|ref|harv}} generates an ID suitable for [[Harvard referencing]] templates such as {{الگو|harv}} as specified in the next section; this is the default for the {{الگو|citation}} template. To disable anchor generation, specify {{پارا|ref|none}} – leaving {{پارا|ref}} empty has the same effect but is ambiguous; this is the default for the Cite templates such as {{الگو|cite book}} and {{الگو|cite news}}. You can also specify the ID directly, using the {{پارا|ref|<var>ID</var>}} parameter. For example, suppose an article's ''References'' section contains the markup:
* <code><nowiki>{{Citation |author=Sigmund Freud |title=Civilization and Its Discontents |year=1930 |ref=CivDis}}</nowiki></code>
* <code><nowiki>{{Citation |author=Sigmund Freud |title=Civilization and Its Discontents |year=1930 |ref=CivDis}}</nowiki></code>
which generates the citation:
which generates the citation:
خط ۷۱۴: خط ۷۱۴:
Last names are used, as specified by the parameters {{پارا|last1}} (or {{پارا|last}}), {{پارا|last2}}, {{پارا|last3}}, and {{پارا|last4}}, and similarly for {{پارا|editor1-last}} etc. and for {{پارا|inventor1-last}} etc. If a full name is given but no last name is specified, this template falls back on the full name, but this usage is not recommended. For example, in "<code><nowiki>{{Citation | author = Sigmund Freud | title = The Ego and the Id | year = 1923}}</nowiki></code>" no last name is given, so this citation cannot be combined with the Harvard reference "<code><nowiki>{{یادکرد هاروارد|Freud|1923}}</nowiki></code>". To make these {{الگو|citation}} and {{الگو|harv}} invocations compatible, either replace "{{پارا|author|Sigmund Freud}}" with "{{پارا|first|Sigmund}} {{پارا|last|Freud}}", or add "{{پارا|ref|<nowiki>{{SfnRef|Freud|1923}}</nowiki>}}" to the {{الگو|citation}} invocation, or add the same ref parameter (say, "{{پارا|ref|EgoId}}") to both the {{الگو|citation}} and the {{الگو|harv}} invocations.
Last names are used, as specified by the parameters {{پارا|last1}} (or {{پارا|last}}), {{پارا|last2}}, {{پارا|last3}}, and {{پارا|last4}}, and similarly for {{پارا|editor1-last}} etc. and for {{پارا|inventor1-last}} etc. If a full name is given but no last name is specified, this template falls back on the full name, but this usage is not recommended. For example, in "<code><nowiki>{{Citation | author = Sigmund Freud | title = The Ego and the Id | year = 1923}}</nowiki></code>" no last name is given, so this citation cannot be combined with the Harvard reference "<code><nowiki>{{یادکرد هاروارد|Freud|1923}}</nowiki></code>". To make these {{الگو|citation}} and {{الگو|harv}} invocations compatible, either replace "{{پارا|author|Sigmund Freud}}" with "{{پارا|first|Sigmund}} {{پارا|last|Freud}}", or add "{{پارا|ref|<nowiki>{{SfnRef|Freud|1923}}</nowiki>}}" to the {{الگو|citation}} invocation, or add the same ref parameter (say, "{{پارا|ref|EgoId}}") to both the {{الگو|citation}} and the {{الگو|harv}} invocations.


Similarly, the year is used, as specified by {{پارا|year}}. If no year is given, this template attempts to derive the year from {{پارا|date}} (or, if no date is given, from {{پارا|publication-date}}) by applying the [[mw:Help:Extension:ParserFunctions##time|MediaWiki#time function]]. This heuristic works with many common date formats (American, International and [[ایزو ۸۶۰۱|ISO 8601 standard format]] YYYY-MM-DD as listed in [[ویکی‌پدیا:شیوه‌نامه]]), but may not work as expected with other formats, so when in doubt it may be safer to use {{پارا|year}}. Note that if only a year, say 2005, is known you must use {{پارا|year|2005}} rather than {{پارا|date|2005}}.
Similarly, the year is used, as specified by {{پارا|year}}. If no year is given, this template attempts to derive the year from {{پارا|date}} (or, if no date is given, from {{پارا|publication-date}}) by applying the [[mw:Help:Extension:ParserFunctions##time|MediaWiki#time function]]. This heuristic works with many common date formats (American, International and [[ایزو ۸۶۰۱|ISO 8601 standard format]] YYYY-MM-DD as listed in [[ویکی‌هزاره:شیوه‌نامه]]), but may not work as expected with other formats, so when in doubt it may be safer to use {{پارا|year}}. Note that if only a year, say 2005, is known you must use {{پارا|year|2005}} rather than {{پارا|date|2005}}.


===IDs must be unique===
===IDs must be unique===
خط ۷۴۱: خط ۷۴۱:


==Tools==
==Tools==
See [[ویکی‌پدیا:شیوه ارجاع به منابع]] for a list of tools that can help create a reference in the "citation" format.
See [[ویکی‌هزاره:شیوه ارجاع به منابع]] for a list of tools that can help create a reference in the "citation" format.


==Template Data==
==Template Data==