הרחבה:סרגל הגרסאות

From mediawiki.org
This page is a translated version of the page Extension:RevisionSlider and the translation is 36% complete.
Outdated translations are marked like this.
MediaWiki extensions manual
RevisionSlider
Release status: stable
Implementation User interface
Description הצגת סרגל בדפי "השוואה בין גרסאות" המאפשר לנווט בקלות בין הגרסאות
Author(s) ויקימדיה גרמניה (WMDE)
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.25+
Database changes No
License GNU General Public License 2.0 or later
Download
Quarterly downloads 65 (Ranked 87th)
Public wikis using 957 (Ranked 262nd)
Translate the RevisionSlider extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

הרחבת סרגל הגרסאות מוסיפה סרגל בדפי "השוואה בין גרסאות", שבאמצעותו ניתן לנווט ולעבור בקלות בין הגרסאות השונות.

התקנה

  • Download and move the extracted RevisionSlider 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/RevisionSlider
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'RevisionSlider' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

אופן השימוש

סרגל הגרסאות עוזר לכם לנווט ולהשוות גרסאות בדפי "השוואה בין גרסאות".

Once expanded, the RevisionSlider fetches data about the revisions and allows you to navigate and compare revisions on the diff page.

כל סרגל מציין גרסה של דף.

הסרגלים שלמעלה מציגים את העלייה בגודל הדף, והסרגלים שלמטה מציגים את הירידה בגודל.
בתמונה זו, גרסה 1 מציינת תוכן שנוסף לדף, וגרסה 2 מציינת הסרה של תוכן.

כדי להשוות גרסאות מסוימות, בחרו את הגרסאות באמצעות הסמן הצהוב והסמן הכחול. הסמן הכחול שולט בגרסה החדשה, והסמן הצהוב שולט בגרסה הישנה.

There are several ways to do this:
  • You can drag and drop the knob to the desired position on the slider.
  • You can click on the desired position on the slider line.
To select the newer revision, click on the blue line, and for selecting the older revision, click on the yellow line. To indicate which revision you're about to select, a preview of a blue or yellow knob appears and the bar turns blue or yellow.
  • You can click into the bar above the middle line (to select the newer revision) or below the line (to select the older revision). This also gives you a preview of the knob on the middle line.

If you move the blue knob to a position left of the yellow knob, the yellow knob is automatically moved along, and vice versa if you move the yellow knob to a position right of the blue knob.

השתמשו בחִצֵי הניווט כדי לנווט בהיסטוריית הגרסאות ולצפות בגרסאות ישנות או חדשות יותר.

Opt-out

If you are not using the RevisionSlider at all and also don't want to see the collapsed RevisionSlider bar at the top of the diff page, you can opt-out by checking "לא להציג את סרגל הגרסאות" in your preferences under "מראה" → "הבדלים בין גרסאות".

Technical Background

JavaScript Hooks

The RevisionSlider uses AJAX to reload the diff page when new revisions are selected. Once the page has been reloaded both the wikipage.content and wikipage.diff hooks are fired. If user JavaScript or extension JavaScript acts on the diff page you may need to listen to these hooks.

Examples

API calls & fetching data

Unless expanded, the tool is not doing any API calls. Only when the user expands the slider, it fetches data about revisions (revision-id, timestamp, user, comment, size and flags). The tool only fetches data for revisions that are currently visible on the screen (maximum 500 revisions) and data about additional revisions is only loaded when the user navigates back or forth on the timeline using the arrows.

רקע

סרגל הגרסאות[1] הוא אחת התכונות המבוקשות ביותר ברשימת המשאלות של הקהילה הגרמנית,[2] והוא מפותח על־ידי צוות ה־TCB של ויקימדיה גרמניה. סרגל הגרסאות קיבל השראה מגאדג'ט של DerHexer ("קפצן הגרסאות"), והוא מבוסס על הדגמה של צוות הקהילה הטכנית של קרן ויקימדיה.

Notes (for rather technical audience) on RTL issues discovered while developing the extension have been published on the separate subpage.

הערות שוליים