Editor Visual/Diffs

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page VisualEditor/Diffs and the translation is 9% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎polski • ‎português do Brasil • ‎slovenčina • ‎suomi • ‎čeština • ‎русский • ‎српски / srpski • ‎українська • ‎বাংলা • ‎中文 • ‎日本語

Desde 2017, VisualEditor proporciona diffs visuales (visualizaciones de diferencias visuales). Estos están disponibles en dos lugares en la interfaz: cuando se previsualizan los cambios en el documento antes de que el usuario guarde la página, y (como una función beta) dentro de la visualización estándar de diff de MediaWiki, se accede desde la página del historial. En ambos casos, la diferencia visual se muestra junto con la diferencia (diff) de wikitexto tradicional de dos columnas, y el usuario puede alternar entre las dos pantallas.

Las diferencias visuales tienen dos ventajas principales sobre las diferencias de wikitexto. La primera es que los editores puedan ver directamente los cambios que ellos y otros han realizado sin necesidad de entender wikitexto. Esto es particularmente útil cuando se observan cambios en estructuras gráficas como tablas; por ejemplo, si una edición elimina una columna de una tabla, la diferencia de wikitexto sería bastante difícil de entender, mientras que la diferencia visual sería inmediatamente obvia.

La segunda es que la tecnología se puede utilizar para representar con mayor precisión el cambio para el lector. Por ejemplo, si una edición intercambió dos párrafos (con o sin cambios a los párrafos), la diferencia visual identificará que esto es lo que ocurrió, mientras que una diferencia (diff) de wikitexto parece que se eliminó un párrafo y se agregó un párrafo completamente nuevo.

En paginas diff regulares

La mayoría de los ejemplos y capturas de pantalla a continuación tratan sobre el uso de diferencias visuales durante las vistas previas de página al editar. Sin embargo, las diferencias visuales del Editor Visual también se pueden usar en páginas de diffs regulares, en cualquier wiki que tenga instalado Editor Visual. Puede ver un ejemplo de esto en uso en la Wikipedia en español aquí.

Most of the examples and screenshots below are about using visual diffs during page previews when editing. However, VisualEditor's visual diffs can also be used on regular diff pages, on any wiki that has VisualEditor installed. You can see an example of it in use on the English-language Wikipedia here.

For wikis that have VisualEditor, there are several ways to activate this visual diff display:

  • Add the following to LocalSettings.php:
$wgVisualEditorEnableDiffPage = true;
  • If your wiki has a "Beta features" tab within Special:Preferences, and you want to make visual diffs an "opt-in" feature for users, you can add the following to LocalSettings.php:
$wgVisualEditorEnableDiffPageBetaFeature = true;
  • As seen in the Wikipedia example linked above, the visual diff mode can also be activated by simply adding "&visualdiff" to the URL of a diff page.

How it works

Screenshot showing some changes to an article. Most changes are highlighted with text formatting.
When you are finished editing the page, type your edit summary and then choose "Revisar tus cambios". In visual mode, you will see additions, removals, new links, and formatting highlighted. Other changes, such as changing the size of an image, are described in notes on the side.


Toggle button showing visual and wikitext options; visual option is selected.
Click the toggle button to switch between visual and wikitext diffs.


Screenshot showing the same changes, in the two-column wikitext diff display.
The wikitext diff is the same diff tool that is used in the wikitext editors and in the page history.


Examples

Technology used

Thalia Chan, Unifying editing and visual diffs, Wikimania 2017

Current limitations

  • No notices for changes to "invisible" page metadata , such as categories or TOC keywords.
  • Has issues with complex changes to tables.[3]
  • Unavailable on certain special pages:
    • Undo "diff" pages.[4]
    • Edit conflict pages[5]

History

Esta característica ha estado disponible como la primera herramienta de diferencias en el Editor Visual de escritorio desde la rama 1.31.0-wmf-20 en adelante (lanzada a la producción de Wikimedia el 6 de febrero de 2018). Antes de eso, era una herramienta secundaria de la rama 1.29.0-wmf-17 en adelante (lanzada a la producción de Wikimedia el 21 de marzo de 2017).

See also

Footnotes