Aplicativos em PHP/CMSs (Gerenciadores de Conteúdo)/MediaWiki (wikis)

O Mediawiki é o CMS que deu origem à Wikipedia, ao Wikibooks e a toda essa geração de CMS que trouxe a democracia ao conhecimento.

Instalação do Mediawiki

Instalação no Linux Ubuntu (é semelhante a uma instalação no Windows ou em outro Linux).

Compatibilidade

Lembrando que o Mediawiki atual (1.10.0) funciona somente com o PHP5 ou superior. Caso precise instalar em algum servidor com o cPanel precisará de uma versão para PHP 4.3.x ou superior, no caso a versão 1.6.10 ou outra compatível.

- Baixar de http://www.mediawiki.org

- Fazer o download para o documentRoot no diretório "mediawiki"

- Dar permissão de escrita ao diretório config (chmod a+w config)

- Criar o usuário e o banco, tendo o usuário privilégios sobre o banco.

- Chamar no browser http://localhost/mediawiki

- Preencha devidamente os dados, atentando para os requeridos.

- Após confirmar deverá mover o arquivo config/LocalSettings.php para o raiz do mediawiki.

- Então acesse http://127.0.0.1/mediawiki/index.php

Para acessar como administrador clique em Entrar e faça o login.

Configurações de pós-instalação

Alterando o logotipo

O logotipo que aparece no canto superior esquerdo poderá ser alterado. Para isso, no arquivo LocalSettings.php, insira ou altere o valor da linha $wgLogo.

Exemplo:

$wgLogo = "/wiki/eriberto.png"

Lembre-se de fazer upload do novo arquivo LocalSettings.php e da imagem referente ao logotipo.

Alterando o rodapé

Para alterar o rodapé do Wiki (retirando o Disclaimer, por exemplo), edite o arquivo skins/MonoBook.php e remova as opções indesejadas constantes na linha $footerlinks. As opções existentes nesta linha podem ser vistas no FAQ da MediaWiki (veja How do I change the footer?).

Alterando o fuso horário

Para que o Wiki utilize o mesmo fuso horário do usuário, no momento de uma edição, adicione no final do arquivo LocalSettings.php, antes de ?>, a seguinte linha:

$wgLocalTZoffset = date("Z") / 60;

Alterando as mensagens de tela e menus

É possível alterar as mensagens que aparecem na tela e os nomes que aparecem nos menus. Para isso, edite o arquivo languages/messages/MessagesPt_br.php.

Permitindo o upload de imagens

Para permitir que as pessoas que editam o wiki façam o upload de arquivos, altere o arquivo LocalSettings.php e altere a linha:

$wgEnableUploads = false

para

$wgEnableUploads = true

Usando o MediaWiki

Para texto puro é semelhante aos editores de texto comuns e aos editores HTML, com exceção da quebra de linha que aqui é efetuada teclando-se duas vezes no Enter ao invés de uma.

Formatação de Texto

Negrito - Apenas selecione o texto e clique no botão B na barra do editor acima.

Alternativamente selecione o texto e insira ''' antes e após o texto selecionado (o mesmo efeito de clicar no B).

Itálico - Proceder de forma semelhante clicando no I.

Título

Para formatar um texto como título clique no botão Texto a negritoA da barra do editor acima.

Indentação

Para indentar usa-se dois pontos ":"

:Primeiro nível
::Segundo
:::Terceiro

Aparecerá assim:

Primeiro nível

Segundo

Terceiro

Indentar com Pontos

*Primeiro nível
**Segundo
***Terceiro

Listas Numeradas

Listas Numeradas

#Primeiro

#Segundo

##SubdoSegundo

#Terceiro

Aparecerá:

1. Primeiro
2. Segundo
   1. SubdoSegundo
3. Terceiro

Quebra de Linha

Podemos usar a quebra de linha do HTML <br>.

Assim como podemos utilizar vários comandos do HTML, mas nem todos.

Caso se digite:

Este parágrafo está
em três 
linhas.

O Mediawiki (Wikibooks) irá exibir o seguinte parágrafo:

Este parágrafo está em três linhas.

Para que seja de fato exibido em três linhas deverá inserir sempre uma linha em branco entre cada uma delas, assim:

Este parágrafo está

em três

linhas.

Ou usando <br>, assim:

Este parágrafo está<br>
em três<br>
linhas.<br>

Que aparecerá assim:

Este parágrafo está
em três
linhas.

Criando Índice em HTML

Caso queiramos criar automaticamente um índice da página que estamos criando, basta usar a tag título <H1>, <H2> ... <H6>. Edite esta página ou outra com este recurso e confira.

Somente funciona se a página contiver um título usado com o ícone A, ou seja ==Título==.

Link

Insira link selecionando a URL e clicando no botão com o globo da barra.

Links para Páginas Externas

[http://pt.wikibooks.org/ WikiBooks]

Abre colchete, URL, Descrição, espaço em branco e fecha colchete.

Se apenas digitarmos http://pt.wikibooks.org/ também aparecerá o link e o rótulo será a própria URL.

Criando Nova Página

- Suponha que esteja em http://pt.wikibooks.org/wiki/Aplicativos_em_PHP/Geradores_de_Aplicativos e queira criar uma nova página para um outro gerador ainda não conttemplado

- Apenas faça login (de preferência) e abra no navegador a seguinte URL:

http://pt.wikibooks.org/wiki/Aplicativos_em_PHP/Geradores_de_Aplicativos/MeuGerador

Irá receber a mensagem "(Não há atualmente nenhum texto nesta página)". Então apenas clique em Editar e insira o conteúdo para o gerador.

Inserindo Imagens e Outros arquivos

A lista de arquivos permitidos no Wikibooks é somente esta:

png, gif, jpg, jpeg, xcf, xls, pdf, mid, sxw, sxi, sxc, sxd, ogg, svg, djvu

- Clique no ícone para inserir imagem na barra ou simplesmente digite no texto [[Imagem:nomearquivo.jpg]]
- Salve a página
- Clique no link gerado
- Faça o upload do arquivo
- Salve e volte ao texto contendo a imagem (atualize com F5)
- Clique sobre a imagem para exibi-la
- Clique em editar e digite uma das predefinições para imagem, como por exemplo:

{{GFDL}}

No caso das imagens, as predefinições a serem usadas para licença são:

    * {{Cc-by-sa-2.5}} para licença Creative Commons Atribuição - Compartilhamento pela mesma licença (veja Predefinição:Cc-by-sa-2.5)
    * {{GFDL}} para licença pública GNU FDL (veja Predefinição:GFDL)
    * {{DP}} para imagens em domínio público. (veja Predefinição:DP)

Outras opções para inserir imagem

[[image:nomeimagem.png|thumb|rótulo]]

Exibirá a miniatura da imagem com o rótulo.

[[image:nomeimagem.png|left|thumb|50px|]]

Exibirá a miniatura da imagem com o rótulo e tamanho 50 pixel e alinhado pela esquerda.

Criando um Índice com itens e subitens

Faça como o exemplo abaixo:

#[[/Introdução/]] [[Imagem:3de8.png]]
##[[/Introdução/História|História]]
##[[/Introdução/Características e Recursos|Características e Recursos]]
##[[/Introdução/A quem se destina este livro|A quem se destina este livro]]
#[[/InteligênciaEmocional/]]
#[[/Instalação e configurações do ambiente/]]
##[[/Instalação e configurações do ambiente/Via Xampp|Via Xampp]]
##[[/Instalação e configurações do ambiente/Individualmente|Individualmente]]
#[[/Editores e IDEs para PHP, CSS, JavaScript e HTML/]]
##[[/Editores e IDEs para PHP, CSS, JavaScript e HTML/PHPDesigner|PHPDesigner]]
##[[/Editores e IDEs para PHP, CSS, JavaScript e HTML/Kate|Kate]]

Detalhe importante: ao criar um índice assim bastará clicar em qualquer um dos capítulos ou itens para que a página seja criada em branco e possamos adicionar conteúdo.

Obs.: Veja que na primeira linha aparece uma pequena imagem ao lado direito. O wikibooks tem diversas dessas imagens. Veja na Biblioteca.

Para que apareça uma imagem representando o estágio atual do texto de um capítulo ou item use:

[[Imagem:3de8.png]]

à direita do item.

Esboço de página

Quando apenas iniciamos uma página podemos chamar a atenção do leitor e até solicitar sua colaboração com a seguinte tag:

{{esboço}}

Que gera o seguinte aviso:

Esta página é somente um esboço. Ampliando-a você ajudará a melhorar o Wikilivros.

Evitar Interpretação do Mediawiki

Uma forma de evitar que o media wiki interprte o que escreve é usando a tag <pre>... </pre>.

Para que de fato nunca interprete usar a tag <nowiki>... </nowiki>.

Para conhecer mais detalhes do uso do Mediawiki edite qualquer página e observe o conteúdo atentamente.

Seções

==Secão==
===Subseção===
====Sub-subseção====

Comunicação entre Usuários registrados

Os usuários registrados do Wikibooks (mwdiawiki) comunicam-se através de seus forums, cujo link "discussão" e "minha discussão" acima. Este último aparece somente quando estamos logados.

- No caso devemos acessar a área do usuário com quem queremos conversar

- Clicamos em discussão

- E clicamos no link do assunto já aberto.

- Caso queiramos abrir um novo tópico clicamos no sinal de + e criamos o tópico

Sempre ao final das mensagens devemos nos lembrar de assinar a mensagem.

Assinar Mensagens

Assina-se a mensagem com ~~~ (3 tils, que irão exibir o login do usuário)

ou com ~~~~ que mostrarão o login e a data completa.

Código Fonte

Ao chegar a um site wiki e ao invés de editar aparecer Exibir Código Fonte é porque o administrador impediu a edição por algum motivo.

Wiki: ser ou não ser?

Ótimo artigo do Carlos Nepomuceno sobre os valores do wiki - http://www.dicas-l.com.br/conhecimento_em_rede/conhecimento_em_rede_20070510.php

Extensão para Firefox da MediaWiki

Após ter se acostumado com a sintaxe do mediawiki é interessante e produtivo usar algo como essa extensão que ajuda na criação e edição das páginas.

Site para instalação - https://addons.mozilla.org/en-US/firefox/addon/1662

Referências

- Tutorial de Mediawiki em português do Eriberto - http://www.eriberto.pro.br/wiki/index.php?title=Instala%C3%A7%C3%A3o_do_MediaWiki_em_sites_pessoais_em_WebHostings

-