Tutorial da MediaWiki

De WikiCTI
Revisão de 18h00min de 9 de abril de 2009 por Admin (discussão | contribs)
Ir para navegação Ir para pesquisar

Com o objetivo de familiarizar a utilização da wiki e sua sintaxe, este tutorial descreve as principais regras de sintaxe e aplicações auxiliares para gerar o conteúdo no formato desta ferramenta.

Vale ressaltar inicialmente que:

  • Adicionou-se o editor FCKEditor para facilitar a edição dos arquivos, para habilitá-lo, basta apenas clicar sobre o ícone: [Rich Editor] , durante a edição do arquivo



Como criar uma conta

Para criar uma conta clique no botão, disponível canto superior direito, "Entrar". Será então mostrada a página de entrada na conta onde terá de introduzir os dados se já tiver uma conta registrada, caso contrário terá de clicar em "Criar uma conta". Será mostrada uma página onde terá de fornecer os dados para criar uma conta. Os seguintes dados devem ser fornecidos:

  • Seu nome de usuário: Introduza o nome de usuário que pretende para a sua conta;
  • Sua senha: Defina uma senha segura, se possível com maiúsculas, minúsculas, algarismos e sinais gráficos com o mínimo de 8 ou 10 caracteres;
  • Endereço de e-mail: Introduza o seu endereço, caso se esqueça da senha, poderá pedir que lhe seja enviada para o seu endereço de e-mail. Poderá também definir nas preferências de usuário se deseja receber e-mails de outros usuários através doWiki. Note que o endereço de e-mail não é visível a outros usuários, a não ser que receba um e-mail de outro usuário e lhe envie outro de resposta ou caso a sua conta de e-mail não possa receber mais e-mails;
  • Nome verdadeiro: Introduza o seu nome completo;
  • Lembrar a minha palavra-chave entre sessões: Ativando esta opção, não terá de introduzir o nome e a senha em cada sessão ao entrar no Wiki. Não é aconselhável usar esta opção a partir de um computador de acesso público.


A Ilustração 1 mostra a página inicial para cadastramento de usuário:

Wikilogin.jpg


Como começar uma página

Existem vários métodos para criar uma página:

  • A partir de um link em vermelho: Existem artigos no Wiki em que o texto contém algumas ligações a vermelho, indicando que o artigo não existe, e são semelhantes a Exemplo de título de artigo (note que este exemplo não é uma ligação funcional, para que não criem acidentalmente um artigo com este título). Ao clicar numa ligação a vermelho, irá ter a uma nova página, na qual pode começar a editar, mas confirme antes se o título está correto;
  • A partir de uma pesquisa: Escreva no campo "busca" (lado esquerdo da página) o título do artigo e clique no botão “Vai”. Se aparecer um artigo já existente, edite-o. Se aparecer uma listagem de artigos, verifique se não existe um semelhante para editar, caso contrário clique na ligação a vermelho onde diz: Não existe uma página com o título "nome do artigo". Pode criar esta página;
  • A partir da barra de endereço do seu navegador (browser): Digite na barra de endereço: http://www.baseconhecimento.dirpd.ufu.br/Nome_da_nova_pagina nome do artigo substituindo nome do artigo pelo título do artigo a criar. Se o endereço que introduziu o conduzir a um artigo já existente, pode editar esse mesmo artigo.

Caso contrário aparece a seguinte mensagem: " (Não há atualmente nenhum texto nesta página)". Clique então na aba "editar" para introduzir dados no artigo.


Como editar uma página

É muito fácil editar uma página Wiki. Basta clicar no link Editar que está na parte superior, inferior, ou na lateral da página Wiki, para que ela seja modificada, ou então clicar em Discussão e em seguida em "Editar" para escrever na página de discussão correspondente. De uma forma ou outra, você será levado a uma outra página com uma caixa de texto editável preenchida com o conteúdo da própria página. Depois de escrever, digite um resumo da edição bem curto no pequeno campo logo abaixo da caixa de edição e pressione o botão "Salvar página"! Tem ainda a opção de fazer uma previsão do texto que acabou de escrever antes de gravá-lo, caso queira. O sistema está feito de modo que o pressionar do botão "Enter" enquanto a caixa de edição não está ativa (não há nenhum cursor em seu interior) pode provocar o mesmo efeito de pressionar o botão “Save”. Um artigo da Wikipédia deve conter, além de um título bem concebido e o conteúdo que deseja inserir, as seguintes três partes:

  • Os interlinks ou ligações internas;
  • A(s) categoria(s);
  • Os interwikis ou ligações multilinguísticas;


Formatação

Geral

O Wiki é um editor baseado em marcações de texto. Note também que é possível, embora não recomendável, utilizar a maioria das marcações HTML.

A Ilustração 2 mostra as possíveis formatação no Wiki.

Wikiformatacao.jpg

Parágrafos

Para iniciar um novo parágrafo, deixe uma linha em branco. Uma nova linha também pode ser iniciada com a tag do HTML <br />.


Links

Para incluir um link, utilize a marcação [[o link]].


Fontes

Para alterar o tamanho da fonte utilize as marcações big e small:

  • <big>texto</big> para um tamanho grande;
  • <small>text</small> para um tamanho pequeno.

Para alterar a cor da fonte utilize a marcação font:

  • <font color=#0000FF>text</font>.


Imagens

As imagens e outros arquivos não texto servem para ilustrar e melhorar tanto a visualização como o entendimento do artigo. É preciso observar que assim como para os textos, as regras de boa conduta devem ser respeitadas quanto aos créditos e limitantes das imagens. Para apresentar uma imagem numa página utiliza-se a marcação [[imagem]]. Na página do artigo que usará a imagem utilize uma marcação semelhante a esta:

[[imagem:nome_do_ficheiro.jpg|estilo|alinhamento|dimensão|legenda]]

Os parâmetros apresentados em itálico são opcionais e separados com uma barra vertical ( | ), podendo ser combinados em qualquer ordem, exceto a legenda que é sempre o último campo (mesmo que não se indique uma, ver abaixo). Qualquer parâmetro que não seja reconhecido é ignorado.


Estilo

Existem três estilos diferentes para apresentar as imagens:

  • frame - A imagem é apresentada com uma moldura; a legenda é apresentada

abaixo da imagem, dentro da moldura;

  • thumbnail ou thumb - Igual a frame, mas as dimensões da imagem são

reduzidas e a imagem é apresentada como "flutuante", o que significa que o texto irá fluir em torno dela. É ainda apresentado um pequeno ícone na área da legenda que indica que é possível ver uma versão ampliada da imagem (clicando nela);

  • por omissão - Omitindo o estilo a imagem é apresentada sem moldura; a

legenda apenas é apresentada quando o ponteiro do mouse é colocado sobre a imagem.

Alinhamento

A imagem pode ser alinhada à esquerda, ao centro ou à direita da página. Para isso usase:

  • left - Alinha a imagem à esquerda;
  • right - Alinha a imagem à direita;
  • center - Alinha a imagem ao centro;
  • none - não alinha a imagem e não permite texto ao seu redor (esquerda ou

direita);

  • por omisão - não alinha a imagem, apresentando-a em linha com o texto.

Dimensão

A imagem pode ser apresentada com uma dimensão diferente da que foi carregada. Para isso especifica-se a dimensão horizontal que se deseja, seguida das duas letras px (por ex: 100px), sendo a imagem redimensionada de modo proporcional:

[[imagem:nome_do_ficheiro.jpg|100px]]

Especificando apenas a dimensão da imagem só é possível reduzir o seu tamanho (se indicar uma dimensão superior ao da imagem isso é ignorado). Para ser possível aumentar o tamanho da imagem é necessário usar o estilo thumb.

Legenda

O último dos parâmetros é usado como texto da legenda, um texto descritivo, não necessariamente o mesmo que esteja na página descritiva da imagem. Adicionalmente, a legenda é apresentada sob a imagem e dentro da moldura nos estilos frame e thumb. Para indicar uma legenda em branco basta terminar com uma barra vertical:

[[imagem:nome_da_imagem.jpg|right|]]

O texto da legenda é sempre apresentado quando o ponteiro do mouse é posicionado sobre a imagem. A Ilustração 3 mostra alguns exemplos de como utilizar as imagens no Wiki.


Wiki imagens.jpg



Tabelas

Uma tabela é construída linha por linha, coluna por coluna, isto é, define-se para cada linha, as suas colunas (células). Assim:

  • Para iniciar uma tabela: {|
  • Para colocar uma legenda (opcional): |+
  • Para iniciar uma linha: |-
  • Cada coluna começa com: |
  • Cada coluna do cabeçalho pode iniciar-se com: !
  • Para concluir a tabela: |}

Por fim, é possível formatar cada uma das células individualmente, ou por linha. Os parâmetros são adicionados imediatamente a seguir às marcações de abertura de linha, coluna ou tabela: são parâmetros HTML e não constam no objetivo deste tutorial. Porém, como referência, aqui fica:

  • Para a tabela: {| border=1
  • Para todas as células de uma linha: | - align=”right”
  • Para uma célula (coluna): | align=”center” | texto

O trecho de código abaixo mostra um exemplo de como fazer uma tabela no Wiki. 

{|border=2 width="60%"
|+ Tabela 1 - Exemplo
|-
|
! 1
! 2
|-
! 3
| align="right" | alinhado à direita
| align="center" | centrado
|-
! 4
| align="center" | centrado
| bgcolor="#CCCCCC" | fundo cinzento
|}
Tabela 1 - Exemplo
1 2
3 alinhado à direita centrado
4 centrado fundo cinzento


Upload de arquivo

Para realizar o upload de um arquivo, clique no item “Carregar Arquivo” do menu “Ferramentas”, localizado canto esquerdo da página. Para realizar o upload, o usuário tem logar no wiki com o seu login e senha.

Para carregar um arquivo, basta o usuário clicar no botão “Arquivo” e selecionar o arquivo de deseja carregar para o Wiki. O campo Nome do ficheiro de destino é preenchido com o nome da imagem.

No campo Sumário, o usuário de deverá inserir a informação sobre o arquivo, que deverá ser o mais completa possível.



Categorias

Um artigo deve sempre estar categorizado num determinado assunto. Por exemplo, se pretende escrever sobre um palácio ele ficará bem categorizado na “Categoria:Palácios”. Por outro lado, se pretender escrever sobre um determinado computador, o seu artigo deverá ficar na “Categoria:Computadores”. Desta forma, os leitores podem facilmente chegar a artigos dentro de um mesmo tema.

Para categorizar um artigo na categoria minha categoria basta adicionar no final [[Categoria:minha categoria]].

Se colocar dois pontos (:) antes da palavra Categoria, conseguirá criar o texto "Categoria:minha categoria" com uma ligação associada, em vez de categorizar o artigo.

Para encontrar a categoria certa, tenha em mente que:

  • Regra geral, os nomes das categorias escrevem-se no plural. Exemplos: Categoria:Políticos, Categoria:Aviões, etc;
  • Se a categoria estiver associada a um país, então o formato deverá ser "algo de país". Exemplos: Categoria:História do Brasil, Políticos de Portugal.

Para encontrar uma categoria (i.e., alguma que não apareça a vermelho no fundo da página), tente o seguinte:

  • Inserir a categoria que lhe parece mais óbvia;
  • Se não existir, tente alguma variação. Exemplos: Em vez de Categoria:História portuguesa, experimente Categoria:História de Portugal;
  • Se não existir, tente partir de um ramo inferior e ver as suas subcategorias.
    Exemplo: Categoria:História.

Se ainda assim não conseguir encontrar uma categoria válida, pode ainda recorrer ao seguinte:

  • Pedir ajuda no Café dos categorizadores!;
  • Procurar outra categoria na Lista de categorias;
  • Utilizar a marcação (na página destinada às categorias) {{semcat}}.


Ligações internas

Um artigo no Wiki deve fazer uso da marcação hipertexto, para que o leitor consiga navegar entre os artigos apenas com um clique.

Uma ligação interna, ou interlink, é conseguida usando colchetes em volta dos termos a ligar, por exemplo [[LCAD]].

O editor deve ter sempre presente que os termos devem ser criados no singular, o que por vezes faz com que não seja possível ligar termos no plural. Por exemplo, se tentar ligar casas, verá um link vermelho, pois o artigo foi criado no singular: casa.

Porém, pode conseguir ligá-lo e ainda visualizá-lo no plural. Para isso, separamos o termo a ligar daquele que será visível mediante uma barra vertical (|), como por exemplo: [[casa|casas]].

Há casos em que é ainda mais simples rematar estas situações: se o termo no plural puder ser dividido num sufixo anexado ao termo principal (p.e. células = "célula" + "s"), pode ainda escrever a ligação assim: [[célula]]s.

O software do Wiki irá detectar a letra encostada ao colchete e interpretar como se estivesse escrito [[célula|células]]. Podíamos então ter escrito casas desta forma: [[casa]]s.


Ligações externas

A linguagem Wiki torna facílimo criar ligações para páginas fora da Wikipédia. As ligações devem ser sempre incluídas na secção "Ligações externas", desta forma. 

=={{Ligações externas}}==
*[http://www.wikipedia.org/ Página oficial]
*[http://www.wikimedia.org/ Fundação Wikimédia]

Para citar fontes no meio de uma página de discussão (e não num artigo) pode-se usar diretamente o link desta forma [http://www.wikipedia.org/ Página oficial], que dá este resultado: Página oficial. Outra forma será [http://www.wikipedia.org/] que resulta: [1] O número é incrementado automaticamente sempre que adicionada uma nova fonte. Para ligações externas usadas como fonte de referência para um dado no texto de um artigo use as notas de rodapé.


Discussões

As Páginas de discussão, que podem ser acessadas pelo menu superior entre o “artigo” e o “”editar””, servem para que sejam feitos comentários ou acertar as diretrizes de edição. Dali os articulistas podem conversar e manter registrado o andamento de uma edição em conjunto. As páginas dos utilizadores também têm discussão. Veja ao lado do nome de login que há um menu chamado “minha discussão”. Nele poderá ver os recados que outros wikipedistas lhe enviam.


Ao participar de várias discussões do Wiki, deve-se identificar mediante a utilização do til (~). Eis as assinaturas disponíveis:

  • 3 tiles (~~~): -- Wikipedista
  • 4 tiles (~~~~): -- Wikipedista 09:18, 7 Mar 2005 (UTC)
  • 5 tiles (~~~~~): 09:18, 7 Mar 2005 (UTC)

As quais geram os respectivos resultados:

  • 3 tiles (Marcelo Narciso Faria): -- Wikipedista
  • 4 tiles (Marcelo Narciso Faria 12h22min de 31 de março de 2009 (UTC)): -- Wikipedista 09:18, 7 Mar 2005 (UTC)
  • 5 tiles (12h22min de 31 de março de 2009 (UTC)): 09:18, 7 Mar 2005 (UTC)

Predefinições

Para maiores detalhes, consulte http://pt.wikipedia.org/wiki/Ajuda:Guia_de_edição/Como_criar_predefinições.

Tabela de diferença entre predefinições estáticas e predefinições dinâmicas.
Tipo Nome da predefinição (exemplo) Código da predefinição Código a colocar nos artigos É mostrado nos artigos
Estática Predefinição:Albert_Einstein

{| border="1"
|Nome
|Albert Einstein
|-
|Nascimento
|1879
|}

 Predefinição:Albert Einstein
Nome Albert Einstein
Nascimento <a href="/wiki/1879" title="1879">1879</a>
Dinâmica Predefinição:Biografia {| border="1"

|Nome
|{{{nome completo}}}
|-
|Nascimento
|{{{data nascimento}}}

|}		 {{Biografia

|nome completo=Albert Einstein

|data nascimento=1879

}}
Nome Albert Einstein
Nascimento 1879


Predefinição dinâmica chamada Projeto: 

== Sobre ==
{| border="1"
|Nome do Projeto
|{{{nome projeto}}}
|-
|Data Inicial
|{{{data inicial}}}
|}

Resultado:

Predefinição:Projeto

Ver Também

Obtido em ""