Como Usar o Formato MediaWiki para Criar Páginas

De BISAWiki

O MediaWiki é Aberto, Gratuito e LivreO MediaWiki é um padrão aberto para formatação de documentos dinâmicos e colaborativos online com o software de mesmo nome. Diversos sítios wiki (como o wikiHow, é claro) utilizam o formato MediaWiki. Aprenda agora como utilizar os formatos mais comuns para editar suas páginas.

Tabela de conteúdo

Passos

Introdução

  1. Antes de começar a aprender os formatos, entenda um pouco como funciona o texto wiki, o Servidor de Páginas e o seu navegador de internet, atuando em conjunto para exibir a página na sua tela.
  2. O autor / editor cria / edita o texto em formato wiki diretamente do navegador de internet e salva o texto, enviando-o ao servidor da página criada / editada.
  3. O software do servidor processa as marcações especiais do texto wiki, transformando estas marcações em outras de uma linguagem entendida pelo navegador, o HTML. Este texto HTML é enviado para o seu navegador pela internet.
  4. Seu navegador recebe o HTML, processa o texto, e cria a página para exibição, convertendo as marcações HTML em elementos gráficos. Se houver algum outro elemento além do texto (como imagens principalmente, mas sons ou vídeos), ele requisita estes elementos dos servidores, a partir dos URL mencionados no texto HTML.
  5. Entenda o motivo da existência do formato de wiki, ao invés de codificar diretamente em HTML:
    • Simplicidade. O formato wiki é muito mais simples e amigável ao ser humano, permitindo que com somente um pouco de prática textos visualmente complexos sejam criados diretamente no navegador, sem o auxílio de ferramentas externas. O formato wiki é muito mais fácil, e requer bem menos caracteres especiais que o HTML, daí seu sucesso.

Formatação MediaWiki

  1. O formato MediaWiki é muito similar a outros formatos de wiki em uso na internet. Vejamos agora ver os elementos da formatação MediaWiki mais úteis para a elaboração de instruções seqüenciadas.
  2. Convenção de linhas: uma linha de texto (ou um parágrafo se seu editor de texto cortar as linhas para caber na tela) no formato MediaWiki não deve conter nenhum espaço em branco no início do texto. Linhas em branco não são necessárias (e podem atrapalhar se utilizadas no meio de seções), mas podem ser usadas para separar blocos de texto com funções diferentes.
  3. Títulos: os títulos e subtítulos do texto são indicados usando caracteres de = demarcando o texto, que deve estar em uma linha separada.
    • Dois caracteres de = ao redor do texto indicam um título principal (Que fica com a barra azul em volta). Normalmente usado em seções.
      Ex: == Passos ==
    • Três caracteres de = ao redor do texto indicam um título secundário (Em fonte grande e negrito).
      Ex: === Método do Denominador Comum ===
    • Quatro indicam um título terciário, e assim por diante.
  4. Listas enumeradas: (como esta da seção Passos) Uma lista numerada é feita usando o caractere # no início da linha. É proibido ter linhas em branco dentro de uma lista numerada, sob o risco de reiniciar a numeração dos tópicos. Para manter a numeração, todas as linhas de uma lista numerada devem iniciar-se com o caractere #, incluindo linhas de subitens.
    1. Uma lista enumerada pode ter elementos internos (como este estás a ler neste momento) enumerados ou não.
    2. Para um elemento interno enumerado, use duas cerquilhas ( ## ) para indicar o elemento, ou três ou mais para elementos numerados mais internos ainda.
    • Para elementos internos não enumerados (uma lista de ações dentro do mesmo passo por exemplo), use o caractere de lista ( * ) juntamente com a cerquilha ( #*). Mais asteriscos irão fazer com que o elemento fique mais interno ainda.
  5. Listas não enumeradas: Uma lista não numerada é indicada com o asterisco ( * ). Elementos mais internos são criados usando mais asteriscos.
  6. Links: elemento crucial em páginas de internet, os links no mediawiki são marcados com os caracteres de colchetes [ ]
  7. Um link para outras páginas dentro do mesmo domínio wiki (por exemplo, de uma página para outra no mesmo sítio pt.wikihow.com):
    • O link é feito usando colchetes duplos [[ ]] , com o nome interno da página (sem o endereçamento do domínio). Por exemplo [[Cortar uma Melancia]] no domínio pt.wikihow.com vai ser traduzido como um link para o URL http://pt.wikihow.com/Cortar-uma-Melancia para o navegador.
    • O caractere “pipe” ( | - no teclado ABNT2, ele está ao lado do Z, junto com a contrabarra. Segure shift) é usado para dar ao link da página um texto diferente do nome da página. Por exemplo:
      • [[Cortar uma Melancia|Como Cortar uma Melancia]] vai criar um link para a página mencionada acima, mas vai exibir o texto “Como Cortar uma Melancia” no navegador. Repare que não há espaços antes ou depois do pipe.
  8. Links para páginas em outros domínios (links externos) são feitos usando-se colchetes simples [ ] Escreva a URL (com o protocolo – http ou https ou ftp, e o :// ) sem espaços. O texto do URL pode ser substituído por um texto simples usando-se um espaço ao final da URL.
  9. Links para subdomínios: Um domínio pode ter outros subdomínios, de acordo com a conveniência dos administradores. Um subdomínio muito comum é o de imagens, por exemplo. Um subdomínio é indicado utilizando-se o caractere de dois pontos ( : ) na criação do link. Por exemplo, o Guia do Escritor do wikihow pode ser linkado com o código:[[Wikihow:Guia-do-Escritor|Acesse nosso Guia do Escritor]]
  10. 150pxLinks para imagens: As imagens pertencem a um subdomínio particular. Um link para uma página do subdomínio Imagem ou Image não somente cria um link para a página, fazendo além disto uma importação da imagem para dentro da página atual. Um link para imagem simples pode ser escrito como: [[Arquivo:Pavao.jpg]] Este link vai inserir a imagem referida dentro da página.

    • Imagem de um PavãoÉ uma boa prática inserir um texto explicativo da imagem, no caso do browser ser incapaz de exibir a imagem ao usuário. O texto explicativo pode ser inserido com o pipe ( | ) separando o link da imagem do texto: [[Arquivo:Pavao.jpg|Imagem de um Pavão]]. Caso a imagem não possa ser exibida, o texto “Imagem de um Pavão” vai ser exibido no lugar dela.

    • Imagem de um PavãoA imagem pode ser alinhada dentro da página. Para isto, coloque um parâmetro left, right, center após o link da imagem, e antes do texto explicativo. Por exemplo: [[Arquivo:Pavao.jpg|left|Imagem de um Pavão]]

    • Imagem de um PavãoAlgumas imagens são grandes demais para aparecerem na página junto com o texto. Para isto, ela pode ser inserida na página como um thumbnail para ocupar menos espaço, e o usuário pode clicar no link para ver a imagem em tamanho maior. Para isto, adicione um parâmetro thumb / thumbnail ou frame com pipe. [[Arquivo:Pavao.jpg|thumb|Imagem de um Pavão]]. O thumb ou frame também tem o efeito adicional de transformar o texto substitutivo em legenda da imagem. Este parâmetro é muito utilizado, por ser esteticamente agradável (emoldura a imagem) e e por adicionar uma legenda.

    • Em casos especiais, a imagem pode ser definida com um tamanho fixo:[[Arquivo:Pavao.jpg|200px|Imagem de um Pavão]] vai exibir a imagem com 200 pixels de largura.

    • Todas as opções acima podem ser usadas em conjunto. Existem muitas outras opções para formatação de imagens dentro da página, veja nas Fontes e Citações

  11. Negrito: o texto em negrito é demarcado com 3 aspas simples ( ''' ) de cada lado do texto.
  12. Itálico: texto em itálico é demarcado com 2 aspas simples ( ‘ ‘ ) de cada lado do texto.
  13. Tags: uma tag é um código entre < e >. As tags são essenciais às linguagens HTML, XML, ColdFusion, e muitas outras. Apesar do MediaWiki evitar o uso de tags, algumas são usadas. Existem dois tipos principais de tags: unárias e binárias. Uma tag unária é utilizada sozinha, as tags binárias são usadas em par, demarcando um trecho de texto.
    • Um exemplo de tag unária <br>, que indica uma quebra de linha. Tags que têm efeito pontual no texto são unárias.
    • Um exemplo de tag binária <b> e </b> que indica uma seção de texto em negrito (use três aspas simples sempre que possível). Tags que demarcam trechos de texto são binárias.
  14. Tags MediaWiki: uma tag muito utilizada é a tag binária <nowiki>. Ela serve para dizer ao software MediaWiki para parar de interpretar os caracteres especiais ( * # [ ] , etc) como marcações wiki. Muito útil para uma metawiki (uma wiki que fala de wikis) – como este texto.
    • Sublinhado: o efeito de sublinhado é obtido com a tag binária <ins>.
    • Marcado como removido (tachado): Serve para indicar texto invalidado, mas que está mantido por motivos de entendimento. Normalmente usado em páginas de discussão (fóruns). Em edições de páginas wiki, o ideal é simplesmente remover o texto. Use a tag <del> para demarcar o texto tachado. (as tags de demarcação são binárias).
    • Subescrito ou superescrito ( x2 H2O ). Use as tags <sub> ou <sup>.
  15. Tags HTML:
    • <br> - quebra de página. Ao final de toda linha de texto o MediaWiki insere uma quebra, mas se quiser inserir espaço em branco na página, use este tag.
    • Comentários: Comentários em HTML são feitos usando marcadores de tag unário especial: <!-- e -->. O texto dentro do tag não será exibido na página, somente na edição de seu código-fonte.

Fontes e Citações

Existem diversos outros elementos dentro do formato MediaWiki, mas estes são os mais utilizados. Para mais informações, visite:

Obtida de "http://wiki.bisaweb.com.br/index.php/Como_Usar_o_Formato_MediaWiki_para_Criar_P%C3%A1ginas"
Ferramentas pessoais