Help:Reference Previews/fa

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Help:Reference Previews and the translation is 4% complete.

Other languages:
Deutsch • ‎English • ‎français • ‎norsk nynorsk • ‎العربية • ‎فارسی • ‎日本語
PD توجه: هنگامی که شما این برگه را ویرایش کنید، در واقع شما توافق کرده‌اید که براساس کریتیو کامانز ۰ با ما همکاری می‌کنید. برای داده‌های بیشتر

برگهٔ راهنما برای دامنه‌های عمومی را نگاه کنید.


PD
Example of a Reference Preview.png

The Reference Previews feature shows a preview of a footnote when you hover over its footnote marker. This feature is part of the MediaWiki extension Popups, which is used for Page Previews. It's currently a beta feature on first wikis.

Background

The Reference Previews feature aims to fulfill a wish from the German-speaking community's Technical Wishlist and is developed by WMDE's Tech team, with support from the WMF’s Reading Web team. The design for this feature is being developed by the WMF.

More information can be found on the main project page on Meta.

استفاده

Activate the feature

Reference Previews will first be available as a beta feature. In order to use it, you have to

Look and behavior

Reference Previews elements.png

Scope of the very first version of this feature:

  • The pop-up opens when you hover over or when you click on a footnote marker.
  • It gives a preview of the footnote as it is shown at the bottom of the page. Inside the preview, all kinds of footnote content (text, images, tables, …) can be displayed.
  • Reference Previews look like Page Previews. This way, all pop-ups have the same design, no matter if you hover over a page link or a footnote marker.
  • At the top of the pop-up, the reference type is shown (more info below).
  • For short footnotes, the pop-up window adjusts to a smaller size. If the footnote size exceeds the maximum pop-up size, you can scroll to read the whole footnote.
  • Clicking on the link "Jump to reference" brings you to the actual footnote in the footnote section.
  • Links that are part of a footnote open in a new tab.
  • After the beta phase, a settings cog will take you to your user settings for this feature.

Displaying the reference type

Example of a footnote preview (status April 2019)

First tests have shown that displaying the type of a reference can help readers judge its trustworthiness more quickly; e.g. a journal publication is more trustworthy than a blog post.

This is how the categorization works:

  • Currently there are four types of references defined: Web Reference, Journal Reference, Book Reference and News Reference. Apart from that there is always a generic "default" type, which is simply named Reference.
  • Technically speaking, the type of a reference is defined by CSS-classes, e.g. <cite class="journal"> for journal references. These classes are set in the <cite> element in a reference's content (more info).
  • On most wikis, you can assign a class to a reference by using templates. For example, the English {{cite}} templates specify their respective class already. Classes can be added to other templates as well.
  • Alternatively, you can add a cite class directly into a ref tag, e.g. <ref>.
  • References without cite tags and classes (e.g. plain <ref> tags) are shown as "Reference".

JavaScript

The preview uses JavaScript. If you don't have JavaScript activated, you'll get the current view: Footnote markers are jump marks and there's no preview.

Deployment roadmap

  • Yes test.wikipedia.org (testwiki): 2019-02-28
  • small beta:
    • Yes German Wikipedia: 2019-04-04
    • Yes Arabic Wikipedia: 2019-04-04
  • full beta:
    • all Wikipedias: tba

Links

Reference Previews

Page Previews

Help with translation

The software messages for this feature can be translated on translate wiki. Any help is much appreciated!