Ajuda:Resumo de edição

Ajuda
Introdução
Criando páginas Navegação Buscando
Edição básica
Básico Ligações (Links) Cabeçalhos Listas Tabelas Imagens
Formatação avançada
Predefinições Criando predefinições Vídeos Math Citando fontes Notas de rodapé Referências da Bíblia Semântica do Banco de dados
Colaboração
Portal da comunidade Discussão de projetos Ajuda desejada Administração Doações

Quando editando uma página, um pequeno campo "Resumo" sob a caixa de edição principal se parece com isso:

É uma boa prática se preencher o campo Resumo de edição, ou adicionar-lhe conteúdo no caso de edição de seções, uma vez que ajuda a todos a compreender o que é alterado, como quando tomado conhecimento da história da página. É uma boa idéia configurar suas preferências de usuário (em edição) para "Avisar-me ao introduzir um resumo vazio". (Se você realmente quiser mantê-lo vazio, você pode apenas confirmar a mensagem ou introduzir um espaço em branco para evitar a mensagem.)

No caso de se aplicar uma substituição, forneça na linha o wikitexto contendo "subst:" no sumário de edição é especialmente útil, pois caso contrário a substituição não aparece como tal no histórico da página.

Propriedades

A caixa de sumário de edição pode conter uma linha de 200 caracteres, que tamanho não é mais do que 250 octetos (bytes) (a última restrição nunca tem um efeito em texto ASCII, mas note que em UTF-8 qualquer caractere não-ASCII ocupa 2 ou mais octetos). Se você tentar digitar ou colar mais, apenas os primeiros 200 caracteres serão exibidos e o restante será desconsiderado. Também, por exemplo a tentativa de adicionar 10 novos caracteres (no final ou no meio) a uma resumo já contendo 195 caracteres irá resultar nos primeiros 5 novos caracteres serem inseridos e os 5 segundos serem ignorados.

Na edição de resumos, links internos e interwiki funcionam, com algumas limitações, veja abaixo.

Outros códigos wikitext não são interpretados:

• Variáveis​​, modelos e funções do analisador não são expandidas.
• Ligações externas não funcionam
• Tags HTML não funcionam
• Os itálicos, em negrito, etc, não funcionam (sumários de edição são renderizados em itálico por padrão)
• Tags <nowiki> não funcionam; logo, por exemplo, [[a]] não pode ser exibido (ele vai ser renderizado como <nowiki>a</nowiki>), pode-se usar a (com um espaço de largura zero entre os colchetes do lado esquerdo) ou [ [a] ] em vez disso.

Ao pressionar antever resultado, uma visualização do sumário de edição é obtido, além de uma pré-visualização da página editada. Além disso, enquanto o resumo pode ser demasiado longo para ser visto na caixa de entrada sem a rolagem, a visualização é totalmente demonstrada até a capacidade total da caixa de entrada.

Links para uma seção

Um nome de âncora colocado entre /* e */ produz uma seta para a direita vinculando a uma âncora especificada na página, seguido do nome da âncora com a classe CSS "autocomment": → Texto da âncora. É semelhante ao wikitexto "<span class="autocomment">[[#Nome da âncora|→]] Texto da âncora</span>"".

O resumo da edição pode fazer uso múltiplo de nomes de âncora - isso pode ser útil durante a edição de várias seções de uma só vez, ou referindo-se a elas.

Os separadores são fornecidos automaticamente quando necessário (i.e. entre a sintaxe /* */ e texto em qualquer ordem). Por exemplo, o resumo de edição:

/* Foo */ teste /* Bar */ teste

é renderizado como:

→Foo - teste - →Bar - teste

Para obter mais flexibilidade esses links de ancoragem especiais podem ser substituídos por links para páginas comuns redirecionando para as âncoras desejadas, ver também abaixo.

Edição de seções

Quando editando uma seção existente, o título da seção é inserido no início do resumo de edição, fechado com marcações de /* e */, por exemplo /* Ligações externas */.

Se o nome da secção é alterado é útil mudar também no resumo de edição de acordo, de modo que a ligação para a secção ainda funcione como tal (até que o nome da secção seja mudado de novo, uma vez que as ligações não mudam retroactivamente).

Se você criar uma nova seção antes ou depois de uma seção existente, clicando em um link de seção "editar", altere ou apague o texto entre as marcações /* e */, para evitar confusão.

Detalhes da edição devem ser adicionados após este texto. No caso que você venha a fornecer um resumo muito longo se pode considerar a exclusão do título da seção, a fim de ficar dentro do limite de 200 caracteres, dependendo do que é mais importante.

Links internos e de interwiki em resumos de edição

Nos resumos de edição, ligações internas, incluindo a detecção de existência, e links interwiki funcionam. Usar dutos (pipes) destes links também funciona.

No caso da utilização de uma ligação com dutos, o duto ("|") é ignorado (mas a ligação funciona).

Os links podem ser verificados na visualização do sumário de edição.

O link páginas afluentes não lista links em sumários de edição.

Códigos de percentual

Se um link alvo contiver Um sinal de % seguido por dois dígitos decimais o link não irá funcionar, e o rótulo do link vai se mostrar como texto normal, sem colchetes e, no caso de uma ligação com pipes a informação para onde o link seria redirecionado é perdida.

Assim, enquanto que no wikitexto da página em si [[A evolução é o fundamento de uma visão de mundo imoral_%28Talk.Origins%29]] e [[A evolução é o fundamento de uma visão de mundo imoral (Talk.Origins)]] são equivalentes, dando A evolução é o fundamento de uma visão de mundo imoral_(Talk.Origins) e A_evolução_é_o_fundamento_de_uma_visão_de_mundo imoral_(Talk.Origins), apenas este último funciona em um sumário de edição.

Em uma URL, todos os caracteres que não os [[-:/.]], os dígitos 0-9, e as letras simples A-Z, a-z, are coded with once or twice a %-sign followed by two hexadecimal digits (follow the link to confirm that these four characters are not affected).

Os códigos ocorrem na prática, quando um nome de página contém caracteres especiais (caracteres para além dos mencionados), e um link para uma seção da página é feita copiando parte da URL para essa seção, que por sua vez é produzido por um link de TOC. Este não é o caso, se somente o nome da secção contém caracteres especiais, porque, em uma URL que eles são codificados com um ponto seguido pelos dígitos hexadecimais. Assim, a âncora em si não dá problemas, o facto de que existe uma âncora torna conveniente usar a URL, que, isto sim, dá este problema.

Soluções alternativas para obter um link funcionando no sumário de edição incluem:

• usar a URL, mas substituir os códigos pelos caracteres envolvidos com a mão (isto não é conveniente em idiomas em que muitos caracteres estão codificados).
• aplicar uma redireccionado para chegar à página.
• aplicar o link TOC, obter a parte da URL do nome da página, se for o caso adicionar o prefixo interwiki novamente, e usar o resultado como destino do link na página, bem como no sumário de edição.
• montar a combinação nomedapagina, #, nome da seção em si mesmo; o nome da página pode ser copiado do cabeçalho da página, ou, se ele tem um redirecionamento curto, o nome da página também pode facilmente ser digitado: obtemos w:WP:VPT#Abc onde a âncora é normalmente mais fácil de copiar (sendo mais longa do que aqui), mas o resto é apenas digitado.

Flexibilidade

Uma vez que resumos de edição não podem ser editados depois de salvar a página, uma mudança do conteúdo de um link alvo pode ser um problema, e isso freqüentemente acontece: a mudança para um arquivo é, muitas vezes até mesmo previsível.

• No caso de uma mudança uma página de redirecionamento é criada, no entanto, quando o nome antigo é necessário para uma nova página, o link não é destinado mais corretamente.
• No caso de uma ligação a um ponto, em que o nome da seção é alterado, uma âncora pode ser feita com o nome antigo da seção.
• No caso de um link para uma seção, se o conteúdo é movido para outra seção, o link ainda irá direcionar para a seção antiga.
• No caso de um link para uma âncora explicitamente colocada, a âncora pode ser movida com o conteúdo, uma vez que outros links para a âncora precisam alcançar a outra posição também.

Antecipando esses problemas pode-se fazer o seguinte:

• fazer um link para uma página com um nome que precisa e claramente descreve o lugar a ser alcançado
• Se esta página não existe, criar um redirecionamento para a página desejada, possivelmente com uma âncora

Enquanto o sumário de edição permanece o mesmo por tempo indeterminado, o redirecionamento pode ser alterado sempre que necessário.

Este método também é útil para substituir o link automática para seção: proporciona flexibilidade no que se refere à renomeação de seções.

O recurso "Publicar um comentário"

Ao iniciar um novo tópico em uma página de discussão ou página com __NEWSECTIONLINK__, o recurso "Publicar um comentário" pode ser usado. Clique no sinal de mais ('+') próximo ao link de editar (MonoBook skin). Uma caixa rotulada "Assunto/cabeçalho" aparece antes da caixa de edição principal e a caixa de o texto "Resumo de edição" não irá aparecer. Texto digitado no campo assunto torna-se tanto o resumo de edição quanto um novo título (que é adicionado ao final da página), e texto inserido na caixa de edição principal é inserido abaixo deste título.

Resumos automáticos

Em certas circunstâncias, um resumo automático é gerado quando uma edição é salva sem um. Isto é ligeiramente diferente do resumo adicionado durante a edição de uma seção, pois pode ser modificado pelo utilizador antes de salvar.

Situação	Página	Texto
Criando ou substituindo uma página com um redirecionamento ('$1' é substituído com o destino do redirecionamento)	MediaWiki:Autoredircomment	Redirecionando para [[$1]]
Remoção de todo o texto de uma página	MediaWiki:Autosumm-blank	Branqueando página
Removendo a maior parte do texto de uma página, ou editando uma página curta ('$1' é substituído com o texto da página)	MediaWiki:Autosumm-replace	Substituindo página com '$1'
Criando uma nova página ($1 é substituído com o texto da página)	MediaWiki:Autosumm-new	Nova página: $1

Com exceção do resumo automático ao criar um redirecionamento, que geralmente diz tudo o que precisa ser dito, estes não são um substituto para um sumário de edição adequada - você deve sempre deixar um resumo significativo, mesmo nos casos acima. Eles são, no entanto, úteis em fornecer algum contexto para edições feitas por usuários inexperientes que não estão cientes da importância de resumos de edição, e para detectar vandalismo.

Locais onde o sumário de edição aparece

O sumário de edição aparece em itálico negro nos seguintes locais:

Permanentemente:

• Histórico da página - lista de edições de uma página especificada; também mostra o tamanho do wikitexto em bytes.
• Contribuições do usuário - Lista de edições de um usuário específico
• Páginas vigiadas - lista de mudanças recentes às páginas vigiadas (usuários logados somente); also shows the change in size of the wikitext in bytes
• Diferenças da página - mostra a diferença entre duas edições
• Mudanças recentes / Mudanças recentes melhoradas - lista de todas as edições recentes, também mostra a mudança no tamanho do wikitexto em bytes
• Alterações relacionadas - lista de mudanças recentes a páginas ligadas a uma página especificada; também mostra a mudança no tamanho do wikitexto em bytes
• Lista de novas páginas - mostra o resumo de edição da criação, também mostra o tamanho atual do texto wiki em bytes.

* Use a lista de páginas vigiadas melhorada para ver todas as alterações recentes nas páginas vigiadas, e não apenas a última alteração em cada página.

Veja também Ajuda:acompanhando alterações.

Resumo de upload de arquivos (File upload summary)

Ao fazer o upload de uma imagem voce pode fornecer um resumo de upload. Isso serve para múltiplas finalidades:

• como segunda parte do sumário de edição criado automaticamente do log de ​​upload (a primeira parte dando o nome do arquivo)
• como texto na entrada do histórico da imagem
• no caso em que o nome do arquivo da imagem é novo:
  • como resumo de edição para a criação da página de imagem
  • como wikitexto para a parte modificável da página de imagem, o qual inclui as seguintes possibilidades:
    • descrever brevemente a imagem
    • fornecer links internos ou externos
    • chamar prédefinições
    • especificar uma ou mais categorias, para as quais a imagem está relacionada

A capacidade do resumo de upload é uma linha de 250 caracteres; no registro de upload a última parte pode ficar de fora, porque este pode conter até 255 caracteres, incluindo o "nome de arquivo"carregado"".

Note-se que não há nenhuma função de visualização para verificar o código para as ligações, chamadas de predefinições e tags de categoria, mas é claro que, se for necessário, pode-se editar a página da imagem após o upload, para corrigir erros e também para estender o texto.

Mudando um sumário de edição

Mudar um sumário de edição é complicado e requer importação (portanto, isso tem que ser habilitado na wiki e o usuário precisa ter esse direito de usuário): exportar a página com a história, apagar a página, faça a alteração no arquivo xml, e importá-la novamente. To change the edit summary of the current revision one can also export the page without history, delete the page, restore it except the last revision, make the change in the xml file, and import it again.

The import log shows the import of the page, with user name, date, time, and number of revisions. The deletion log shows the deletion and, if applicable, restoration, with user name, date, and time. The "View and restore deleted pages" feature shows deleted revisions. There is no easy way (like a diff) to see what changes were made. In the case of multiple deletions and imports or restorations it is not recorded which revisions existed when in the regular page history, so it is not possible at all to know what was changed in the last delete/import operation.

Searching

The CreationWiki search function can not search edit summaries, and they are not indexed by external search engines.

Recommendations

Always fill in the summary field. This is considered an important guideline. Even a short summary is better than no summary. An edit summary is even more important if you delete any text; otherwise, people may question your motives for the edit. Also, mentioning one change but not another one can be misleading to someone who finds the other one more important; add "and misc." to cover the other change(s).

Accurate summaries help people decide whether it is worthwhile for them to check a change. We've found that summaries often pique the interest of contributors with expertise in the area. This may not be as necessary for minor edits, but "fixed spelling" would be nice even then.

In the case of a small addition to an article, it is highly recommended to copy the full text of this addition to the summary field, giving a maximum of information with a minimum of effort. Put ft in front, as an abbreviation of "full text" (see the Abbreviations section for other abbreviations). This way, readers of the summary will be unlikely to check the page itself as they already know the extent of the edit. It also makes it easy for color-blind or visually impaired readers to see punctuation and other tiny changes that may be difficult to discern. It also helps users to check Recent changes, Page history and User contributions (see below) very efficiently, and reduces the load on the servers.

If the addition is more than 200 characters, so it does not fit fully in the edit summary box, you should write a short summary of the changes you have introduced into the article. For an addition of, say, 400 characters you can also save time by simply copying that into the summary field. The excess will fall off, and the first 200 characters will usually be acceptable as a crude "summary".

Unfortunately you can copy only one line of text from the edit box into the edit summary box. The contents of further lines can be pasted at the end of the line. Thus, for example, a bulleted "see also" list is cumbersome to put in the edit summary box. One possible workaround for a new list is putting the list on one line, separated by the asterisks for the bullets, copying it to the edit summary box, and then, in the main edit box, inserting line breaks before the asterisks.

In addition to a summary of the change itself, the summary field may also contain an explanation of the change; note that if the reason for an edit is not clear, it is more likely to be reverted, especially if you have deleted some text. To give a longer explanation, use the Talk page and put in the edit summary "see Talk".

After saving the page, the summary cannot be edited — another reason to avoid spelling errors.

In the case of important omissions or errors in the edit summary, you can make a dummy edit just to put the correction in the edit summary.

Abbreviations

Experienced users, especially those with many edits to make, will often use abbreviations in edit summaries (as well as log entries), in order to save time; for example, "rv" for "revert". These should be used with care, as they can be confusing for inexperienced users, but they are generally fine for small edits such as formatting and grammar changes. See Edit summary legend for a list of commonly used abbreviations in edit summaries.

Action summary

Protection or move action also generate entry in page history. This entry is also limited to 255 octets, and consists of action description and user provided comment.

Action description, such as "moved XX to YY", is created from current system messages in site language. As a result, it is not localized by changing user interface language.

User comment, if long enough, can be truncated by the system. Then its longer version, which doesn't have to share 255 octets with action summary, can be found in protection/move logs.