METIS

Guia de Edição

Revisão das 23h32min de 27 de abril de 2017 por Paulo Santos (Discussão | contribs)

(dif) ← Revisão anterior | Revisão atual (dif) | Revisão seguinte → (dif)

Este guia apresenta as regras básicas de edição das páginas deste site.


Para mais dicas sobre edição de páginas, consulte o Guia de Edição disponibilizado pela MediaWiki.
Para aprender mais sobre como utilizar semântica , consulte o Guia Semântico da MediaWiki.


Criação de Páginas

Através do uso de links

O site permite estabelecer ligações internas entre as páginas através do uso de uma simples sintaxe - envolver o nome de uma página em duplos parêntesis retos (ex: [[assim]]). Se for criado um link para uma pagina que não existe, ele aparecerá a vermelho (assim).
Para criar o novo artigo, então, basta clicar no link a vermelho para abrir a página de edição, digitar o texto pretendido e fazer "Gravar página". Uma vez criada a nova página, o link passará a aparecer a azul, assim.
Esta é, tipicamente, a melhor forma de criar uma nova página, porque garante, à partida, que o novo artigo estará ligado a partir de um qualquer lado no site.


A partir da barra de pesquisa

Introduzir o nome de uma página que não existe na barra de pesquisa (canto superior esquerdo da janela, ao lado do logótipo do site), fornece um link para a sua criação.


Usando o URL

É possível criar páginas através dos URL's do site.
O URL de um artigo tem, normalmente, o seguinte aspeto: http://www.xxx.yyy/index.php/ARTIGO.
Para criar uma nova página, basta, então, substituir "ARTIGO" pelo nome da página que deseja criar. Isto leva, à semelhança do que acontece nos exemplos anteriores, a uma página em branco que pode ser editada com o conteúdo pretendido.


Criar redirecionamentos

A criação de redirecionamentos é de extrema importância, na medida em que permite que outras pessoas pesquisem um dado artigo utilizando uma outra expressão.
Por exemplo, um artigo cujo o nome inicial era uma sigla e que foi redirecionado para o a designação completa, pode ser encontrado qualquer uma das expressões. A utilização de redirecionamentos permite, assim, que os artigos sejam encontrados mais facilmente, independentemente das preferências de pesquisa.
Mais ainda, e porque os títulos dos artigos devem ser o mais completos possível para evitar repetições ou redundâncias, os redirecionamentos permitem transferir um dado artigo para uma página com um nome mais adequado sem necessidade de copiar, colar ou eliminar conteúdo.


Edição de páginas

A edição de páginas é extremamente simples. Basta:

  1. Clicar no ícon mais à direita da barra superior da janela e selecionar a opção "Editar";
  2. Fazer as edições necessárias;
  3. Clicar na opção "Gravar Página", no fundo da página.


Edição do Resumo

A edição do "Resumo", que aparece no final de cada página, é armazenado juntamente com as edições feitas por cada utilizador e permite seguir com maior eficiência as mudanças que são feitas aos conteúdos.
Para isso, basta que seja preenchido com uma pequena indicação das mudanças que foram feitas, como por exemplo: "correção de um erro ortográfico" ou "adição de mais informação sobre o tema X".
O preenchimento desta secção é uma boa prática que deve ser cumprida para facilitar a gestão das edições.


Antever Resultado

A opção "Antever resultado" permite perceber como vão ficar as modificações feitas às páginas, antes de as gravar.
A utilização deste botão está, também, relacionada com o mapeamento de edições. De cada vez que uma edição é gravada, ela é registada como uma edição separada. Isto não é grande motivo de preocupação, mas a previsão dos resultados permite aperfeiçoar as alterações, eliminando a necessidade de criar novas edições e, por consequência, novos registos de edições, apenas para fazer correções menores.


Mostrar Alterações

Outra opção que, à semelhança da anterior, permite fazer uma melhor gestão do mapa de edições, é "Mostrar alterações". Esta permite comparar a nova versão de uma página com a versão anterior, isto é, comparar a versão com as novas alterações com a versão sem essas mesmas alterações.
Uma vez mais, isto permite que o utilizador se certifique de que as suas edições são as pretendidas e de que aparecem como deveriam, antes de as gravar.


Formatação de Páginas

A formatação de texto nas páginas do site pode ser feita através dos botões de edição que aparecem no canto superior esquerdo do espaço de edição ou utilizando a chamada wiki markup.
Esta linguagem consiste num conjunto de símbolos, como asteriscos, apóstrofes ou sinais de igual que desempenham uma função especial, muitas vezes dependendo da sua posição.


Formatação de Texto


Formatação de Caractéres


Texto em itálico
''itálico'' = itálico


Texto em negrito
'''negrito''' = negrito


Texto em itálico e negrito
'''''itálico negrito''''' = itálico negrito


Texto rasurado
<strike>texto rasurado</strike> = texto rasurado


Texto sem wiki markup
<nowiki>''texto sem markup'' </nowiki> = ''texto sem markup''


Formatação de Secções

Cabeçalhos em diferentes níveis

Para criar cabeçalhos automaticamente, basta colocar o título do cabeçalho entre sinais de igual, assim: = Cabeçalho de nível 1=.

O nível do cabeçalho é determinado pelo número de sinais de igual utilizados, sendo que um cabeçalho de nível 4, por exemplo, se define da seguinte forma: ==== Cabeçalho de nível 4 ====.
Quanto maior o número de sinais utilizados, mais se desce na escala/hierarquia e menor será o tamanho do cabeçalho.


Separador horizontal

Um separador horizontal é uma linha que atravessa a página horizontalmente, podendo ser útil para fazer separação entre conteúdos numa mesma página.
O separador é definido da seguinte forma:


texto antes
----
texto depois


A aparência do separador é conforme se mostra abaixo:


texto antes


texto depois


Lista de pontos

Para criar uma lista de pontos (bullet list), utilizam-se asteriscos (*). Quantos mais asteriscos forem utilizados, maior será o avanço do ponto.


Esta lista, por exemplo...
* Ponto a
** Ponto aa
*** Ponto aaa
* Ponto b


... fica assim:

  • Ponto a
    • Ponto aa
      • Ponto aaa
  • Ponto b


Lista numerada

Para criar uma lista numerada, utiliza-se o sinal de cardinal (#). Quantos mais sinais de cardinal forem utilizados, maior será o avanço, à semelhança do que acontece com o exemplo anterior.


Esta lista, por exemplo...
# Ponto a
## Ponto aa
## Ponto ab
# Ponto b


... fica assim:

  1. Ponto a
    1. Ponto aa
    2. Ponto ab
  2. Ponto b


Lista de definições

Uma lista de definições define-se da seguinte forma:
; item 1
: definição do item 1
; item 2
: definição do item 2


O resultado é este:

item 1
definição do item 1
item 2
definição do item 2


Avanço do texto

Criar avanços no texto pode ter muitas utilidades, desde criar hierarquias ou dependências entre os conteúdos, demarcar parágrafos ou até simplesmente organizar a aparência do texto.
Mas como é que isso se faz? É muito simples:


: Avanço único
:: Avanço duplo
Sem avanço

=

Avanço único
Avanço duplo

Sem avanço


Quanto maior for o número de sinais de dois pontos utilizados, maior será o avanço do texto.


Parágrafos

O software base deste site ignora as quebras de linha singulares, isto é, ignora a forma como os parágrafos são assumidos em editores de texto como, por exemplo, o Microsoft Word.
Os parágrafos singulares têm que ser forçados, através do uso da tag em HTML <br>.


HTML

Alguns termos em HTML também podem ser utilizados para formatar o texto.


Texto sublinhado

<ins>Texto sublinhado</ins> ou <u>Texto sublinhado</u> = Texto sublinhado


Texto rasurado

<s>Texto rasurado</s> ou <del>Texto rasurado</del> = Texto rasurado


Blockquotes

Os blockquotes podem ser utilizados para destacar uma parte do texto, como por exemplos, blocos de texto citado.


Texto antes
<blockquote>Carpe Diem</blockquote>
Texto depois

=

Texto antes

Carpe Diem

Texto depois


Comentários

Os comentários só podem ser vistos na área de edição das páginas e podem ser interessantes, especialmente neste contexto de contribuição múltipla, para deixar indicações a futuros contribuidores, para dar explicações adicionais que só interessem aos criadores dos conteúdos, etc.


Os comentários definem-se da sequinte forma:
<!-- Isto é um comentário -->


Tabelas


Tabelas básicas

A linguagem básica para criar uma tabela é a seguinte:

{|
|célula 1
|célula 2
|-
|célula 3
|célula 4
|-
|célula 5
|célula 6
|}


A aparência de uma tabela básica é, então:

célula 1 célula 2
célula 3 célula 4
célula 5 célula 6


Cabeçalhos de tabela

Para criar cabeçalhos nas tabelas, substitui-se a barra vertical (|) utilizada para marcar o início de cada célula, por um ponto de exclamação (!).


{|
!Cabeçalho 1
!Cabeçalho 2
|-
|célula 3
|célula 4
|-
|célula 5
|célula 6
|}

=

Cabeçalho 1 Cabeçalho 2
célula 3 célula 4
célula 5 célula 6


Estes cabeçalhos aparecem, por omissão, a negrito e centrados.


Imagens


Carregar imagens

O primeiro passo para inserir imagens num artigo é fazer o seu upload para os servidores do próprio site.


Para carregar uma imagem, os seguintes passos devem ser seguidos:

  1. Selecionar a opção Carregar ficheiro, que aparece debaixo do 3º ícon a contar da direita na barra superior da página;
  2. Seleccionar a opção Escolher Ficheiro, disponível na caixa Ficheiro de origem, e localizar a imagem no computador;
  3. Na caixa Descrição do ficheiro, dar um nome ou alterar o nome da imagem em Nome do ficheiro de destino (usar um nome descritivo, de preferência);
  4. Preencher o Resumo, se necessário;
  5. Selecionar a opção Carregar ficheiro.


Editar a página de descrição de uma imagem

Quando uma imagem é carregada para o site, uma página de descrição do ficheiro é automaticamente criada sob o nome atribuído à mesma.
A Página de descrição do ficheiro' deve ser preenchida com informação sobre qual a origem da imagem, sobre o seu copyright status ou qualquer outra informação descritiva que possa ser útil.


Utilizar imagens

Existem algumas opções de sintaxe para inserir as imagens carregadas nas páginas do site:

  1. [[Ficheiro:nomedoficheiro.extensão]] para mostrar uma imagem nas suas dimensões originais;
  2. [[Multimédia:nomedoficheiro.ogg]] para apresentar um link direto para o ficheiro em vez de mostrá-lo, quer este tenha por conteúdo uma imagem ou outros dados. Esta opção também permite, por exemplo, que se faça o download de uma imagem separadamente.


Opções de edição de imagens
Movimentação de Páginas

Mover uma página significa dar-lhe um novo nome. Para tal, basta:

  1. Selecionar a opção "Mover" (ícon mais à direita da barra superior da janela),
  2. Introduzir o novo nome,
  3. Selecionar "mover página".

Quando se move uma página, é importante saber que não só se altera o nome da mesma, como se move todo o seu conteúdo e o histórico de edições. Isto não acontece se apenas se copiar e colar conteúdos em diferentes páginas, podendo perder-se a informação sobre quem criou que conteúdo e quando.


Uma vez que esta operação resulta num redirecionamento, não deverão ocorrer quebras nos links. De qualquer forma, o utilizador deve verificar links noutras páginas que apontam para a página redirecionada e corrigir, se necessário.


Semântica

Categorias

Objetivo das categorias

As categorias são utilizadas para classificar os artigos de acordo com o seu conteúdo.
Para cada classe/categoria criada, é criada uma página sob esse nome, que agrega, em forma de lista organizada alfabeticamente, todas as páginas classificadas/categorizadas por essa mesma classe/categoria, assim como as suas subcategorias.


O uso de categorias permite relacionar conteúdos semelhantes debaixo de um mesmo chapéu temático e pesquisar os conteúdos de acordo com essas expressões.


Neste caso, as classes são utilizadas para criar o índice de temas de forma automática e para permitir a pesquisa mais ágil de informação e a articulação de conteúdos relacionados.


Como criar

Para criar uma categoria, basta inserir Categoria:Nome da Classe/Categoria entre parêntesis retos (dois de cada lado), assim [[Categoria:Semântica]], no final de cada artigo.
Esta ficará ativa a partir do momento em que a página do artigo for guardada.


A uma mesma página, podem ser associadas as classes/categorias que se entender serem necessárias. No entanto, é preciso tomar atenção que as categorias devem seguir uma hierarquia, sendo que as categorias associadas a um artigo devem ser sempre as mais baixas na sua respetiva hierarquia.


Como hierarquizar

Para criar uma hierarquia de categorias, a mais baixa na hierarquia, ou seja, a mais específica, deve ser colocada na página do artigo a classificar e a categoria de nível acima deve ser inserida na página da categoria base e assim sucessivamente, até atingir o nó mais alto.
A categoria de nível mais alto, ou seja, a categoria mais geral que engloba todas as outras, deve ser classificada com a categoria Temas por forma a garantir que esta hierarquia entra para o índice de temas.


Formulários

Os formulários são criados por forma a dar corpo às propriedades semânticas que ajudam a caracterizar os conteúdos dos artigos a um nível ainda mais específico que as categorias.
As propriedades permitem relacionar o conteúdo para além do seu tema; elas permitem relacionar conteúdo ao trazer a si expressões específicas, escolhidas de acordo com o tipo de conteúdo e com a sua finalidade, comuns nos diferentes artigos.


Neste caso, existe um único formulário semântico que deve ser associado aos artigos criados. Ele chama-se Artigos ("obrigado, Capitão Óbvio"") e tem como propriedades o nome do Autor do artigo, a data da última atualização e palavras-chave (termos MeSH).
Estas propriedades permitem, entre outras coisas, fazer a pesquisa por autor (por exemplo, saber quais são todos os artigos do autor X), por data de atualização (permite saber, por exemplo, quais os artigos publicados/editados mais recentemente) e/ou por palavras-chave.


Para criar ou editar uma página com o formulário, basta escrever form: Artigos na barra de pesquisa do site, inserir o título da página a criar ou editar na secção indicada e preencher as secções requisitadas.