Extensión:Cronograma de revisión

Manual das extensións de MediaWiki

RevisionSlider Estado de liberación: estable
Funcionamento	User interface
Descrición	Engade un control deslizante ó comparador de diferenzas para desprazarse facilmente entre as revisións
Autor(es)	Wikimedia Alemaña (WMDE)
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	1.25+
Cambios na base de datos	Non
Licenza	GNU General Public License 2.0 or later
Descarga	Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review
Asociadores que usa DifferenceEngineViewHeader GetPreferences
Quarterly downloads	152 (Ranked 38th)
Public wikis using	957 (Ranked 262nd)
Traduza a extensión RevisionSlider se está dispoñible en translatewiki.net
Problemas	Tarefas pendentes · Informar dun erro

A extensión Cronograma de revisións engade un control deslizante ó comparador de diferenzas, para que poida moverse facilmente entre as revisións.

Instalación

• Descargue e extraia os ficheiros nun directorio chamado «RevisionSlider», dentro do seu cartafol extensions/.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RevisionSlider
• Engada o seguinte código ó seu $LocalSettings:

  wfLoadExtension( 'RevisionSlider' );
  

•  Feito – Vaia a Special:Version no seu wiki para verificar que a extensión se instalou correctamente.

Uso

	O cronograma de revisións axuda a navegar e comparar as revisións na páxina de diferenzas.
	Once expanded, the RevisionSlider fetches data about the revisions and allows you to navigate and compare revisions on the diff page.
	Cada barra representa unha revisión da páxina. As barras superiores mostran un crecemento no tamaño da páxina e as barras inferiores mostran unha redución. Na imaxe, a revisión 1 representa o contido engadido, mentres que a revisión 2 representa a eliminación de contido.
	Para comparar certas revisións, seleccióneas utilizando os punteiros amarelo e azul. O punteiro azul controla a revisión máis recente e o punteiro amarelo controla a revisión máis vella. 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.
	Use as frechas de avanzar e retroceder para moverse a través do historial de revisións e mostrar as revisións máis novas e máis antigas.

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 "Non amosar o Cronograma de revisións" in your preferences under "Aparencia" → "Diferenzas".

Technical Background

Asociadores en JavaScript

O cronograma de revisións utiliza AJAX para recargar a páxina de diferenzas cando se seleccionan novas revisións. Unha vez recargada a páxina, actívanse os asociadores wikipage.content e wikipage.diff. Se o JavaScript de usuario ou a extensión de JavaScript actúa na páxina de diferenzas, quizais sexa necesario prestar atención a eses asociadores.

Exemplos

• A extensión de agradecementos https://phabricator.wikimedia.org/rETHA0b241d4d296f488dc7d3a1f4260aa0e426b2d7f5#1493b925
• O trebello wikEdDiff da Wikipedia en inglés https://en.wikipedia.org/w/index.php?diff=741585034&oldid=630494053&title=User:Cacycle/wikEdDiff.js

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.

Contexto

O cronograma de revisións é unha característica que materializa un dos principais anhelos da lista de desexos da comunidade alemá. Está desenvolvida polo equipo TCB da WMDE. A ferramenta está inspirada no trebello de DerHexer denominado revisionjumper e está baseada nun prototipo elaborado polo equipo Community Tech da WMF.

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