Web Design

Como instalar o MediaWiki num servidor Wamp (Windows)

Instale sua wiki local usando o Wamp em Windows com o MediaWiki
Google+ Pinterest LinkedIn Tumblr
Anúncios Google

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).

arquivos mediawiki

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 VisualEditor

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.

Fundador do Tutoriart em 2010, é ex-instrutor de Photoshop, design web e gráfico. Em quase uma década de redação online, tem cerca de 1500 artigos publicados. Gerencia também o Memória BIT.

Deixe um Comentário

Pin