Open main menu

Manual:FAQ/pt-br

This page is a translated version of the page Manual:FAQ and the translation is 41% complete.
Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎Tiếng Việt • ‎Türkçe • ‎català • ‎dansk • ‎español • ‎français • ‎galego • ‎hrvatski • ‎italiano • ‎magyar • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎suomi • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎тоҷикӣ • ‎українська • ‎עברית • ‎हिन्दी • ‎বাংলা • ‎ગુજરાતી • ‎മലയാളം • ‎ဘာသာ မန် • ‎中文 • ‎日本語 • ‎ꯃꯤꯇꯩ ꯂꯣꯟ • ‎한국어
Precisa de ajuda imediata    Ajuda imediata
Para mais informações sobre o acima, veja Comunicação .
Perguntas frequentes (FAQ) sobre o uso da MediaWiki. Se a sua pergunta não foi respondida aqui nem no MediaWiki documentation, em seguida, por favor, peça ajuda no nosso canais de IRC ou na mesa de apoio. Alguma pergunta?

Contents


atalho: FAQ

Informações básicas

Quais são as diferenças entre o MediaWiki, a Wikimedia, Wikipédia e wiki?

Esta é uma questão comum; por favor acesse Diferenças entre Wikipédia, Wikimedia, MediaWiki, e wiki para uma resposta detalhada.

Quero usar uma instância do MediaWiki para X. Posso?

O MediaWiki é um software livre: isto significa que pode utilizá-lo para qualquer fim sem impedimentos legais. Além disso, suas condições de licenciamento aplicam-se apenas para o software em si. Isto significa que, embora muitas wikis licenciem o seu conteúdo ao sob uma licença permissiva, você não é obrigado a licenciar o conteúdo da sua wiki de nenhuma forma em particular. Claro, sendo um projeto fundado para apoiar sites como a Wikipédia, encorajamos-o a disponibilizar os textos que você criar sob uma licença livre, mas, em suma, você não é obrigado a fazê-lo.

Se você deseja alterar ou corrigir o software em si, em geral, você tem permissão de fazê-lo, mas há algumas retrições, você deve consultar o texto completo da licença GNU GPL versão 2 para maiores detalhes. Como o MediaWiki é disponibilizado de forma gratuita, não tem qualquer garantia, na medida permitida pela lei aplicável.

Instalação e configuração

De onde posso baixar o MediaWiki?

Clique aqui para baixar a versão mais recente estável do MediaWiki. Os arquivos estão em um arquivo de formato .tar.gz. O MediaWiki também pode ser obtido diretamente de nosso repositório Git.

Como instalar o MediaWiki?

A instalação do MediaWiki demora entre 10 a 30 minutos, e envolve o carregamento/cópia de arquivos, e executar o script' instalador para configurar o software. Consulte o Manual:Guia de instalação , onde você também encontrará os requisitos mínimos de sistema.

Como é que eu instalo o MediaWiki, utilizando um pacote?

Muitas distribuições Linux fornecem o MediaWiki num formato de pacote (package) para a distribuição específica. A equipe de desenvolvimento do MediaWiki reencaminha-o para a sua distribuição Linux para assistência de como instalar, configurar e utilizá-los. As comunidades e empresas que mantêm tais pacotes devem fornecer instruções de instalação.

Tenha ciência que distribuições de terceiros podem conter versões mais antigas, então preste muita atenção na informação sobre compatibilidade para obter orientações e extensões.

Ver também: Pacotes de software

Posso instalar mais de uma wiki em um servidor utilizando o MediaWiki?

É possível instalar mais de uma wiki em um servidor, desde que:

  • Você use uma base de dados diferente para cada wiki

Ou

  • Você use um prefixo de base de dados diferente para cada wiki (no Postgres, você pode obter um efeito similar usando schemas e usuários diferentes)

Para informação sobre estas opções, ver $wgDBname e $wgDBprefix respetivamente.

Para informação sobre como configurar uma família de wikis, ver Manual:Família Wiki .

Para informação sobre uma maneira alternativa de instalar mais de uma wiki usando o mesmo servidor, base de dados e fonte, ver Steve Rumberg's (archived version), artigo excelente com comentários adicionais dos usuários.

O MediaWiki funciona com o safe_mode habilitado?

Sim, mas somente até certa limitação. Ver Safe mode para maiores informações.

O MediaWiki requer acesso shell (SSH)?

Acesso shell (SSH) não é necessário para instalar o MediaWiki, mas é altamente recomendado. Sem acesso shell, pode ser difícil até para fazer um backup de seu wiki, ou um upgrade para uma nova versão. Algumas tarefas de manutenção não são possíveis sem acesso shell. Muitas extensões maiores funcionam melhor com acesso shell.

Como é que eu instalo as extensões?

Ver Manual:Extensões para obter informações sobre instalar e criar extensões. Ver Categoria:Extensões para encontrar extensões existentes.

Como é que eu adiciono espaços de nome extra?

Ver Creating a custom namespace.

Como é que eu ativo o carregamento de arquivos?

O carregamento de arquivos é uma funcionalidade do MediaWiki normalmente utilizada, mas é desativada por predefinição em todas as versões de lançamento atuais. Para habilitá-la, primeiro é necessário criar um diretório (por padrão images) com permissões de escrita pelo servidor web (chmod -R 777 ./images ou permitir que o usuário Apache escreva nela etc.) e então alterar $wgEnableUploads para true no LocalSettings.php. Se você receber um erro "failed to mkdir" quando tenta carregar, provavelmente significa que há um problema de permissão.

Ver também: Manual:Configuring file uploads

Como é que eu permito o carregamento de formatos adicionais?

O MediaWiki requer que formatos e extensões de arquivos carregados permitidos sejam especificados utilizando a diretiva de configuração $wgFileExtensions . Geralmente, esta diretiva está no LocalSettings.php, na raiz de sua instalação de MediaWiki.

Por exemplo, para permitir o carregamento de arquivos PDF, adicione o seguinte no LocalSettings.php:

$wgFileExtensions[] = 'pdf';

Para permitir o carregamento de mais de um tipo de arquivo, utilize a seguinte sintaxe:

$wgFileExtensions = array_merge($wgFileExtensions, array( 'pdf', 'txt', 'mp3' ));
Ver também: Manual:Configuring file uploads

Como é que eu ativo a inserção de fórmulas matemáticas?

O MediaWiki permite a inserção de fórmulas matemáticas. Ver Extensão:Math para instruções completas de instalação.

Como é que eu defino o fuso horário para o meu MediaWiki?

Ver Manual:Timezone

Como é que eu atualizo uma página em cache?

Para eliminar uma página em cache, tal como quando são feitas alterações da barra de navegação, adicione &action=purge no final da URL dinâmica da página.

https://www.mediawiki.org/w/index.php?title=Main_Page&action=purge

Ou ?action=purge ao final da URL encurtada da página:

https://www.mediawiki.org/wiki/Main_Page?action=purge

Ver também: Manual:Purgação , Manual:Parâmetros para index.php

Como é que eu desativo completamente a colocação em cache?

Inclua em seu arquivo LocalSettings.php as seguintes linhas:

$wgEnableParserCache  = false; // deprecated method
$wgParserCacheType  = CACHE_NONE;
$wgCachePages  = false;

"O arquivo está corrompido ou possui uma extensão inválida"

Alguns usuários relataram que, após adicionar um formato de arquivo à lista de extensões permitidas, um erro é exibido. O texto do erro é semelhante ao seguinte:

The file is corrupt or has an incorrect extension. Please check the file and upload again.

Possíveis soluções:

  • Defina o valor de $wgMimeDetectorCommand, por exemplo, no Unix ou Linux, ele seria
    $wgMimeDetectorCommand = "file --brief --mime";
  • Compile/instale a extensão PHP fileinfo
    • Fedora - yum install php-pecl-Fileinfo
Ver também: Manual:Mime type detection

O usuário inicial não foi criado pelo instalador, ou ele não é um administrador

Às vezes, o instalador não cria o usuário padrão, ou a tabela de usuários é perdida por alguma razão. Há algumas opções para resolver isso:

maintenance/createAndPromote.php

  • Se seu MediaWiki é anterior a 1.16, verifique se AdminSettings.php está configurado (ver AdminSettings.sample)
  • Execute maintenance/createAndPromote.php --username <nome do novo usuario> --password <senha do usuario> a partir da linha de comando. Inclua --bureaucrat na linha de comando se desejar que o usuário seja um bureaucrat, além de administrator.

Isto criará um novo usuário e o promoverá para adminsitrador. Para ajuda, rode o script com o parâmetro --help.

Alterar a base de dados

  • Execute o seguinte comando SQL na base de dados:
    • INSERT INTO user_groups ( ug_user, ug_group ) VALUES ( <id>, 'bureaucrat' ), ( <id>, 'sysop' );
<id> acima deve ser substituído pelo user ID apropriado, que você pode ser na página de preferências do usuário.
Nota: se $wgDBprefix for definido no arquivo LocalSettings.php, adicione o seu valor ao início do nome da tabela. Por exemplo, se $wgDBprefix é "XYZ", então o nome de tabela a ser utilizado é XYZuser_groups

Temporariamente, deixe que todos atribuam direitos para o seu usuário inicial

  Atenção: Você não deve deixar que outras pessoas acessem a sua wiki enquanto você faz isso, se escolher esse método. Esse método talvez deixe sua wiki temporariamente vulnerável a um ataque enquanto você executa o procedimento.

Esse método envolve essencialmente deixar que todos os usuários temporariamente modifiquem as permissões de usuário para promover um usuário

  • Registre uma nova conta utilizando o método normal (Special:UserLogin). Estar autenticado, utilizando esse método.
  • Adicione as seguintes linhas ao final do arquivo LocalSettings.php
    • $wgAddGroups['user'] = true;
  • Vá para special:userrights e adicione o usuário que você acabou de criar aos grupos "Administrator" (Administrador) e "Bureaucrat" (Burocrata).
  • Remova a $wgAddGroups['user'] = true; linha do seu LocalSettings.php . Este passo é muito importante, uma vez que até que você o remova, qualquer um pode alterar permissões, o que é ruim.

Como é que eu redefino a senha de um usuário do MediaWiki?

Consulte Manual:Resetting passwords

Como posso criar ligações de interwiki na minha wiki?

Ver Manual:Interwiki

Como é que eu posso encurtar os meus URLs?

(Ou seja, /wiki/Article_Name ao invés de /w/index.php?title=Article_Name)

Consulte Manual:Short URL

Como é que eu organizo páginas em subdiretórios como /wiki/subdir/NomeDaPágina?

Ver Manual:$wgNamespacesWithSubpages e Help:Subpáginas

Baixar e usar tudo de MediaWiki.org é livre?

Sim, livre e gratuito no mesmo sentido do Free software. Consulte Project:Direitos autorais para conferir sobre direitos autorais referentes ao conteúdo escrito desse site.

Como é que eu administro/gero os direitos do usuário?

Consulte Manual:Direitos de usuário para informações gerais Consulte Manual:Preventing access para métodos e estratégias de restringir acessos.

Como eu impossibilito que usuários anônimos editem qualquer página?

O método recomendado é modificar o valor da configuração de $wgGroupPermissions.

Edite LocalSettings.php e adicione a linha:

$wgGroupPermissions['*']['edit'] = false;

Se você usa a extensão Extensão:Filtro de abusos , algum administrador também pode desativar edições de determinados IPs temporariamente conforme necessário.

Veja também: Impedindo o acesso , Manual:Direitos de usuário

Como é que eu impossibilito que usuários anônimos leiam qualquer página?

  • Adicione isso ao final do arquivo LocalSettings.php:
$wgGroupPermissions['*']['read'] = false;

Consulte também Manual:$wgWhitelistRead . Consulte Manual:Impedir o acesso#Restringir a visualização de todas as páginas para mais informação.

Como é que eu faço para restringir a criação de contas?

  • Adicione isto ao final do arquivo LocalSettings.php:
$wgGroupPermissions['*']['createaccount'] = false;

Consulte Manual:Impedir o acesso#Restringir a criação de conta para mais informação.

Como é que eu solicito a especificação de um e-mail durante o registro?

Ver Manual:$wgEmailConfirmToEdit

Como é que eu coloco o MediaWiki no modo de "somente leitura"?

Versão do MediaWiki: 1.5
Consulte Manual:$wgReadOnly

Como eu modifico as preferências padrões de usuário?

Versão do MediaWiki: 1.4

As preferências padrões de usuário do MediaWiki estão no arquivo de "linguagem", ou languages/Language.php se você estiver usando Inglês. Não edite aquele arquivo, apenas o utilize como referência, como você faz com o arquivo DefaultSettings.php.

Digamos que você queira modificar o número padrão de respostas de pesquisa em uma página. Language.php diz:

 /* private */ $wgDefaultUserOptionsEn = array(
        ...
        'searchlimit'  => 20,
        ...
 )

Para modificar esse número para 50, coloque isto no seu arquivo LocalSettings.php:

 $wgDefaultUserOptions = array( 'searchlimit' => 50 );

Observe que você está configurando o $wgDefaultUserOptions, que contém as sobrecargas do site, não o $wgDefaultUserOptionsEn, que contém os padrões do software. Qualquer configuração em $wgDefaultUserOptions vai sobrescrever as definidas no arquivo de linguagem.

Para modificar os namespaces padrões a serem buscados, em qualquer versão do MediaWiki, defina $wgNamespacesToBeSearchedDefault no arquivo LocalSettings.php para um array mapeando os indexes dos namespaces para valores booleanos. Por exemplo, para pesquisar o namespace principal e o namespace categoria, utilize:

$wgNamespacesToBeSearchedDefault = array(
    NS_MAIN => true,
    NS_CATEGORY => true,
);

Em alguns casos, depois que você modificar preferências padrões de usuários, você talvez queira modificar as preferências de usuário de todas as contas existentes.

Se for o caso, use o script userOptions.php na pasta Maintenance (Manutenção). Utilize a opção "--dry" para executar pela primeira vez, acesse o impacto e parta daí. (--dry não escreve na base de dados)

php userOptions.php --dry --nowarn searchlimit --old 20 --new 50

Sempre faça backup da sua base de dados antes de fazer esse tipo de mudança (você não precisa fazer backup se você estiver utilizando --dry).

Veja também: Manual:$wgDefaultUserOptions

Como eu posso fazer o MediaWiki executar mais rápido?

Ver: Manual:Performance tuning

Como é que eu ativo uma lista drop-down de sugestões de busca?

Ver Manual:Enabling autocomplete in search box

Atualizando

Consulte Manual:Atualização

Movendo

É possível mover minha wiki para uma máquina diferente?

Sim. Deveria ser. Em essência, você fará um backup da sua instalação antiga e depois "restaurará" ela na nova máquina. Finalmente, você terá que fazer modificações adicionais para atualizar as configurações da wiki para que tudo aponte para as novas localizações.

Como é que eu movo a minha wiki para um servidor diferente?

Siga as instruções em Manual:Moving a wiki.

Modificando a interface

Como é que eu altero o logotipo?

O logotipo que aparece no topo à esquerda em cada página é determinado pela opção de configuração $wgLogo no arquivo LocalSettings.php.

Existem duas formas de mudar a logo:

  1. Carregue uma foto da sua wiki utilizando a interface normal de carregamento de arquivos. Isto permite alterar facilmente o logotipo, portanto pode ser interessante proteger a página da imagem caso utilize este método.
    Então adicione a linha $wgLogo no arquivo LocalSettings.php, por exemplo:
    $wgLogo = "{$wgUploadPath}/6/62/mylogo.png";
    
  2. Carregue uma imagem para o seu servidor de outra forma (como FTP, por exemplo).
    Adicione a linha $wgLogo para o arquivo LocalSettings.php, por exemplo:
    $wgLogo = "{$wgScriptPath}/mylogo.jpg";
    
    (Nesse exemplo, a imagem está na mesma pasta que o arquivo LocalSettings.php)

Se você quiser modificar a logo apenas em páginas específicas, sobrescreva a propriedade #p-logo css's background-image ou utilize uma extensão de terceiros, como Extension:LogoFunctions.

  Atenção: Não simplesmente sobrescreva a logo padrão instalada com o MediaWiki. (/resources/assets/wiki.png); esse arquivo talvez seja sobrescrito quando você atualizar.
Um bom tamanho para uma logo quadrada é de 135x135px ou 150x150px, mas a logo não precisa ser quadrada, especialmente se conter algum texto embaixo de uma imagem. O tamanho máximo da logo no Vector é ~160x160px, enquanto a do MonoBook é ~155x155px. Uma logo que for grande demais será cortada.

Como é que eu edito o CSS da wiki?

Você não deveria editar os arquivos CSS diretamente (como por exemplo common.less), porque tornará a atualização mais difícil se precisar aplicar as suas personalizações todas as vezes que você atualizar o software. Ao invés disso, você precisa editar uma página wiki chamada MediaWiki:Common.css se quiser aplicar as suas mudanças de CSS em todas as skins, ou uma página chamada MediaWiki:Vector.css se quiser aplicar as personalizações apenas para a skin Vector.

O conteúdo das páginas MediaWiki:Common.css e MediaWiki:Vector.css sempre sobrescreve os estilos padrões de CSS especificados nos arquivos da skin.

Como é que eu oculto a toolbar de navegação vertical esquerda?

Em outras palavras, como você faz o content div principal ocupar 100% da tela, ocultando a logo, toolbox, navegação e máquina de busca?

Para ocultar permanentemente, copie e cole o seguinte código na página MediaWiki:Common.css:

#column-content { margin: 0 0 .6em 0; }
#content { margin: 2.8em 0 0 0; }
#p-logo, .generated-sidebar, #p-lang, #p-tb, #p-search { display:none; }
#p-cactions { left: .1em; }

Para ocultar a toolbar quando o usuário pressionar F11, adicione esse código na MediaWiki:Common.js da sua wiki:

document.onkeydown = function( e ) {
	if( e == null ) e = event
	if( testKey( e, 122 ) ) { //F11
		appendCSS('#column-content {margin: 0 0 .6em 0;} #content {margin: 2.8em 0 0 0;} #p-logo, .generated-sidebar, #p-lang, #p-tb, #p-search {display:none;} #p-cactions {left: .1em;} #footer {display:none;}');
		return false;
	}
}

function testKey( e, intKeyCode ) {
	if( window.createPopup )
		return e.keyCode == intKeyCode
	else
		return e.which == intKeyCode
}

Como é que eu oculto as categorias no final de cada página?

Você pode ocultar a exibição das categorias de cada página modificando o seu MediaWiki:Common.css e adicionando:

.catlinks { display: none; }

Eu posso personalizar o logotipo no canto superior esquerdo? Se sim, como?

A logo é um bloco portlet sem uma seção pBody. É identificado pela id p-logo. A imagem de fundo é especificada pela variável $wgLogo, que é definida no arquivo DefaultSettings.php. Essa localização é relativa ao web server root e não ao root do sistema. Redefina isso no arquivo LocalSettings.php para mudar a imagem. Se você modificar de forma errada, não vai haver imagem na página; confira o log de erro do seu web server e ajuste de acordo com ele. Entretanto, o tamanho de p-logo precisa ser grande o suficiente para a logo se a logo não for para ser cortada. Isso é definido na folha de estilos (main.css no Monobook), na categoria p-logo style, a configuração padrão é:

#p-logo {
	z-index: 3;
	position: absolute; /*needed to use z-index */
	top: 0;
	left: 0;
	height: 155px;
	width: 12em;
	overflow: visible;
}

Observe que se você estiver utilizando uma logo de tamanho diferente e quiser modificar o CSS, por favor não modifique nenhuma das folhas de estilo do núcleo MediaWiki. Ao invés disso, adicione na página on-wiki css (MediaWiki:Monobook.css para monobook, MediaWiki:Vector.css para vector. MediaWiki:Common.css também irá funcionar para todos os temas)

Observe que uma tag está no topo da logo então se você está tentando reduzir o tamanho da logo portlet você também precisará mudar a #p-logo a e a #p-logo a:hover rules. A configuração padrão para isso é:

#p-logo a,
#p-logo a:hover {
	display: block;
	height: 200px;
	width: 12.2em;
	background-repeat: no-repeat;
	background-position: 35% 50% !important;
	text-decoration: none;
}

Como é que eu personalizo a ligação do URL do logotipo do site no canto superior esquerdo de todas as páginas que se ativa quando se clica sobre o logotipo?

Por padrão, clicar no logotipo do site leva você à página principal do site. Se você quiser mudar qual página interna é a "principal" página, edite MediaWiki:Página Principal

Para fazer com que a ligação do logotipo do site leve externamente a um URL arbitrário, você pode adicionar um gancho no seu LocalSettings.php para sobrescrever o href da página principal que é utilizado pelo logo.

/* Change the main page url used in things like the logo to an absolute url */
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfChangeMainPageURL';
function lfChangeMainPageURL( $sk, &$tpl ) {
	$tpl->data['nav_urls']['mainpage']['href'] = "http://www.your-desired-url.com/"; // Point the main page url to an absolute url
	return true;
}

/* Change the main page url used in things like the logo to a url of another page on the wiki */
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfChangeMainPageURL';
function lfChangeMainPageURL( $sk, &$tpl ) {
	$tpl->data['nav_urls']['mainpage']['href'] = Title::newFromText('ThePage')->getLocalURL(); // Point the main page url to a wiki page's url
	return true;
}

Como eu mudo o ícone que aparece na barra de endereço do browser (favicon)?

  • Simplesmente substitua o arquivo de imagem favicon.ico na pasta principal na sua wiki arquivo de imagem .ico que desejar.
  • Alternativamente edite a configuração $wgFavicon em "LocalSettings.php" e adicione $wgFavicon = "$wgScriptPath/path/to/your/favicon.ico";

Veja Manual:$wgFavicon para mais detalhes.

"Dica: A imagem do favicon deve ser de 16 x 16 pixels ou 32 x 32 pixels"

Regra de sobrescrita

If you are using a rewrite rule in .htaccess to remove "index.php" from the URL, you will also need to add an exception for .ico files. Simply add the following rule to your .htaccess:

RewriteRule .*\.ico$ - [L]

This rule must appear before the index.php rule.

Case sensitivity

When uploading the favicon file, be sure the filename is in lowercase. (That is, "favicon.ico", not "Favicon.ico".) A lot of servers (e.g., those on UNIX-like operating systems) will not be able to find the file unless its name is in lowercase.

Como personalizo a barra de navegação?

The contents of the navigation bar which appears to the left of each page using the Vector or the Monobook skin are determined by the MediaWiki:Sidebar page there on your wiki. For information on customising these, please see Manual:Interface/Sidebar.

How do I put a text message (sitenotice) on every page?

Put a text in the MediaWiki:Sitenotice page. It will be displayed on top of every article page.

You can also add text to MediaWiki:Anonnotice to create a message that only displays for logged-out users. It is often a good idea to transclude the site notice on the anon notice to make sure that logged-out users still get the information on the site notice.

How do I change which page is the main page?

By default, MediaWiki looks for a page with the title Main Page and serves this as the default page. This can be changed by altering the contents of MediaWiki:Mainpage to point to a different title. If this does not change the 'Main Page' link included on the sidebar at install time, edit MediaWiki:Sidebar.

How do I change the Main Page title?

Simply click on the "Move" tab, and move the page to the desired page title.

Usually you also want to change which page is the configured as "main page".

How do I hide the main page title?

MediaWiki does not have a built-in option to hide the main page title (see tarefa T8129), but you can use CSS to hide the title. Alternatively, you can use the NoTitle extension.

Add the following to MediaWiki:Common.css on your wiki:

body.page-Main_Page.action-view h1.firstHeading, body.page-Main_Page.action-submit h1.firstHeading { display: none; }

If your main page uses a localized name or you have renamed the main page you need to change the page-Main_Page part. You can find a correct parameter by viewing HTML source of the main page and searching for the body tag.

For example, if your language is Lojban, the body tag looks like this:

<body class="mediawiki ltr sitedir-ltr ns-4 ns-subject page-uikipedi_as_ralju skin-vector action-view">

Therefore you should put this line in your MediaWiki:Common.css instead:

body.page-uikipedi_as_ralju.action-view h1.firstHeading, body.page-uikipedi_as_ralju.action-submit h1.firstHeading { display: none; }

If you would like to hide the title of a "Main Page" in a specific namespace like "Help:Main_Page" add the following to MediaWiki:Common.css on your wiki:

body.page-Help_Main_Page.action-view h1.firstHeading, body.page-Help_Main_Page.action-submit h1.firstHeading { display: none; }

Note the difference: body.page-Help_Main_Page in comparison to body.page-Help:Main_Page. The latter will not work.

If this doesn't work, you may be using a skin that doesn't support this, or you moved your main page without updating MediaWiki:Mainpage, or you have a really old MediaWiki version.

If the skin uses a different element for the title than a h1 element with class firstHeading, you'll need to find the appropriate CSS selector to apply for that skin.

How can I hide the table of contents?

The table of contents (TOC) is automatically shown once there are four or more headings in the article. There are multiple ways to hide it.

For one page
Place the magic word __NOTOC__ in the page's wikitext.
For all pages
Install Extension:NoTOC
or
Add the following rule to MediaWiki:Common.css:
.toc, #toc { display: none; }
Per user
Users can add the same CSS rule to their common.css personal stylesheet.
Versão do MediaWiki: 1.22
Gerrit change 99430
There was a user preference to hide the table of contents, it was removed in MediaWiki 1.23 (phab:T54813).

How do I change the interface text?

Interface text is altered using the MediaWiki namespace. For each deviation from the default in the site language there is a page MediaWiki:Englishmessagename, and for each deviation from the default in each other language a page MediaWiki:Englishmessagename/languagecode. (Since release 1.9 there are no pages for messages equal to the default.). On creation of a page the edit box autofills with the default. When creating a page to override the default it is useful to first save the default version, to allow diffs with it. See also Help:Mensagem de sistema .

How do I change the interface language?

To change the default interface language, alter the value of $wgLanguageCode in LocalSettings.php, for example

$wgLanguageCode = "fr";

You may also need to bypass your browser's cache to see the changes.

The new default interface language will be applied to all users who haven't ever customised it.

If you want to provide users the possibility to create and choose pages and interface elements in languages other than the default one of the wiki, you need the Translate extension, which can make your wiki multilingual.

In old versions, the new default will not affect existing users, so if you're logged in, you will need to change your language settings in your preferences.

If you want to change the language settings for all existing users, use the userOptions.php maintenance script. For instance, to have all users with English set use French instead, run:

php userOptions.php language --old en --new fr

How do I remove the article/edit etc tabs?

For a little more control see: User:Subfader/Hide_page_tabs

Edit MediaWiki:Common.css on your wiki, and add this:

li#ca-edit { display: none; }

See the page source for the various #ca-* ids used in the content tabs.

Note: this will only work for Monobook and derived skins such as Modern and Vector (the default skin), and doesn't actually stop people from editing. To do that, see Manual:User rights.

How do I add/remove tabs throughout my wiki?

See Manual:User group CSS and JavaScript or write your own extension (See: Manual:Hooks/SkinTemplateNavigation ):

For example, to remove the talk tab and then add a tab that always goes to the main page you would save this code in extensions/AR-Tabs.php:

Versão do MediaWiki: 1.21
<?php
if( !defined( 'MEDIAWIKI' ) ){
	die( "This is not a valid access point.\n" );
}

$wgHooks['SkinTemplateNavigation'][] = 'replaceTabs';
function replaceTabs( &$skin, &$links) {  
	// Remove the talk action
	unset( $links['namespaces']['talk'] );
	$maintitle = Title::newFromText( wfMessage( 'mainpage' )->inContentLanguage()->text() );
	// Add an additional link
	$links['namespaces']['main'] = array(
		'class' => false, // false or 'selected', defines whether the tab should be highlighted
		'text' => wfMessage( 'sitetitle' )->text(), // what the tab says
		'href' => $maintitle->getFullURL(), // where it links to
		'context' => 'main',
	);
	return true;
}

and then add

require_once("extensions/AR-Tabs.php");

to the bottom of LocalSettings.php

How do I remove a tab on only one page?

Versão do MediaWiki: 1.9

For example, to remove the Discussion (talk) page tab from the Main Page, on the MediaWiki:Common.css page add:

body.page-Main_Page li#ca-talk { display: none !important; }

To modify MediaWiki:Common.css you must have administrative privileges.

See also: Manual:Hide page tabs

How do I remove a tab on all pages

Versão do MediaWiki: 1.9

For example, to remove the Discussion (talk) page tab on all wikipages, on the MediaWiki:Common.css page add:

#ca-talk { display:none!important; }

Other tabs to remove are #ca-history, #ca-viewsource, #ca-view (Read tab), #ca-nstab-main (Page tab).

Other drop down menu items you can remove are #ca-watch, #ca-move, #ca-delete.

To modify MediaWiki:Common.css you must have administrative privileges.

How do I hide the section edit links for users who are not logged in?

You can change the value of the $wgDefaultUserOptions configuration option.

Edit LocalSettings.php and add the line:

$wgDefaultUserOptions ['editsection'] = false;
Also see How do I stop anonymous users from editing any page?

How do I remove the "Talk for this IP" link at the top right (e.g. when $wgDisableAnonTalk is true)?

One option is to hide the link using the following CSS in the wiki page MediaWiki:Common.css in your wiki:

#p-personal #pt-anonuserpage {
    display: none;
}

Another option is, inside your LocalSettings.php file, to use the PersonalUrls hook to remove the link to the talk page of anonymous users:

$wgHooks['PersonalUrls'][] = 'lfRemoveAnonUserpageLink';
function lfRemoveAnonUserpageLink( &$personal_urls, $title ) {
	unset( $personal_urls['anonuserpage'] );
	return true;
}

How do I remove the "Create an Account or Login" link at the top right of the screen?

To remove the login / create account links from the personal_urls you can use this code in your LocalSettings.php to hook in and remove them:

$wgHooks['PersonalUrls'][] = 'lfRemoveLoginLink';
function lfRemoveLoginLink( &$personal_urls, $title ) {
	unset( $personal_urls['login'] );
	unset( $personal_urls['anonlogin'] );
	unset( $personal_urls['createaccount'] );
	return true;
}

How can I suppress actions and special pages?

NOTE: MediaWiki is not designed for this kind of usage! It should be noted that the following 'answer' is a hack that only 'works' with the Apache webserver. Note also that this system is not foolproof, it's just one step further than hiding the links (see above).

Suppressing actions and special pages can be useful when you want to create the illusion of a static website via a particular URL or VirtualHost, but also have an 'internal' view that is a true wiki. i.e. if you have an inward facing 'view' of your wiki that users can edit, and an outward facing 'view' that should appear like a static website (no history, no discussion, etc., etc.).

After hiding all the appropriate links (see above), if you are using the Apache web server, you can disable actions and special pages using the following rewrite rules:

# Lock down the site (disable MediaWiki commands)

RewriteEngine On

#RewriteLog /tmp/rewrite.log

#RewriteLogLevel 9

## See https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Parameters_to_index.php#Actions

RewriteCond %{QUERY_STRING} (.*action=.*)
RewriteRule .* http://www.my.domain.com?

RewriteCond %{REQUEST_URI} !^/index.php/Special:Search
RewriteCond %{REQUEST_URI}  ^(.*Special:.*)
RewriteRule .* http://www.my.domain.com?

## Catch a trick...
RewriteCond %{QUERY_STRING} ^(.*Special:.*)
RewriteRule .* http://www.my.domain.com?

Above, a request for 'http://www.my.domain.com/wiki/Page_name?action=edit', for example, will be simply rewritten to 'http://www.my.domain.com'. Similarly any page in the Special namespace (with the exception of Special:Search) will be rewritten to 'http://www.my.domain.com'. Remember, this is only a hack, and isn't intended as a solution for a secure CMS.

Note that you will need to adjust the above rules to match your specific URL naming schema.

Other issues to consider when trying to lock down a site like this is the API and POST requests for the wiki content (rather than GET).

How do I edit error messages?

Special:Allmessages contains a complete list of messages (error or otherwise), that can be edited.

How do I change the footer?

See: Manual:Footer , Manual:Configuration settings#Copyright

How can I edit / remove the Powered by MediaWiki image (and possible other images) from the footer?

You can hide the Powered by MediaWiki image by adding the following to your wiki's MediaWiki:Common.css:

#footer-poweredbyico { display: none; }

If you want to remove it completely in 1.17 and newer you can use $wgFooterIcons to remove it using this in your LocalSettings.php:

unset( $wgFooterIcons['poweredby'] );
Versão do MediaWiki: 1.16

In 1.16 and below you will have to use a hook to remove it:

$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfRemovePoweredBy';
function lfRemovePoweredBy( $sk, &$tpl ) {
	unset( $this->data['poweredbyico'] );
	return true;
}

Note that this will also remove other powered-by icons, e.g. also the one coming from BlueSpice.

If you wish to change the icon images, urls, alt text, or add new icons please see $wgFooterIcons' documentation.

How do I add a reply link to default signature tildes (~~~~) template?

You can customize signatures in MediaWiki:Signature / MediaWiki:Signature-anon.

For example, changing the entries to [[{{ns:user}}:$1|$2]] ([[{{ns:user_talk}}:$1|talk]]) will put a link to users' talk pages and [[{{ns:user}}:$1|$2]] ([{{fullurl:{{ns:user_talk}}:$1|action=edit&section=new}} Reply]) would give a more direct link.

Users can change their signature in their preferences.

How can I change what the <title> of each page is? Where do I make changes?

Most of the text that you want to change can be found in the namespace of MediaWiki.

In order to change titles, texts, announcements, etc., go to Special:AllMessages, where you will see the text associated with the pages you wish to change. You need to log in as an administrator to edit the protected entries in the MediaWiki namespace.

If you want to change the title in your browser, you need to edit MediaWiki:Pagetitle. Go there and edit it just like you would any other page in your wiki.

In recent versions of MediaWiki, MediaWiki:Pagetitle is $1 - {{SITENAME}} by default. If {{SITENAME}} is producing the wrong text for you, you need to set $wgSitename in your LocalSettings.php.

If $wgSitename is correct in LocalSettings.php but {{SITENAME}} is still wrong, it may be that you're using a user-contributed language file which incorrectly sets $wgSitename to a transliteration of "Wikipedia". Edit the language file to correct this. For example, the Hebrew language file is at languages/LanguageHe.php in your wiki directory.

Don't forget to clear your browser cache after you change your settings.

Does MediaWiki automatically capitalize the first letter of $wgSitename?

Yes. This can be changed using the $wgCapitalLinks configuration setting.

How do I make external links open in a new window?

See Manual:$wgExternalLinkTarget

How can I suppress MediaWiki from formatting URLs, tags, etc?

Put "<nowiki></nowiki>" tags around the URL or tag.

Example:

svn co <nowiki>http://svn.example.com/myproject/</nowiki>

Produces:
svn co http://svn.example.com/myproject/

How can I force users to preview before they save?

See: Manual:Force preview and Extension:ForcePreview

How do I add more buttons on the edit page?

See: Manual:Custom edit buttons

How can I get more special characters or tags clickable on the edit page?

For adding more selectable special characters, etc., below the edit field, see Extension:CharInsert .

How can I use a different skin (e.g. Wikipedia's old Monobook skin) on my wiki?

Versão do MediaWiki: 1.16

While the Vector skin is the default skin for all installations made with MediaWiki 1.17 and newer, the Monobook skin has been the default before. See Manual:$wgDefaultSkin for more information on configuring your default skin.

How do I disable external links from showing in the printable version of a page?

Edit the page MediaWiki:Print.css on your wiki and add the following code there:

#content a.external.text:after,
#content a.external.autonumber:after {
	content: none;
}

This will override the styles defined in the CSS files coming with the MediaWiki source code. For more information, see Manual:CSS .

If instead you want to have the external links underlined in the printable version, then also add the following code:

#content a.external {
    text-decoration: underline !important;
}

How do I change the text of the article (page name) tab of my wiki's main page?

To change the text of the tab, as one example used in Wikipedia, you first open the page "MediaWiki:Mainpage-nstab".

After you've done that, click Edit and type in the edit box the text you want to be seen later on the main page - that's it. Don't forget to save the page as well.

Utilização básica

Como faço para editar uma página?

Para editar uma página simplesmente clique na ligação editar que aparece em cada página. Utilizando o skin padrão Vector, ele estará na forma de uma aba no topo da página. Um formulário aparecerá, contendo o código existente. Quando você finalizar as modificações, clique no botão Salvar para aplicar suas mudanças.

Ver também: Help:Editando páginas

Como é que eu crio uma nova página?

Há várias formas de criar uma nova página:

  • Crie uma ligação para a página numa outra página, clique depois então na ligação vermelha que aparece
  • Navegue para a localização desejada na página, por exemplo http://www.example.com/index.php?title=New_page e clique na ligação Editar, Criar ou Criar origem.

Em algumas wikis, uma pesquisa sem sucesso por uma página irá conter uma ligação que permite editar essa mesma página.

Ver também: Help:Iniciando uma nova página

Como é que eu apago uma versão antiga de uma página?

Dados de versões antigas de páginas são mantidas na base de dados e podem ser acessadas através de funções de histórico da página. Isto é útil para revisar mudanças e corrigir ou reverter as não desejadas, mas em alguns casos os administradores podem desejar tornar esta informação indisponível, por razões legais, ou para reduzir o tamanho da base de dados.

  • Os administradores podem apagar uma revisão antiga de uma página apagando a página, e então seletivamente recuperando as revisões a serem mantidas
  • A extensão Oversight (também conhecida como HideRevision) pode ser usada para mover revisões nocivas para fora dos históricos de página em versões mais antigas do MediaWiki (<1.16).
  • Para MediaWikis mais novos (1.14+), você pode habilitar a função nativa RevisionDelete, que permite que usuários com privilégio removam cada revisão dos históricos de página.
  • O script de manutenção maintenance/deleteOldRevisions.php pode apagar em massa todas as revisões de páginas e seus registros de texto associados.
Ver também: Manual:Removing embarrassment

Como é que eu utilizo oversight/apagar revisões no histórico da página?

Ver: RevisionDelete

Você também pode apagar uma página, e depois restaurar somente as revisões que desejar.

Existe algum tutorial de edição disponível?

Há muitos tutoriais de edição disponíveis, a maioria em projetos-irmãos do Wikimedia, tal como Wikipedia. Há também referências de marcação, etc., disponíveis em "Meta".

Como é que visualizo uma página em formato de impressão?

O MediaWiki inclui folhas de estilos que automaticamente alteram o estilo de uma página apropriadamente quando impresso; usar a função imprimir ou visualizar impressão de seu navegador deve renderizar a página em um formato de impressão.

Você pode também visualizar o formato de impressão utilizando a ligação "versão de impressão" na barra lateral "Ferramentas" ou "Imprimir/exportar" se estiver utilizando a Collection extension.

Como é que eu utilizo predefinições?

Ver Help:Predefinições

Posso usar mídias (imagens, vídeo, audio, etc.) do Wikimedia Commons em minha versão instalada do MediaWiki?

Sim, isto é encorajado através do uso de Manual:$wgUseInstantCommons .

Ver também: InstantCommons

Como é que eu utilizo uma predefinição como assinatura?

Quando você verificar suas preferências, verá um check box para "raw signature". Mas o campo só aceitará um certo número de caracteres. E se você quiser mais?

Você precisará criar duas páginas, possivelmente em seu userspace.

  1. Crie a primeira página (FIRST PAGE)
  2. Vá para suas preferências, marque a caixa "raw signature" e coloque {{FIRST PAGE}} na assinatura. Salvar
  3. Crie uma segunda página (SECOND PAGE) (possivelmente uma sub-página da primeira)
  4. Volte para a primeira página (FIRST PAGE) e faça {{SECOND PAGE}}
  5. Vá para a segunda página (SECOND PAGE) e insira o código que você deseja como assinatura.

Se você não tiver esta estrutura, você ainda poderá inserir todo o código de sua assinatura no raw code sempre que sua assinatura for usada, porque o software irá inserir "SUBST" em suas preferências. Você pode não se importar com isso, e nesse caso precisará somente de uma página.

Se você quiser que o código bruto exiba somente {{FIRST PAGE}}, que é bem mais limpo, então você precisará usar a estrutura de duas páginas.

Como é que eu adiciono a funcionalidade de sandbox à minha instalação de wiki?

Em termos wiki, uma sandbox é simplesmente um "cercadinho"; uma página que os usuários podem bagunçar à vontade. É uma página comum, criada de uma forma comum, e pode estar localizada onde você desejar. Não há nenhuma funcionalidade especial sandbox no MediaWiki.

Os usuários muitas vezes perguntam sobre sandboxes da Wikipedia, que parecem esvaziar-se automaticamente. Isto não é exatamente correto; há vários voluntários que executam bots para limpá-los de forma que retornem a um certo estado, a intervalos de tempo regulares.

Como é que eu adiciono uma ligação para "Sandbox" nas ferramentas pessoais (canto superior direito)?

Você precisa adicionar a extensão Gadgets e adicionar o gadget Sandbox.

Você provavelmente também desejará fazer um gadget padrão.

Como faço para que a minha wiki seja apresentada em todos os idiomas?

Para tornar sua wiki multilíngue e adicionar uma ferramenta de tradução, permitindo a tradução de páginas da interface padrão (como a barra lateral), use a extensão Translate; há bastante documentação sobre ela.

Wiki Importing

Importing from MediaWiki XML dumps

See Manual:Importing XML dumps

Importing from other types of wiki software

Note: The following is directly copied from old meta FAQ. It might need to be corrected.

There is some documentation about importing in the UPGRADE file distributed with MediaWiki.

To follow on from those, this is how at least one individual imported pages from usemod to MediaWiki:

Because MediaWiki does not automatically link to CamelCase style links, you will need to add brackets [[ ]] to all your links. You can do this with the following:

First, obtain ImportStage1.txt (or whatever you want to call it) from the importUseModWiki.php script ( use > to pipe the output to a file )

Second, do

sed '/Importing/!s/\ [A-Z]\w*[a-z]\w*[A-Z]\w*[a-zA-Z]/\ \[\[&\]\] /g'
    ImportStage1.txt > ImportStage2.txt

This should create proper links in place of your CamelCase links.

This doesn't work so well for SubPage links - someone care to fix?

Then,

sed 's/upload\:\w*\.\w*/http\:\/\/aberwiki\.org\/uploads\/& /g'
    ImportStage2.txt > ImportStage3.txt

This fixes your upload links. Change the replace text so it fills in your url such as http://www.yourwiki.org/uploads/filename

You are now ready to import ImportStage3.txt into your database with a command such as

mysql -u<mysqluser> -p<yourpass> <db name> < ImportStage3.txt

Note: If your importUseModWiki.php outputs an XML file instead of SQL statements, this probably means you have a rather new version of MediaWiki. In such a case, you can import the XML file -- see Importing a Wikipedia database dump into MediaWiki, towards the bottom of the page ('Import XML'). Don't forget to rebuild all the tables -- that page also explains how to do that.

Importing from other types of files

There are a variety of tools available to help convert content from HTML (and other formats) to MediaWiki markup.

Developer and SysAdmin tools
End-user tools
Instructions

MediaWiki auto importing script

Taken from wiki_import - MediaWiki auto import script:

Description

The script is designed to import a whole folder of files into MediaWiki, with the folder directory tree mapped as wiki category hierarchy.

Features

  • economic, build wiki site from existing knowledge base collection without "double-entry"
  • persistent, map folder directory tree as wiki category hierarchy
  • sophisticated, import/handle all well-known file types automatically
  • complete, cover every applicable scenario, even the case when you need to control access to individual wiki pages
  • versatile, highly customizable

Quick Help

wiki_import.sh $ $Revision: 1.1 $

mediawiki automatic file import script

Usage: wiki_import.sh [OPTIONS]...

The script is designed to import a whole folder of files into mediawiki, with the folder directory tree mapped as wiki category hierarchy.

The specification of the file-to-import is passed from standard input.

Options:

 -s, --sect=n     the root category section of the wiki of the imported article (mandatory)
 -1, --header     include standard header (category hierarchy path & notice)
 -l, --link       link to actual file on the web site
 -f, --footer     include standard footer (article category)
 -R, --res[=p]    add restricted tag in the footer as
                    '{{<Res Param|Root Category> Restricted}}' (default=`$_opt_sect')

Configuration Options:

 -p, --php=fn     mediawiki import php script specification
 -r, --root=n     the root category name for the whole wiki site
 -m, --max=n      max_allowed_packet for mysqld to import
 -u, --user=n     wiki user used for the import
 -a, --arch=p     the root url that linked-to archive files based on

Examples:

 echo ./path/to/file.ext | wiki_import.sh -1 -l -f -s 'Customer Support' -R 

For the rest of details, check out wiki_import.

Templates imported from other wikis (such as Wikipedia) don't work for me

You probably need to install some extensions used on the source wiki, such as ParserFunctions or sometimes Cite. Also, make sure that you copied all site CSS and JavaScript required by the template.

Customising further

I want to have multiple wikis, but only require registration once

  • If you're starting from scratch or you're switching from one wiki to multiple, you can use $wgSharedDB and $wgSharedTables to have all wikis share the user table of the "main" wiki. You can share other tables as well, as long as they don't contain any data dependent on non-shared tables or data specific to one wiki. See Manual:Shared database for examples and more information.
  • If your wikis are already established and you want to switch to a single sign-on, you can use the CentralAuth extension. It has a few more features than a shared user table, but it's more difficult to configure and it's tailored toward a Wikimedia-style setup. However, it is easier than attempting to completely merge multiple user tables into one.

How can I allow use of HTML tags?

See Manual:$wgRawHtml as well as Manual:$wgGroupPermissions e Manual:Preventing access .

  Atenção: This can be easily abused to attack users

See Extension:Secure HTML and Extension:HTMLets for ways to make this safer.

How do I fix problems or add features to MediaWiki?

The basic steps to improving MediaWiki (that is, becoming a MediaWiki developer) are:

  • Install Git
  • Download the Git "clone" of the MediaWiki source code
  • Get a server, a database, and PHP running on your computer (this can be annoying, so please ask for help if something isn't working)
  • Get MediaWiki running on your computer off that Git checkout (can be annoying as well, so, ditto)
  • Fix the problem or add the feature you were thinking of
  • Edit the source code of the relevant file(s) to fix the problem
  • Follow Gerrit/Tutorial

How do I run a bot?

See Manual:Bots

You might want to use the Pywikibot framework.

How do I change noindex nofollow

Set $wgNoFollowLinks = false; in LocalSettings.php

How do I create a small wiki farm?

See: Manual:Wiki family

How do I add meta tags?

The OutputPage class includes an addMeta method which can be used to add meta tags. The RequestContext can be used to get the relevant OutputPage object.

To add further Meta tags just add further lines as last lines of the function addMetaTags() like:

$out->addMeta ( 'description', 'This is a meta description.' );

Why...?

…is the Help namespace empty?

The Help namespace currently ships in a blank state. It's up to you how much or how little help you give to your site visitors and whether this relates to other aspects of your site. Obviously you can easily link your visitors to help resources elsewhere.

We don't currently have a clean, internationalised set of help pages under a free license. However, if you want to copy in some help information onto your site, about how to use a wiki (a MediaWiki powered wiki) you are free to copy the Help:Conteúdo from this wiki. This set of pages have been deliberately created for this purpose, with wiki-neutral information, and no license restrictions. See Project:PD help. More help is available at the Meta-Wiki MediaWiki Handbook.

…are some of my images not showing up after an upgrade?

Several users have reported that, following an upgrade or a moving of their wiki, several images fail to be shown inline. The files exist, and the image description pages show a MIME type of unknowncode>/unknown and, in some cases, a warning about potentially dangerous files.

To fix this, run the maintenance/rebuildImages.php script from the command line. This will set MIME information for each file in the database.

Recent versions of MediaWiki implement responsive images. Due to a bug, if the server locale is set to one that uses commas instead of dots for representing a decimal point, images may not render on some browsers/devices. This can be confirmed by inspecting a thumbnail of a medium or big image on a page with the browser tools, looking at the HTML code, and see if the srcset attribute contains commas instead of dots when representing the 1.5x value.

…are all PNG files not being turned into thumbnails?

After upgrading to a more recent version of PHP, it is possible a different MimeMagic.php function is being used to detect file MIME types, particularly the built-in PHP function mime_content_type, which fails to detect PNG files. Search the web for mime_content_type png for information on fixing this bug at the PHP level, possibly by editing your magic.mime file.

See here for more info.

…is a search for a short keyword giving no hits?

By default, MediaWiki uses MyISAM's fulltext matching functionality to allow searching page content. The default settings for this mean that words of less than four characters won't be indexed, so will be ignored in searches with older versions of MediaWiki.

MediaWiki 1.13 and earlier are unable to work around this; you must either change MySQL/MariaDB's configuration to index shorter words, or upgrade to a more recent version of MediaWiki.

Note that some particular words may still not be indexed if they are in MySQL/MariaDB's default stopword list.

…can't I download MediaWiki 1.34?

MediaWiki 1.34 is in a development state at present, and has not been packaged into a general release. The code can be downloaded from Git if desired. Or, if you want the latest development version packaged as an archive, get it at mediawiki-master.tar.gz (GitHub).

…doesn't this work? It works on Wikipedia!

Wikipedia and other Wikimedia web sites use the current version of the code in development; at present, this is MediaWiki 1.35.0-wmf.8 (eff2964), pulled from the current development branch. Coupled with the use of several extensions, this means that functionality between these wikis and your particular setup may differ.

  • To obtain the current development code, read Download from Git
  • To check what version a Wikimedia wiki is running, as well as what extensions are installed, visit the Special:Version page for that wiki

…do I get a 403 Forbidden error after setting permissions on my Fedora system?

Fedora Core enables SELinux by default. Instructions for setting SELinux permissions for MediaWiki are available.

…do I get Installing some external dependencies (e.g. via composer) is required?

Many web hotels only handle zip archives, and we only provide gz compressed tar archives, thus the archives has to be recompressed before uploading. This should not be much of a hurdle, but it seems like some archive tools occasionally fails to include all files in large archives. When this happen the vendor folder is left out, leaving the user with the rather non-explanatory error message.

Use a command line tool when recompressing the tar archive into a zip archive.

…do I get logged out constantly?

This is probably related to cookies or session data, for example a problem with PHP's session.save_path setting. See Log in problems for information.

If this is happening constantly to all users, it probably means that caching is misconfigured. Setting $wgSessionCacheType = CACHE_DB; can be used to determine if caching is the cause of the problem. If that solves the problem, you should still investigate what is wrong with your caching configuration.

…doesn't my wiki work on Sourceforge?

See Manual:Installing MediaWiki on SourceForge.net .

…is it a good idea to keep user accounts?

At many times you just want to remove a user account out of the wiki either because it belonged to a spammer account or you just feel like it. The appropriate choice is to block the account or rename it if needed. Here is why:

Do I just remove his row from the User table?

Rob Church posted the following regarding this issue on the wikitech-l mailing list:

"If the user has made edits, then removing rows from the user table cause theoretical loss of referential integrity. Now, to be honest with you, I can't think of any conditions where this would cause an actual problem; "undefined behaviour" is the phrase we use.

What I'd suggest doing, to be on the safe side, is running a couple of quick updates against the database:

UPDATE revision SET rev_user = 0 WHERE rev_user = <current_user_id>
UPDATE archive SET ar_user = 0 WHERE ar_user = <current_user_id>

What this will do is cause MediaWiki to treat the revisions as having been made anonymously when generating things like page histories, which should eliminate any problems caused by these routines attempting to check user details from other tables.

If the user has caused log entries, i.e. rows in the logging table, or uploaded images, then the situation becomes trickier, as you'll have to start mopping up all the rows everywhere and it could become a bit of a mess, so if the user's done anything other than edit, I would strongly recommend just blocking them indefinitely.

If the username is offensive or undesirable, then you could consider renaming it using the RenameUser extension."

Another option is to give Admins the 'hideuser' right, and indefinitely block the user with the Hide username from edits and lists option selected.

Extension:UserMerge is also useful.

Anti-spam

Where do I get the spam blacklist from and how do I install it?

The spam blacklist extension can be found in Git, just like all other officially supported extensions. For installation and configuration instructions, consult the README file and extension page over here.

How do I use $wgSpamRegex to block more than one string?

$wgSpamRegex is a powerful filter for page content. Adding multiple items to the regex, however, can be awkward. Consider this snippet:

$wgSpamRegexLines[] = 'display\s*:\s*none';
$wgSpamRegexLines[] = 'overflow\s*:\s*auto';
[...]
$wgSpamRegex = '/(' . implode( '|', $wgSpamRegexLines ) . ')/i';

This example code allows convenient addition of additional items to the regex without fiddling about each time. It also demonstrates two popular filters, which block some of the most common spam attacks.

See also: Extension:SpamRegex

Are there additional ways to fight spam?

See Manual:Combating spam for an overview of anti-spam measures such as Captcha, content filtering and restricting edition.

Anti-vandalism

See Manual:Combating vandalism for hints and suggestions on how to deal with wiki vandalism.

Where now?

I've found a bug or have a feature request. Where do I post it?

Bugs and feature requests should be posted on Phabricator . See How to report a bug.

I'm getting a strange error. What now?

I tried that but it didn't work

I had a problem, I came to this page and it told me how to fix it. But it didn't work, the problem is still there!!!!

Nine times out of ten this is because you didn't clear your cache. The simple test for this is to request a page that hasn't been requested before. Select the part of the URL in the address bar that contains the page title (e.g. Main_Page). Twiddle your fingers on the keyboard for a while, hit enter. Check if the problem is on that page too.

MediaWiki uses both a server-side cache and a client-side cache, so clearing your browser cache is often not enough. See the relevant entry above for more details.

Here are some other things to check:

  • Were you editing the right file? Try inserting some garbage into the file you edited, does it break anything?
    • A great debugging tool in this case is to create a file called phpinfo.php, containing only <?php phpinfo() ?>. Upload it into your web directory and invoke it with your browser. Check the document root and the path to php.ini.
  • Were you editing the right part of the file? Did you create a duplicate entry in php.ini? Add new settings to the end of LocalSettings.php, not to the beginning.
  • If you created a .htaccess, are you sure AllowOverrides is on? Ask your hosting provider.

I have a question not answered here. Where do I go next?

If you've exhausted the FAQ above, please try the following:

Still no luck. Where can I ask for help?

Recommended reading

References