MediaWiki (Português)

MediaWiki é um software wiki de código aberto e livre escrito em PHP, originalmente desenvolvido para a Wikipédia. Ele também alimenta este wiki (consulte Special:Version e o repositório do GitHub).

Status de tradução: Esse artigo é uma tradução de MediaWiki. Data da última tradução: 2019-11-24. Você pode ajudar a sincronizar a tradução, se houver alterações na versão em inglês.

Nota: MediaWiki ainda não é completamente compatível com PHP 7.3.

Instalação

Para executar o MediaWiki, você precisa de três coisas:

• o pacote mediawiki, o qual obtém PHP
• um servidor web – Apache, Nginx or Lighttpd
• um sistema de banco de dados – MySQL, PostgreSQL or SQLite

Para instalar o MediaWiki no XAMPP, veja mw:Manual:Installing MediaWiki on XAMPP

Configuração

As etapas para obter uma configuração funcional do MediaWiki envolvem a edição das configurações do PHP e a adição dos trechos de configuração do MediaWiki.

PHP

MediaWiki precisa da extensão iconv, então você precisa descomentar extension=iconv em /etc/php/php.ini.

Dependências opcionais:

• Para renderização de miniaturas, instale ImageMagick ou php-gd. Se você escolher o último, você também precisa descomentar extension=gd.
• Para mais uma normalização Unicode eficiente, instale php-intl e descomente extension=intl.

Habilite a API para seu SGBD:

• Se você usa MariaDB, descomente extension=mysqli.
• Se você usa PostgreSQL, instale e descomente .
• Se você usa SQLite, instale e descomente .

Em segunda, ajuste a manipulação da sessão ou você pode receber um erro fatal (PHP Fatal error: session_start(): Failed to initialize storage module[...]) localizando o caminho session.save_path. Uma boa opção pode ser ou .

Você precisará criar o diretório se ele não existir e depois restringir suas permissões:

# mkdir -p /var/lib/php/sessions/
# chown http:http /var/lib/php/sessions
# chmod go-rwx /var/lib/php/sessions

Se você usa open_basedir do PHP e deseja permitir uploads de arquivos, é necessário incluir (mediawiki faz links simbólicos de para ).

Apache

Siga Apache HTTP Server#PHP.

Copie para e edite-o conforme necessário.

Adicione a seguinte linha a :

Include conf/extra/mediawiki.conf

Reinicie o daemon httpd.service.

Nginx

Para que o MediaWiki trabalhe com Nginx, crie o seguinte arquivo:

Certifique-se que está instalado em iniciado.

Inclua uma diretiva de servidor, semelhante a esta

Ao final, reinicie os daemons e .

Lighttpd

Você deve ter o Lighttpd instalado e configurado. "mod_alias" e "mod_rewrite" na matriz server.modules do lighttpd são necessários. Anexe ao arquivo de configuração lighttpd as seguintes linhas

Reinicie o daemon lighttpd.service.

Banco de dados

Configure um servidor de banco de dados conforme explicado no artigo do seu SGBD: MySQL, PostgreSQL ou SQLite.

O MediaWiki pode criar automaticamente o banco de dados, se você fornecer a senha de root do banco de dados, durante a próxima etapa. Caso contrário, o banco de dados precisa ser criado manualmente, consulte as instruções do upstream.

LocalSettings.php

Abra a url do wiki (geralmente ) em um navegador e faça a configuração inicial. Siga as instruções do upstream.

O arquivo gerado é oferecido para download, salve-o em /usr/share/webapps/mediawiki/LocalSettings.php. Este arquivo define as configurações específicas do seu wiki. Sempre que você atualiza o pacote mediawiki, ele não é substituído.

Dicas e truques

Matemática (texvc)

Geralmente, instalar e habilitá-lo na configuração é o suficiente:

$wgUseTeX = true;

Se você tiver problemas, tente aumentar os limites para comandos shell:

Unicode

Verifique se php, apache e mysql usam UTF-8. Caso contrário, você poderá enfrentar erros estranhos devido à incompatibilidade de codificação.

VisualEditor

A extensão VisualEditor MediaWiki fornece um editor de texto rico para o MediaWiki. Siga mw:Extension:VisualEditor para instalá-lo.

Você também precisará do backend Node.js Parsoid, o qual está disponível por meio de .

Ajuste o caminho do MediaWiki em :

parsoidConfig.setInterwiki( 'localhost', 'http://localhost/mediawiki/api.php' );

Após isso, habilite e inicie .

Como alternativa, também é possível usar o pacote parsoid^AUR e configurar o serviço através do arquivo yaml, onde as seguintes linhas devem estar presentes:

A parte correspondente nas configurações do mediawiki:

Após a configuração, o serviço pode ser iniciado (reiniciado) e (se ainda não tiver sido feito) habilitado.