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.

[continua...]