O MediaWiki é um software para criação de wikis, como a Wikipédia – que por sinal, é feita exatamente com ele. Se você sempre quis ter um clone da Wikipédia ou de outras wikis famosas como a WikiHow, o nome é esse: MediaWiki.
Há vasto material na internet sobre a instalação e configuração do MediaWiki em servidores Linux, mas pouco para o Windows e a maioria é orientado a profissionais avançados. Iniciando um projeto recente, tive que passar pelo processo com o Wamp (até porque meu conhecimento sobre MediaWiki era quase nulo) e foi um tanto complicado, mesmo eu tendo uma boa base de design web e o básico de estrutura de TI.
Se você também está nessa, vou deixar aqui as etapas. Foi usada a versão mais recente do MediaWiki, Wamp 3.2.0, além do Node.js e do Parsoid (ambos para permitir o uso do editor visual do MediaWiki).
Antes de começar: vou considerar que você já tem o Wamp instalado, configurado e rodando certinho em sua máquina, certo? Se não , leia esse artigo sobre WordPress e Wamp, deve ajudar um pouco.
“Mas preciso instalar isso num servidor de produção“. Se planeja criar uma wiki aberta, procure um artigo específico sobre a instalação e configuração em Linux, há realmente muitos na internet. O escopo aqui é um servidor local, seja para teste ou para projetos pessoais (como trabalhos colaborativos ou não).
1. Baixe o MediaWiki
Faça o download no site oficial do MediaWiki, aqui. Descompacte o arquivo.
2. Instale os arquivos
Na sua pasta local do Wamp (normalmente fica no caminho C:\wamp\www), crie uma pasta com o nome da sua futura wiki. No meu exemplo, a wiki fictícia se chamaria “WikiWow”, então nomeei a pasta como “wikiwow”.
Nessa pasta, coloque todos os arquivos do MediaWiki, soltos lá dentro (não dentro de outras pastas).
3. Auto configuração
Siga o caminho http://localhost/[suawiki]. Deverá ver uma imagem como essa:
Ela diz que está faltando o arquivo de configuração. Clique no link para iniciar o assistente de configuração.
Daí em diante você verá uma série de informações, vá lendo e seguindo as instruções e clicando em Continuar conforme necessário.
4. Banco de dados
Quando chegar à página de informações de bancos de dados, insira os dados. Tanto faz se estiver usando MariaDB ou MySql. Mesmo que o banco ainda não tenha sido criado, não tem problema, vamos fazer isso em seguida.
O campo “Prefixo da tabela do banco de dados” pode ficar em branco a não ser que pretenda fazer da sua wiki uma “multiwiki” ou compartilhar o banco de dados com outras aplicações. Tenha paciência a cada passo, demora um pouco mesmo: não clique em Continuar várias vezes…
Prossiga com a instalação e no final o banco de dados será criado automaticamente. Quando surgir a tela abaixo, seu navegador fará o download de um arquivo chamado “LocalSettings.php”. Se não, clique no link da página para baixá-lo.
Siga as instruções, ou seja: coloque esse arquivo na pasta-raiz da sua nova wiki (aquela com o nome da wiki que ficou na pasta www do Wamp). DEPOIS de colocá-lo lá, clique no link “entrar na sua wiki” e se fez tudo certo, ela estará instalada.
Como vai notar, o visual é o mesmo da Wikipédia. Para instalar uma skin adicional, procure aqui e faça o download, descompacte o arquivo e mova a pasta da skin para a pasta “skins” na sua instalação da wiki. Edite então o arquivo LocalSettings.php, acrescentando a linha:
wfLoadSkin( 'NOMEDASKIN' );
Deposi procure o trecho:
$wgDefaultSkin = "vector";
E altere o valor entre aspas pelo nome em letras minúsculas.
5. Visual Editor
Do jeito que está as coisas já funcionam, mas a parte mais difícil é a adição opcional, mas muito interessante, do VisualEditor. É uma extensão que permite editar os artigos na própria página deles, sem acessar o HTML. É igualzinho aquele da Wikipédia, em que você clica em “Editar”, uma barra azul carrega e você digita na própria página.
Para usá-la no Windows, você vai precisar do Git e do Node.js.
Download do Git (Windows 64-bit)
Download do Node.js LTS 10.15.3
- Instale o Git e o Node.
- Descompacte o pacote do VisualEditor e coloque a pasta “VisualEditor” na pasta “extensions”, na raiz da sua wiki.
Abra um cmd do Windows como administrador e digite:
cd c:\program files\nodejs\node_modules
Instale o Parsoid através do comando:
git clone https://gerrit.wikimedia.org/r/mediawiki/services/parsoid cd parsoid npm install
Aguarde a conclusão, então use o comando seguinte para criar o arquivo de configuração do Parsoid:
copy config.example.yaml config.yaml
Siga à pasta do parsoid e abra num editor de texto o arquivo config.yaml. Procure pelo trecho que mostra:
mwApis: - # This is the only required parameter, # the URL of you MediaWiki API endpoint. uri: 'http://localhost/w/api.php'
…e substitua o uri pelo da sua wiki:
mwApis: - # This is the only required parameter, # the URL of you MediaWiki API endpoint. uri: 'http://localhost/[suawiki]/api.php'
Salve o arquivo.
Agora abra o arquivo LocalSettings.php (caso tenha fechado) e no fim dele, depois de tudo, insira:
wfLoadExtension( 'VisualEditor' ); // Enable by default for everybody $wgDefaultUserOptions['visualeditor-enable'] = 1; // Optional: Set VisualEditor as the default for anonymous users // otherwise they will have to switch to VE // $wgDefaultUserOptions['visualeditor-editor'] = "visualeditor"; // Don't allow users to disable it $wgHiddenPrefs[] = 'visualeditor-enable'; // OPTIONAL: Enable VisualEditor's experimental code features #$wgDefaultUserOptions['visualeditor-enable-experimental'] = 1;
$wgVirtualRestConfig['modules']['parsoid'] = array( // URL to the Parsoid instance // Use port 8142 if you use the Debian package 'url' => 'http://localhost:8000', // Parsoid "domain", see below (optional) 'domain' => 'localhost', // Parsoid "prefix", see below (optional) 'prefix' => 'localhost' ); if ( !isset( $_SERVER['REMOTE_ADDR'] ) OR $_SERVER['REMOTE_ADDR'] == '127.0.0.1' ) { $wgGroupPermissions['*']['read'] = true; $wgGroupPermissions['*']['edit'] = true; }
Para completar, inicie o server Parsoid através do Node: num cmd de administrador, digite:
cd C:\program files\nodejs\node_modules\parsoid node bin\server.js
Se tudo estiver certo, você não verá nenhuma mensagem de erro. Volte à página principal de sua wiki e atualize com F5. Agora sim, você já deve ter o VisualEditor funcionando.
Ajuda adicional
Note que o VisualEditor é compatível com alguns temas – ou skins, como são chamados os modelos disponíveis para o MediaWiki:
- Vector
- MonoBook
- Apex
- Poncho
- Minerva Neue
Além do VisualEditor, o MediaWiki tem muitas outras extensões. Para conhecer mais, confira a página de extensões do MediaWiki. Se tiver dúvidas mais específicas, confira as páginas de ajuda da MediaWiki.