METIS

Diferenças entre edições de "Guia de Edição"

(Criou página com: '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 [http://www.mediawiki.org/wiki/Help...')
 
Linha 11: Linha 11:
 
: '''Através do uso de links'''
 
: '''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: <nowiki>[[assim]]</nowiki> ). Se for criado um link para uma pagina que não existe, ele aparecerá a vermelho, <span style="color:red">assim</span>).  
+
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: '''<nowiki>[[assim]]</nowiki>'''). Se for criado um link para uma pagina que não existe, ele aparecerá a vermelho (<span style="color:red">assim</span>).  
 
<br>
 
<br>
 
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, <span style="color:blue">assim</span>.
 
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, <span style="color:blue">assim</span>.
Linha 412: Linha 412:
  
  
: '''Como criar classes/categorias'''
+
: '''Categorias'''
  
Objetivos das categorias:
+
<u>Objetivo das categorias</u>
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.
+
  
 
+
As categorias são utilizadas para '''classificar''' os artigos de acordo com o seu conteúdo.
Como criar:
+
 
<br>
 
<br>
As classes, e só as classes, podem também ser criadas através de um simples código inserido na página ou páginas que se pretendem classificar.
+
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.
<br> Para criar uma classe, então, usando código basta inserir '''Categoria:Nome da Classe/Categoria''' entre parêntesis retos (dois de cada lado). Esta ficará ativa a partir do momento em que a página for guardada.
+
<br> A uma mesma página, podem ser associadas as classes/categorias que se entender serem necessárias.
+
  
  
Como hierarquizar:
+
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.
  
<!--
 
* '''Como criar propriedades'''
 
  
As propriedades semânticas são os blocos básicos de construção de qualquer site semântico, pois permitem que se façam ligações entre os dados. Isto, por sua vez, permitem a articulação destes mesmo dados uns com os outros, promovendo a criação de contexto, de sentido.
+
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.  
<br> Uma '''propriedade''' é, assim, uma "característica" única e específica de uma dada peça de informação.
+
  
  
As propriedades podem ser criadas através da página especial '''Especial:CreateProperty'''.
+
<u>Como criar</u>
<br> O nome da propriedade, o tipo e algumas restrições podem ser determinadas a partir desta página.
+
  
 +
Para criar uma categoria, basta inserir '''Categoria:Nome da Classe/Categoria''' entre parêntesis retos (dois de cada lado), assim '''<nowiki>[[Categoria:Semântica]]</nowiki>''', no final de cada artigo.
 +
<br>
 +
Esta ficará ativa a partir do momento em que a página do artigo for guardada.
  
* '''Como criar predefinições'''
 
  
As predefinições dão "corpo" às propriedades. Elas são responsáveis por transformar os dados em informação semântica de facto e, muitas vezes, definem uma página como sendo de uma determinada categoria e de um determinado tipo.
+
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.
<br> As predefinições permitem, ainda, agregar informação, disponibilizando uma lista de todas as outras páginas que tenham algum tipo de relação com a página a que uma dada predefinição está associada.
+
  
  
A forma mais simples de criar uma predefinição é através da página especial '''Especial:CreateTemplate'''.
+
<u>Como hierarquizar</u>
<br> A partir desta página, é possível, então, determinar quais as propriedades que pertencem à predefinição, determinar como elas devem aparecer, assim como estabelecer mais alguns requisitos se necessário, entre outras coisas.
+
  
 +
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.
 +
<br>
 +
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.
  
* '''Como criar formulários'''
 
  
Construídas as propriedades e as predefinições, passa a ser possível construir os formulários.
+
: '''Formulários'''
<br> Os formulários permitem aos utilizadores criar e editar páginas dos mais diversos tipos, de forma muito simples.
+
 
<br> Deve existir um formulário por casa tipo de página. O formulário é responsável por "popular" a predefinição (ou predefinições) contida no tipo de página em questão.
+
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.
 +
<br>
 +
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).
 +
<br>
 +
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.
  
  
Os formulários podem ser criados, à semelhança do que acontece com os casos anteriores, a partir de uma página especial. Neste caso, a página é '''Especial:CreateForm'''.
+
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.
-->
+

Revisão das 16h53min de 20 de janeiro de 2016

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.