Manual:FAQ/pt-br



Quais são as diferenças entre o MediaWiki, a Wikimedia, Wikipédia e wiki?
Esta é uma questão comum; por favor acesse 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.

Onde eu baixo 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 leva entre 10 e 30 minutos, e envolve fazer upload ou copiar arquivos, e executar o script do instalador para configurar o software. Consulte o Guia de instalação, onde você também encontrará os requisitos mínimos de sistema.

Como instalar o MediaWiki usando 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: 

Posso instalar mais de uma wiki em um servidor utilizando o MediaWiki?
É possível instalar mais de uma wiki em um servidor, desde que:

Ou
 * Você use uma base de dados diferente para cada wiki
 * 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:Wiki family.

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 instalar extensões?
Ver Manual:Extensions para obter informações sobre instalar e criar extensões. Ver Category:Extensions para encontrar extensões existentes.

Como adicionar namespaces extras?
Ver Creating a custom namespace.

Como habilitar o uploading?
O upload de arquivos é uma funcionalidade muito usuada do MediaWiki, mas está desabilitada por padrão em todas as versões atuais. Para habilitá-la, primeiro é necessário criar um diretório (por padrão ) com permissões de escrita pelo servidor web (  ou permitir que o usuário Apache escreva nela, etc.) e então configurar $wgEnableUploads para   no LocalSettings.php (isto é, "$wgEnableUploads = true;"). Se você receber um erro "failed to mkdir" quando tentar fazer o upload, provavelmente significa que há algum problema de permissão.


 * Ver também: 

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

Como definir a timezone para minha MediaWiki?

 * Ver: Manual:Timezone

Como eliminar 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   no final da URL dinâmica da página.

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

Ou  ao final da URL encurtada da página:

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


 * Ver também:, 

Como desabilitar completamente a função de caching?
Inclua em seu arquivo LocalSettings.php as seguintes linhas:

= false; = false;

Como permitir o upload de formatos adicionais?
O MediaWiki requer que formatos de arquivo permitidos para upload sejam especificados usando a diretirva de configuração $wgFileExtensions. Geralmente, esta diretiva está no LocalSettings.php, na raiz de sua instalação de MediaWiki.

Por exemplo, para permitir o upload de arquivos PDF, adicione o seguinte em LocalSettings.php:

Para permitir o upload de mais de um tipo de arquivo, use a seguinte sintaxe:


 * Ver também: 

"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
 * Compile/instale a extensão PHP fileinfo
 * Fedora - yum install php-pecl-Fileinfo
 * Fedora - yum install php-pecl-Fileinfo


 * Ver também: 

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  está configurado (ver  )
 * Execute  a partir da linha de comando. Inclua   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.

Alterar a base de dados

 * Registrar uma nova conta usando o método normal (Special:UserLogin).
 * Verifique o user ID em Special:Preferences.
 * Execute o seguinte comando SQL na base de dados:
 * acima deve ser substituído pelo user ID apropriado, que você pode ser na página de preferências do usuário.
 * Nota: se  for definido no arquivo LocalSettings.php, adicione o seu valor ao início do nome da tabela. Por exemplo, se   é "XYZ", então o nome de tabela a ser utilizado é
 * Nota: se  for definido no arquivo LocalSettings.php, adicione o seu valor ao início do nome da tabela. Por exemplo, se   é "XYZ", então o nome de tabela a ser utilizado é

Temporariamente, deixe que todos atribuam direitos para o seu usuário inicial
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). Esteja logado utilizando a conta.
 * Add the following lines to the bottom of LocalSettings.php
 * Vá para special:userrights e adicione o usuário que você acabou de criar aos grupos "Administrator" (Administrador) e "Bureaucrat" (Burocrata).
 * Remova a  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.
 * Remova a  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 reseto a senha de um usuário do MediaWiki?

 * "Veja Manual:Resettings passwords"

Como posso criar links interwiki na minha wiki?

 * "Veja Manual:Interwiki"

Como posso encurtar minhas URLs?
(Ou seja, /wiki/Article_Name ao invés de /w/index.php?title=Article_Name)
 * Veja Manual:Short URL

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

 * Veja Manual:$wgNamespacesWithSubpages, Help:Subpages

Baixar e usar tudo de MediaWiki.org é livre?
Sim, livre e gratuito no mesmo sentido do Free software. Veja Project:Coryrights para conferir sobre direitos autorais referentes ao conteúdo escrito desse site.

Como administro/gero díreitos do usuario?

 Veja Manual:User rights para informações gerais Veja 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. Edite  e adicione a linha:

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


 * Veja também:, 

Como eu impossibilito usuários anônimos de ler qualquer página?

 * Adicione isso ao final do arquivo LocalSettings.php:

Veja também Manual:$wgWhitelistRead. Veja Manual:Preventing access para mais informações.

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

 * Adicione isto ao final do arquivo LocalSettings.php:

Veja Manual:Preventing access para mais informações.

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

 * "Veja Manual:$wgEmailConfirmToEdit"

Como eu coloco o MediaWiki no modo "apenas leitura"?

 * "Ver Manual:$wgReadOnly"

How do I change default user preferences?
The MediaWiki default user preferences are in the language file, i.e.  if you're using English. Don't edit that file, just use it for reference, like you do with DefaultSettings.php.

Say if you want to change the default number of search results on a page. Language.php says:

To change it to 50, put this in your LocalSettings.php:

Note that you are setting $wgDefaultUserOptions, which contains the site overrides, not $wgDefaultUserOptionsEn, which contains the software defaults. Any settings in $wgDefaultUserOptions will override those set in the language file.

To change the default namespaces to be searched, in any version of MediaWiki, set $wgNamespacesToBeSearchedDefault in LocalSettings.php to an array mapping namespace indexes to boolean values. For example, to search the main namespace and the category namespace, use:

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

In some cases, after you change a default user preference, you may also want to change the user preferences of all existing user accounts.

If so, use the userOptions.php script in the Maintenance directory. Use the "--dry" option for the first run, assess the impact and go from there. (--dry does not write the database)

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

Also, always backup your database before making these kinds of changes (you do not need to if you are just using --dry).


 * ''See also:

How can I make Mediawiki run faster?

 * See: 

How do I enable a drop-down list of search suggestions?

 * See: Manual:Enabling autocomplete in search box

Upgrading

 * See: Manual:Upgrading

Is it possible to move my wiki to a different machine?
Yes. It should be. In essence, you will be backing up your old installation and then "restoring" it onto the new machine. Finally, you will have to make additional modifications to update the wiki configuration so that everything points to the new location.

How do I move my wiki to a different server?
Follow the instructions at Manual:Moving a wiki.

How do I change the logo?
The logo that appears in the top left of each page is determined by the $wgLogo configuration line in the LocalSettings.php file.

There are two ways to change the logo:


 * 1) Upload a picture to your wiki using the normal file uploading interface. This allows the logo to be replaced easily, so you may want to protect the page if you use this method.
 * Then add the $wgLogo line to LocalSettings.php, for example:
 * 1) Upload an image to your server by other means (such as FTP).
 * Add the $wgLogo line to LocalSettings.php, for example:
 * (In this example, the image is in the same folder as the LocalSettings.php file.)
 * (In this example, the image is in the same folder as the LocalSettings.php file.)
 * (In this example, the image is in the same folder as the LocalSettings.php file.)

If you want to change the logo in only specific pages, override #p-logo css's background-image property or use third party extension like Extension:LogoFunctions.

How do I edit the wiki's CSS?
You shouldn't edit the CSS files (such as common.less) directly, because it will make upgrading harder if you need to apply your customizations each time you upgrade the software. Instead you need to edit a wiki page called MediaWiki:Common.css if you want to apply your CSS changes for all skins, or a wiki page called MediaWiki:Vector.css if you want to apply the customizations only for the Vector skin.

The content of the MediaWiki:Common.css and MediaWiki:Vector.css pages always overrides the default CSS styles specified in the skin files.

How do I hide the left vertical navigation toolbar
In other words, how do you make the main content div take up 100% of the display, hiding the logo, toolbox, navigation and search engine?

To hide it permanently, copy and paste the following into the MediaWiki:Common.css page:

To instead hide the toolbar when the user presses F11, enter this in your wiki's MediaWiki:Common.js:

How do I hide the categories at the bottom of each page?
You can hide display of the categories on each page by modifying your MediaWiki:Common.css and adding:

Can I customize the logo in the top left corner? If so, how?
The logo is a portlet block without a pBody section. It is identified by the p-logo id. The background image is specified by the $wgLogo variable, which is defined in DefaultSettings.php. This location is relative to the web server root and not the system root. Redefine this in LocalSettings.php to change the image. If set wrong there will be no image on the page; check your web server error log and adjust accordingly. However the size of the p-logo will need to be big enough for the logo if it is not to be clipped. This is set in the stylesheet (main.css in Monobook), under the p-logo style, the default setting is:

Note, if you are using a different sized logo, and want to change the CSS, please do not modify any of the core MediaWiki stylesheets. Instead add to the on-wiki css page (MediaWiki:Monobook.css for monobook, MediaWiki:Vector.css for vector. MediaWiki:Common.css will also work for all skins)

Reducing the size of the logo
Note that a tag is on top of the logo so if you are trying to reduce the size of the logo's portlet you will also need to change the #p-logo a and #p-logo a:hover rules. The default setting for these is:

How do I customize the link-URL of the site-logo in the top left corner of all pages that activates when the site-logo is clicked upon?
By default, clicking the site-logo takes you to the main site-page. If you want to change which internal site-page is the "main" site-page, edit MediaWiki:Mainpage.

To make the link of the site-logo link externally to any other arbitrary URL, you can add a hook to your LocalSettings.php to override the mainpage href which is used by the logo.

How do I change the icon in the browser's address line (favicon)?

 * Simply upload your favicon.ico to the root of your domain/subdomain, make sure file name is in lower case and its name is favicon.ico
 * Alternatively edit the $wgFavicon setting in LocalSettings.php and add

See Manual:$wgFavicon for more details.

Tip: The favicon image should be either 16 x 16 pixels or 32 x 32 pixels.

Rewrite Rule
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.

How do I customize the navigation bar?
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 ), but you can use CSS to hide the title. Alternatively, you can use the NoTitle extension.

Add the following to on your wiki:

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

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

Therefore you should put this line in your instead:

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

Note the difference:  in comparison to. 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  element with class , 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  in the page's wikitext.


 * For all pages
 * Install Extension:NoTOC
 * or
 * Add the following rule to MediaWiki:Common.css:


 * Per user
 * Users can add the same CSS rule to their common.css personal stylesheet.


 * There was a user preference to hide the table of contents, it was removed in MediaWiki 1.23 (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.


 * For a list of system messages, see Special:Allmessages
 * To switch off the MediaWiki namespace, see the $wgUseDatabaseMessages configuration setting
 * To remove the Privacy policy or Disclaimers links at the bottom of each page, set the content of pages MediaWiki:Privacy or MediaWiki:Disclaimers respectively to a single hyphen.

How do I change the interface language?
To change the default interface language, alter the value of  in , for example

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.

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:

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:

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 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 :

and then add

to the bottom of LocalSettings.php

How do I remove a tab on only one page?
For example, to remove the Discussion (talk) page tab from the Main Page, on the MediaWiki:Common.css page add:

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


 * See also: 

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

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 configuration option.

Edit and add the line:


 * Also see 

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:

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

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 to hook in and remove them:

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:


 * 1) Lock down the site (disable MediaWiki commands)

RewriteEngine On


 * 1) RewriteLog /tmp/rewrite.log


 * 1) RewriteLogLevel 9


 * 1) See http://www.mediawiki.org/wiki/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?

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

Above, a request for, for example, will be simply rewritten to. Similarly any page in the Special namespace (with the exception of Special:Search) will be rewritten to. 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 and Manual:Configuration settings

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:

If you want to remove it completely in 1.17 and newer you can use to remove it using this in your :

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

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 ' 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  will put a link to users' talk pages and   would give a more direct link.

Users can change their signature in their preferences.

How can I change what the 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 - by default. If is producing the wrong text for you, you need to set $wgSitename in your LocalSettings.php.

If $wgSitename is correct in LocalSettings.php but 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  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 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 "  " tags around the URL or tag.

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

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?
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:

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:

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

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.

Como faço para editar uma página?
Para editar uma página simplesmente clique no link 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: 

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

Em alguns wikis, uma pesquisa por uma página sem sucesso conterá um link que permitirá você editar tal página.
 * Crie um link para a página em outra página, em seguida clique no link vermelho que aparecer
 * Navegue para a localização desejada na página, por exemplo  e clique no link Editar, Criar ou Criar origem.


 * Ver também: 

Como apagar 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  pode apagar em massa todas as revisões de páginas e seus registros de texto associados.


 * Ver também: 

Como usar oversight/apagar revisões no histórico da página?

 * Ver: 

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


 * A página Help:Editing pages deste site
 * Conteúdo de ajuda de Editing em Meta
 * O guia Como editar uma página no Wikipedia em português

Como visualizar o formato impresso de uma página?
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ê também pode visualizar este formato impresso usando o link "versão de impressão" na barra lateral "Ferramentas" ou "Imprimir/exportar" se estiver usando a Collection extension.

Como utilizar templates?

 * Ver Help:Templates

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: 

Como usar um template 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  na assinatura.
 * 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
 * 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, que é bem mais limpo, então você precisará usar a estrutura de duas páginas.

Como adicionar a funcionalidade 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 eu adiciono um link 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 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.

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 -p < ImportStage3.txt

Note: If your  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
 * HTML::WikiConverter::MediaWiki - a Perl module for converting from HTML to MediaWiki markup.
 * Wikificator - a Javascript MediaWiki extension that converts XHTML to MediaWiki markup.
 * The Edit.php and importImages.php maintenance scripts can be used to import text and images into MediaWiki.


 * End-user tools
 * HTML to Wiki Converter - an online HTML to MediaWiki markup conversion service. (Based on HTML::WikiConverter::MediaWiki)
 * wikEd - a text editor for MediaWiki that can import HTML (including Microsoft Word-generated HTML.)


 * Instructions
 * Brief notes on converting from Microsoft .chm help files to MediaWiki
 * Notes on converting from Microsoft Office formats to MediaWiki

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                     '' (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.

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 and Manual:Preventing access.

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

…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:Contents 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  and, in some cases, a warning about potentially dangerous files.

To fix this, run the  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  attribute contains commas instead of dots when representing the   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 {{#expr:{{MW stable branch number}}+.01}}?
MediaWiki 0000 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.

…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, 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 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  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:



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.

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 file and extension page over here.

How do I use $wgSpamRegex to block more than one string?
$wgSpamRegex (see Manual) is a powerful filter for page content. Adding multiple items to the regex, however, can be awkward. Consider this snippet:

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.

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?

 * See if it is covered by Manual:Errors and Symptoms
 * Try to find out more about the problem, see How to debug MediaWiki
 * See the section below for information on how to contact developers and other knowledgable users.

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


 * Check the other sources of help on this site
 * Search the rest of this site
 * Search older documentation archived on Meta; Useful developer documentation remains on Meta.wikimedia.org in the category Pages to be exported to MediaWiki.org until the m:Meta:MetaProject to transfer content to MediaWiki.org completes
 * Search the web
 * Dig into the source
 * See the section below for information on how to contact developers and other knowledgeable users.

Still no luck. Where can I ask for help?

 * Post a message at Project:Support desk
 * Email the mediawiki-l mailing list (try and search the archive first).
 * Ask the developers in our IRC channel.

Recommended reading

 * Asking smart questions
 * Effective bug reporting
 * Getting help on IRC
 * Books about MediaWiki