VisualEditor/Diffs/pt-br

Desde 2017, VisualEditor fornece  (visores de diferença visual). Eles estão disponíveis em dois lugares na interface: ao visualizar as alterações no documento antes de o usuário salvar a página e (como um recurso beta) na exibição padrão do MediaWiki, acessada a partir da página do histórico. Em ambos os casos, o diff visual aparece ao lado do diff de wikitext de duas colunas tradicional, e o usuário pode alternar entre os dois monitores. These are available in two places in the interface: when previewing changes to the document before the user saves the page, and (as a beta feature) within the standard MediaWiki diff display, accessed from the history page. In both cases, the visual diff shows up alongside the traditional two-column wikitext diff, and the user can toggle between the two displays.

Os diffs visuais têm duas vantagens principais sobre os diffs do wikitext. A primeira é que os editores podem ver diretamente as mudanças que eles e outros fizeram sem precisar entender wikitext. Isso é particularmente útil ao analisar alterações em estruturas gráficas, como tabelas; por exemplo, se uma edição excluir uma coluna de uma tabela, o diff do wikitexto seria bastante difícil de entender, enquanto a diferença visual seria imediatamente óbvia. The first is that editors can directly see the changes they and others have made without needing to understand wikitext. This is particularly helpful when looking at changes to graphical structures such as tables; for example, if an edit deletes a column from a table, the wikitext diff for it would be hard to understand, while the visual diff would be immediately obvious.

A segunda é que a tecnologia pode ser usada para representar com mais precisão a mudança para o leitor. Por exemplo, se uma edição trocou dois parágrafos (com ou sem alterações nos parágrafos), o diff visual identificará que isso foi o que ocorreu, enquanto um diff de wikitext faz parecer que um parágrafo foi excluído e um parágrafo inteiramente novo foi adicionado. For example, if an edit swapped two paragraphs (with or without changes to the paragraphs), the visual diff will identify that this is what occurred, while a wikitext diff makes it appear that a paragraph was deleted and an entirely new paragraph was added.

Em páginas diff regulares
A maioria dos exemplos e capturas de tela abaixo são sobre o uso de diferenças visuais durante as visualizações da página durante a edição. No entanto, as diferenças visuais do Editor visual também podem ser usadas em páginas de diferenças regulares, em qualquer wiki que possua o Editor visual instalado. Você pode ver um exemplo disso em uso na Wikipédia em inglês aqui. 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.

Para wikis que possuem o Editor Visual, existem várias maneiras de ativar este display visual de diferenças:


 * Add the following to LocalSettings.php:
 * 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:
 * 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.

Como funciona
[[File:VisualEditor_visual_diff_tool_-_visual_diff.png|alt=Screenshot mostrando algumas mudanças em um artigo. A maioria das mudanças é realçada com formatação de texto.|left|thumb|300px|Quando terminar de editar a página, digite o resumo da edição e escolha "".

No modo visual, você verá adições, remoções, novos links e formatação destacados. Outras alterações, como alterar o tamanho de uma imagem, são descritas em notas ao lado.]]





Tecnologia usada



 * Google Diff, Match and Patch
 * TreeDiffer.js

Limitações atuais

 * Nenhum aviso para alterações em "invisible", como categorias ou palavras-chave do sumário.
 * Tem problemas com alterações complexas em tabelas.
 * Indisponível em determinadas páginas especiais:
 * Desfazer páginas "diff".
 * Editar páginas de conflito

History
Este recurso está disponível como a primeira ferramenta de comparação no VisualEditor da área de trabalho da ramificação 1.31.0-wmf-20 em diante (lançada para a produção da Wikimedia em 6 de fevereiro de 2018). Antes disso, era uma ferramenta secundária da ramificação 1.29.0-wmf-17 em diante (lançada para a produção da Wikimedia em 21 de março de 2017). Before that, it was a secondary tool from the 1.29.0-wmf-17 branch onwards (released to Wikimedia production on 21 March 2017).

Ver também

 * 2016 Community Wishlist Survey/Categories/Reading#CW2016-R094
 * Community Tech/Improved diffs