Extension:Cite

این صفحه افزونه را مستند می‌کند. For how to use it, see help on citing.

راهنمای افزونهٔ مدیاویکی

Cite وضعیت انتشار: پایدار
انجام	Tag
توضیحات	Allows footnotes for citing sources and helps for correctly citing content in offline media
نویسنده(گان)	Ævar Arnfjörð Bjarmasonبحث
آخرین نسخه:	به‌روزرسانی‌های پیوسته
سیاست سازگاری	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	1.34+
PHP	7.0+
مجوز	GNU General Public License 2.0 or later
بارگیری	Download extension Git [?]: Browse repository (Phabricator · GitHub) Gerrit code review Git commit log Download source tarball
نمونه:	Wikipedia:Footnotes
پارامترها $wgCiteDefaultBacklinkAlphabet $wgCiteReferencePreviewsConflictingNavPopupsGadgetName $wgCiteResponsiveReferencesThreshold $wgCiteResponsiveReferences $wgCiteSubReferencing $wgCiteBacklinkCommunityConfiguration $wgCiteReferencePreviews $wgCiteUseLegacyBacklinkLabels $wgCiteVisualEditorOtherGroup $wgCiteReferencePreviewsConflictingRefTooltipsGadgetName
Hooks used APIQuerySiteInfoGeneralInfo CommunityConfigurationProvider_initList ContentHandlerDefaultModelFor EditPage::showEditForm:initial GetPreferences MakeGlobalVariablesScript ParserAfterParse ParserClearState ParserCloned ParserFirstCallInit ResourceLoaderGetConfigVars ResourceLoaderRegisterModules UserGetDefaultOptions
Translate the Cite extension if it is available at translatewiki.net
Issues	Open tasks · گزارش یک مشکل

The Cite extension allows a user to create references as footnotes on a page. It adds two parser hooks to MediaWiki, ‎<ref> and ‎<references />; these operate together to add citations to pages.

استفاده

See the help page for using the Cite extension for further information.

نصب

This extension comes with MediaWiki 1.21 and later, so you do not need to download it. The remaining configuration instructions must still be followed.

• Download and move the extracted Cite folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Cite
  

• کد زیر را در انتهای $LocalSettings خودتان اضافه کنید:

  wfLoadExtension( 'Cite' );
  

• Configure as required.
• انجام شد – به Special:Version در ویکی خودتان بروید تا مطئمن شوید که افزونه با موفقیت نصب شده است.

Vagrant installation:

• اگر از Vagrant استفاده می‌کنید، با vagrant roles enable cite --provision نصب کنید

پیکربندی

$wgCiteBookReferencing

Enables an experimental feature for sub-references when set to true, see the help page. Default value: false

$wgCiteResponsiveReferences

Default setting for responsive display of references. When set to true, the references section will be displayed in multiple columns. See the usage documentation. Default value: true

$wgCiteVisualEditorOtherGroup

When set to true, the Cite toolbar button can be moved under the Insert menu. This is used on Wikivoyage sites. See the original feature request. Default value: false.

By adding a definition in JSON to MediaWiki:Cite-tool-definition.json, the cite menu can be populated with tools that create references containing specific templates. The content of the definition should be an array containing a series of objects, one for each tool. Each object must contain name, icon, template properties. An optional title property can also be used to define the tool title in plain text. The name property is a unique identifier for the tool, and also provides a fallback title for the tool by being transformed into a message key. The name is prefixed with visualeditor-cite-tool-name-, and messages can be defined on Wiki. Some common messages are pre-defined for tool names such as web, book, news, journal.

Example:

[ { "name": "web", "icon": "browser", "template": "Cite web" }, ... ]

(From: https://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/extensions/Cite/+/refs/heads/REL1_44/modules/ve-cite/ve.ui.MWReference.init.js#64)

Limitations

Tracked in Phabricator
Task T4700
Open

• The pipe trick and other pre-save transforms do not work within footnotes created with this extension.

همچنین ببینید

• Help:یادکرد
• Extension:Semantic Cite
• Extension:CiteThisPage