Como configurar uma MediaWiki

Configurar uma enciclopédia através do MediaWiki não é tão difícil depois que se aprende, mas, infelizmente, é extremamente difícil encontrar informações claras internet afora sobre como fazer o que você precisa. Isso fica ainda mais chocante quando você para para pensar no quão antigo essa plataforma é no quanto ela é usada mundo afora.

Isto posto, resolvi ir compilando aqui os conhecimentos sobre MediaWiki que eu for obtendo conforme vou aprendendo a configurar o Compendium Tolkien.

[Atualizado por último em: 28/02/2024]

LocalSettings.php

Quando você instala o MediaWiki, haverá na raiz dele um documento chamado LocalSettings.php. Este é um dos documentos mais importantes do seu site e que será mais frequentemente usado para configurá-lo. Ele é basicamente um "bloco de notas" no qual você pode incluir "comandos" para serem lidos por seu site.

Aliás, não se assuste: você não precisa entender nada de código; basta encontrar na internet o código referente ao que você precisa, copiá-lo e depois colá-lo dentro deste arquivo LocalSettings.php. Alguns códigos podem ser encontrados no próprio site da MediaWiki, mas eles não fazem um bom trabalho nisso, então a maioria você encontrará internet afora em diversos sites diferentes (Reddit, YouTube, etc.): geralmente alguém pergunta uma dúvida e outra pessoa responde esclarecendo o código que é necessário usar.

Cada "comando" precisa estar em uma linha separada para que um não entre em conflito com o outro. Em tese você pode escrever/colar comandos em qualquer lugar dentro desse arquivo LocalSettings.php, mas, para não correr o risco de você incluir um comando no "meio" de um outro comando sem perceber, eu recomendo que novos comandos sejam sempre incluído ao final do documento, depois de todos os outros comandos já existentes, pois assim você terá certeza de que não estará conflitando com nada.

Outro detalhe muito importante: toda linha de código dever terminar com um símbolo de ponto e vírgula (;). Você pode ter incluído um código perfeitamente; se não tiver colocado um ";" ao final ele não funcionará.

Você também pode incluir qualquer tipo de texto explicativo dentro deste arquivo chamado LocalSettings.php, o que acaba sendo muito importante principalmente para quem não tem muito conhecimento técnico no assunto, pois você pode, por exemplo, incluir uma breve explicação sobre o código que você está incluindo no arquivo. Deste modo, caso você se esqueça no futuro para o que serve um código específico que você colocou lá, essa explicação te ajudará a se lembrar.

Importante: para que o MediaWiki não interprete o seu texto explicativo como um comando é necessário acrescentar uma "hashtag" (#) no início da linha. Toda linha que começar com uma hashtag o programa irá ignorar, enquanto toda linha que começar com qualquer outra coisa o programa irá interpretar como um comando. Então, na hora de incluir textos explicativos, sempre comece a linha com uma hashtag!

Abaixo, um exemplo:

# O código abaixo deixa você escolher o tema padrão da sua wiki, que será automaticamente implementada para todos os usuários que não tenha optado por um tema personalizado (cada usuário pode alterar individualmente seu tema nas configurações de sua conta).

# Para alterá-la, é necessário pegar o nome-código de cada tema no site da MediaWiki e colocá-lo dentro daquelas aspas. Abaixo, optei pelo tema "timeless", cujo nome-código é exatamente o mesmo (às vezes um nome-código é diferente do nome do tema).

$wgDefaultSkin = "timeless";

Nota-se que o texto explicativo começa com uma hashtag (#), bem como que o código que segue na linha de baixo é finalizado por um símbolo de ponto e vírgula (;). Em tese o código pode ser colocado já na linha debaixo do texto explicativo, ou na linha imediatamente abaixo de outro código, mas, para evitar confusões, recomendo que você pule pelo menos uma linha entre um texto explicativo e um código ou entre um código e outro código (lembrando que, como comentei, você pode colocar o código em qualquer lugar do arquivo, pois o programa ignora linhas em branco e linhas que começam com uma hashtag). Ficará mais fácil de você se achar depois.

Caso seu texto explicativo fique muito longo, como no exemplo acima, é interessante "quebrá-lo" em várias linhas para que você não precise rolar o mouse para a direita para continuar lendo. Porém, fique atento: caso você quebre seu texto explicativo em mais linhas, lembre-se de sempre incluir uma hashtag no começo de cada uma dessas linhas, pois, como já disse, linhas que não começam com uma hashtag o programa interpretará como um código!

Por exemplo:

# O código abaixo deixa você escolher o tema padrão da sua wiki, que será automaticamente implementada para todos 

# os usuários que não tenha optado por um tema personalizado (cada usuário pode alterar individualmente seu tema 

# nas configurações de sua conta).

# Para alterá-la, é necessário pegar o nome-código de cada tema no site da MediaWiki e colocá-lo dentro daquelas 

# aspas. Abaixo, optei pelo tema "timeless", cujo nome-código é exatamente o mesmo (às vezes um nome-código é 

# diferente do nome do tema).

$wgDefaultSkin = "timeless";

Alterando a logo da sua wiki

Quando você instala o MediaWiki, o arquivo LocalSettings.php já virá com vários comandos gerados automaticamente. Um deles é o comando que define qual será a imagem que representará a logo da sua wiki. Sendo assim, neste caso não é necessário que você crie nenhum comando novo, mas apenas que você modifique um comando já existente.

Para localizar um código que já consta dentro do documento, você pode usar Ctrl+F (ou, dependendo de qual programa você usou para abrir o LocalSettings.php, Ctrl+L) da mesma forma que você usa, por exemplo, em um site da internet.

Sendo assim, com o LocalSettings.php aberto, pesquise pela palavra "logo" e você encontrará o seguinte código:

## The URL paths to the logo.  Make sure you change this from the default,

## or else you'll overwrite your logo when you upgrade!

$wgLogos = [

    '1x' => "$wgResourceBasePath/resources/assets/change-your-logo.svg",

    'icon' => "$wgResourceBasePath/resources/assets/change-your-logo.svg",

];

Nota-se que aquelas duas linhas que começam com ## são apenas linhas explicativas e não fazem parte de nenhum código. Em tese você poderia apagá-las que não faria falta (mas não tem por que apagar).

O código mesmo são aquelas quatro últimas linhas, que não começam com #. Alguns códigos preencherão tão somente uma linha, enquanto outros podem abranger mais de uma linha (como este). Aliás, nota-se que ao final do código há um símbolo de ponto e vírgula (;). Nunca se esqueça dele quando estiver incluindo um código novo (normalmente códigos que você pega internet afora não incluem o ponto e vírgula final, então você tem de lembrar de pô-lo).

Quanto ao código para alterar a logo do site, note que há um "caminho" nele: /resources/assets/change-your-logo.svg.

Caso você não tenha percebido, cada um desses nomes (resources e assets) são pastas dentro do seu servidor do MediaWiki, e o último nome (change-your-logo.svg) é o nome do arquivo em si. Ou seja, para alterar a logo da sua MediaWiki basta que você "suba" a imagem da logo para dentro do seu servidor e depois atualize o caminho neste código (não é necessário que seja um arquivo em .svg; você pode usar .png ou .jpg normalmente).

Em tese você poderia salvar a sua imagem em qualquer lugar do seu servidor, mas eu recomendaria você salvar no mesmo lugar que a logo padrão (resources/assets). Se quiser, crie uma pasta dentro de assets (por exemplo, uma pasta chamada "imagens").

Atenção: não substitua a imagem padrão que vem pré-instalada no MediaWiki, mas sim salve a sua imagem em outro lugar ou, se for no mesmo lugar, com outro nome. Em tese não teria problema você substituir o arquivo padrão com o seu arquivo pessoal, mas isso pode gerar problemas em uma atualização futura. Quando você atualiza a versão da sua MediaWiki, algumas configurações de fábrica são preestabelecidas, o que quer dizer que, se você substituir a logo padrão pela sua dentro do servidor, pode ser que você perca sua logo em uma atualização. Repito: salve sua logo em outra pasta ou, se for na mesma pasta, use outro nome. Depois é só consertar o "caminho" dela no código.

No meu caso, o código da logo ficou da seguinte forma:

## The URL paths to the logo.  Make sure you change this from the default,

## or else you'll overwrite your logo when you upgrade!

$wgLogos = [

    '1x' => "$wgResourceBasePath/resources/assets/logo-simples-sem-fundo.png",

    'icon' => "$wgResourceBasePath/resources/assets/logo-simples-sem-fundo.png",

];

O caminho é exatamente o mesmo, pois salvei a minha logo na mesma pasta em que se encontra a logo padrão e apenas usei um nome diferente para o arquivo. Sendo assim, bastou que eu alterasse o nome do arquivo no caminho que já se encontrava no código padrão.

Como instalar o "Visual Editor"

Uma das ferramentas mais importantes de uma enciclopédia acessível ao público em geral é o "Visual Editor".