Cymorth:Rhagweld Ffynonellau

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 19% complete.
Other languages:
Bahasa Indonesia • ‎Cymraeg • ‎Deutsch • ‎English • ‎español • ‎français • ‎norsk bokmål • ‎norsk nynorsk • ‎svenska • ‎العربية • ‎中文 • ‎日本語 • ‎한국어
PD Sylwch: Drwy olygu'r ddalen hon, rydych yn cytuno i ryddhau eich cyfraniad dan drwydded CC0. Gweler Dalennau cymorth y Parth Cyhoeddus am ragor o gymorth.
PD
Example of a Reference Preview.png

Mae 'Rhagweld Ffynonellau' yn declyn sy'n dangos troednodyn pan rydych yn hofran ar y marc troednodyn. Mae'n rhan o estyniadau MediaWici, ac ar hyn o bryd yn un o'r teclynau Beta.

==Cefndir--

Caiff ei gynnal a'i ddatblygu gan WMF.

Ceir rhagor o fanylion ar eich dewisiadau.

Defnydd

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 evaluate 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><cite class="book">reference content</cite></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
  • beta feature on:
    • Yes German Wikipedia: 2019-04-04
    • Yes Arabic Wikipedia: 2019-04-04
    • all wikis that use the Popups extension (all Wikipedias & en, he and zh Wikivoyages): 2019-10-24

Links

Help with translation

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