Manual:FAQ/pl

Skąd pobrać oprogramowanie MediaWiki?
Kliknij tu, y pobrać najnowsze stabilne wydanie oprogramowania MediaWiki. Pkiki dostarczane są w postaci archiwum .tar.gzip. Oprogramowanie MediaWiki można pobrać również bezpośrednio z repozytorium Subversion.

Jak zainstalować oprogramowanie MediaWiki?
Instalacja oprogramowania MediaWiki zajmuje pomiędzy 10 a 30 minut i składa się z przesłania na serwer / skopiowania plików i uruchomienia skryptu instalacyjnego, konfigurującego oprogramowanie – patrz dokument opisujący instalację lub kompletny przewodnik po instalacji.

Skrócony poradnik instalacyjny znajduje się w pliku INSTALL dostarczanym wraz z oprogramowaniem.

Jak zainstalować oprogramowanie MediaWiki korzystając z pakietu?

 * Zobacz również Software bundles/pl

Wiele dystrybucji Linuksa dostarczanych jest z oprogramowaniem MediaWiki w postaci pakietu przystosowanego do instalacji w systemie operacyjnym. Zespół deweloperów MediaWiki zaleca skorzystanie z dokumentacji dostarczanej z systemem w celu zasięgnięcia informacji o instalacji, konfiguracji i korzystaniu z poszczególnych pakietów. Społeczności i firmy zajmujące się wsparciem poszczególnych dystrybucji Linuksa powinny dostarczać informacji dotyczących instalacji.

Należy zwrócić uwagę na fakt, ze dystrybucje osób trzecich mogą zawierać nieaktualne wersje oprogramowania MediaWiki, więc w przypadku poszczególnych procedur i rozszerzeń należy zwracać uwagę na odpowiednie zapisy dokumentacji.

Czy na serwerze można uruchomić więcej niż jedną instalację MediaWiki?
Tak, zainstalowanie więcej niż jednej wiki na serwerze jest możliwe, jeśli spełni się następujące warunki:

LUB
 * każda wiki ma odrębna bazę danych
 * dla każdej wiki wykorzystywany jest inny prefiks bazy danych; w przypadku PostgreSQL możliwe jest to po zastosowaniu rożnych struktur i użytkowników

Informacje na temat takich instalacji znaleźć można na stronach odpowiednio $wgDBname i $wgDBprefix

Informacje na temat instalacji rodzin serwisów wiki znaleźć można na stronie Manual:Wiki family/pl.

Informacje na temat alternatyw w uruchamianiu więcej niż jednej wiki na danym serwerze przy wykorzystaniu tej samej bazy danych i plików źródłowych znaleźć można na stronach Steve'a Rumberga (archiwum), zawierającej również komentarze użytkowników.

Czy oprogramowanie MediaWiki działa przy włączonym &bdquo;safe mode&rdquo;?
Tak, lecz w sposób ograniczony. Patrz Safe mode/pl.

Czy oprogramowanie MediaWIki wymaga dostępu do shella?
Dostęp do powłoki (SSH) nie jest konieczny podczas instalacji oprogramowania MediaWIki, lecz zaleca się posiadanie takiej możliwości. Bez dostępu do powłoki niemożliwe moze się okazać sporządzenie kopii zapasowej wiki lub uaktualnienie jej do nowszej wersji. Niektórych działań konserwacyjnych nie da się bez dostępu do shella wykonać w ogóle.

Jak zainstalować rozszerzenia?
Patrz Manual:Extensions/pl, gdzie znajdują sie informacje na temat instalacji rozszerzeń, jak też na temat ich pisania. W kategorii Category:Extensions znajdują się opublikowane do tej pory rozszerzenia MediaWiki.

Jak dodawać nowe przestrzenie nazw?
By dodać nową przestrzeń nazw, należy wprowadzić zmiany w pliku LocalSettings.php, dodając nowe przestrzenie za pomocą zmiennej $wgExtraNamespaces. W celu dodania przestrzeni nazw &bdquo;Portal&rdquo; i odpowiadającej jej przestrzeni dyskusji można skorzystać z następującego kodu

Zamiast spacji należy stosować znaki podkreślenia, jak w przykładzie wyżej – Dyskusja_portalu. W przeciwnym przypadku przestrzeń nazw nie zostanie prawidłowo zadeklarowana.

Jak włączyć przesyłanie plików?
Przesyłanie plików jest często wykorzystywaną opcją w instalacjach MediaWiki, lecz w ustawieniach domyślnych opcja ta jest wyłączona. By ja aktywować najpierw należy zezwolić serwerowi na zapis w katalogu, gdzie przesyłane będą pliki (domyślnie images) wydając polecenie chmod 777, pozwalając serwerowi Apache na dostęp z zapisem do katalogu, itd. Następnie należy ustawić wartość $wgEnableUploads w pliku LocalSettings.php na true, np. $wgEnableUploads = true;. Więcej informacji znajduje się w dokumencie Manual:Configuring file uploads/pl.

Jak włączyć zagnieżdżone w tekście wzory matematyczne?
MediaWiki pozwala na osadzanie w treści stron wzorów matematycznych za pośrednictwem programu pomocniczego texvc, korzystającego w wyświetlaniu wzorów z oprogramowania LaTeX. Informacje o aktywacji tej opcji znajdują się w dokumencie Manual:Math/pl.

Jak oczyścić pamięć podręczną stron?
W celu wyczyszczenia pamięci podręcznej, na przykład po dokonaniu zmian w menu bocznym, należy do dynamicznego adresu strony dopisać polecenie.

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

lub dodać polecenie  do krótkiej wersji adresu strony:

Przykład: http://www.mediawiki.org/wiki/Main_Page?action=purge

Zobacz również Manual:Purge/pl i Manual:Parameters to index.php/pl

Jak zezwolić na ładowanie plików w innych niż standardowe formatach?
Oprogramowanie MediaWiki wymaga podania formatów plików, które można przesyłać do serwisu poprzez dyrektywę $wgFileExtensions. Zwykle jest ona zlokalizowana w pliku LocalSettings.php w głównym katalogu wiki.

Na przykład, by zezwolić na ładowanie plików z rozszerzeniem PDF, należy dodać następujący wpis do pliku LocalSettings.php:

By umożliwić przesyłanie więcej niż jednego typu plików, składnia dyrektywy jest następująca:

Szczegółowe informacje znajdują się w dokumencie Manual:Configuring file uploads/pl.

"File is corrupt or has an invalid extension"
Użytkownicy zgłaszali błąd polegający na tym, ze po umożliwieniu przesyłania dodatkowych formatów plików pokazuje się mniej więcej taki komunikat błędu:


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

Możliwe rozwiązania:


 * Ustaw wartość dla $wgMimeDetectorCommand; pod systemem Unix/Linux w sposób następujący:
 * $wgMimeDetectorCommand = "file --brief --mime";</tt>
 * skompiluj/zainstaluj rozszerzenie języka PHP fileinfo

Więcej informacji znajduje się w dokumencie Manual:Mime type detection.

Instalator nie stworzył pierwszego użytkownika wiki
Czasami instalator nie tworzy domyślnego użytkownika serwisu, lub z jakiegoś powodu dochodzi do utracenia tabeli użytkowników. Problem ten można rozwiązać na kilka sposobów:

maintenance/createAndPromote.php

 * Jeśli wykorzystywana jest wersja MediaWiki starsza niż 1.16, należy sprawdzić ustawienia pliku AdminSettings.php</tt>
 * W powłoce należy wydać polecenie maintenance/createAndPromote.php --username &lt;nowa_nazwa_użytkownika&gt; --password &lt;hasło_dla_użytkownika&gt;</tt>. Dodanie do polecenia flagi --bureaucrat</tt> spowoduje nadanie stworzonemu użytkownikowi uprawnień nie tylko administratora, ale i biurokraty. Podstawowa wersja polecenia tworzy użytkownika o zadanej nazwie i nadaje mu uprawnienia administratora. Pomoc do polecenia można uzyskać za pomocą parametru --help</tt>.

Zmiana bazy danych
gdzie  zamienić należy na identyfikator użytkownika pobrany ze strony preferencji.
 * Zarejestruj nowe konto użytkownika standardową metodą (Special:UserLogin).
 * Sprawdź identyfikator stworzonego konta użytkownika na stronie Special:Preferences.
 * Wykonaj następujące polecenie SQL na bazie danych wiki:

Jak zresetować hasło użytkownika?
W celu wyzerowania hasła użytkownika można skorzystać ze skryptu konserwacyjnego maintenance/changePassword.php</tt>.

Skrypt należy uruchomić w wierszu poleceń. Innymi słowy, należy zalogować się na serwer, na którym działa wiki, po czym otworzyć wiersz poleceń. Po przejściu do katalogu, gdzie zainstalowane jest oprogramowanie MediaWiki należy przejść do podkatalogu zawierającego skrypty konserwacyjne, gdzie wpisać należy polecenie:

php changePassword.php --user=użytkownik --password=hasło

gdzie użytkownik należy zamienić na nazwę użytkownika zawartą w tabeli &bdquo;user&rdquo;, zaś hasło na hasło, które chcemy ustawić.


 * Zobacz również: Manual:Resetting passwords/pl

Hasło użytkownika można również zmienić starym sposobem, dokonując zmian bezpośrednio w bazie danych. Zakładając, że wartość $wgPasswordSalt ustawiona jest na &bdquo;true&rdquo;, co jest wartością domyślną, można w przypadku bazy danych MySQL wydać polecenie:

gdzie użytkownik należy zamienić na nazwę użytkownika zawartą w tabeli &bdquo;user&rdquo;, zaś hasło na hasło, które chcemy ustawić.

user_id</tt> w ciągu CONCAT jest nazwą kolumny; nie wolno go zamieniać na nazwę użytkownika.

Jeśli pojawi się komunikat błędu &bdquo;dbname.user table does not exist&rdquo;, należy sprawdzić plik LocalSettings.php] w poszukiwaniu wartości nadanej zmiennej [[Manual:$wgDBprefix/pl|$wgDBprefix. Jeśli ta zmienna nie jest pusta, należy wydać polecenie ponownie, zamieniając user</tt> na $wgDBPrefix_user</tt> w klauzuli UPDATE</tt> SQL.

W przypadku korzystania z bazy danych PostgreSQL, kwerenda wygląda następująco:

Można również w tym celu wykorzystać rozszerzenie Password Reset.

Odpowiedź dla ekspertów w zarządzaniu bazami danych
Jeśli serwisem zewnętrznym, do którego mają prowadzić łącza interwiki jest Wikipedia, a pożądanym prefiksem dla łącz jest &bdquo;wp&rdquo; (prefiks &bdquo;wikipedia&rdquo; jest już domyślnym prefiksem interwiki dla Wikipedii, więcej wartości domyślnych znajduje się w dokumencie Help:Interwiki linking/pl) należy uruchomić następująca kwerendę SQL, modyfikującą tabele łącz interwiki:

Wartość $1 wskazuje nazwę artykułu w docelowej wiki.

Odpowiedź dla typowych użytkowników
W obsługiwanym w graficznym interfejsie użytkownika programie do zarządzania bazą danych, na przykład phpMyAdmin, przejdź do interwiki table/pl/tabeli interwiki. Wybierz opcję wstawienia rzędu. W polu iw_prefix wpisz pożądany prefiks dla linków interwiki. W polu iw_url wpisz podstawowy URL zewnętrznej wiki oraz &bdquo;$1&rdquo; jak w przykładzie powyżej. Domyślne wartości obydwu powyższych zmiennych to zero i tak je można zostawić.

Jeszcze więcej informacji, znaleźć można w dokumencie Help:Interwiki linking/pl.

Łatwa odpowiedź
Zainstaluj rozszerzenie Special:Interwiki. Interwiki można dodawać i usuwać wpisy interwiki za pośrednictwem strony specjalnej Special:Interwiki.

Jak skrócić adresy URL? (np. /wiki/Artykuł zamiast /w/index.php?title=Artykuł)
Patrz Manual:Short URL/pl.

Czy pobieranie i używanie treści serwisu MediaWiki.org jest darmowe?
Tak, obydwie te rzeczy są darmowe, wolne w sensie wolnego oprogramowania. Informacje na temat licencji, którymi objęte są treści serwisu MediaWiki.org zawarte są na stronie Project:Copyrights/pl.

Jak zarządzać uprawnieniami użytkowników?
<span id="How_do_I_administrate.2Fmanage_my_users.3F"> Zobacz dokumenty Manual:User rights/pl i Manual:User rights management/pl, gdzie znajdują się ogólne informacje na temat zarządzania uprawnieniami użytkowników. W dokumencie Manual:Preventing access/pl znajdują się metody i strategie ograniczania dostępu do wiki.

Jak uniemożliwić niezalogowanym użytkownikom modyfikowanie treści stron?

 * Pod koniec pliku LocalSettings.php ustaw wartość $wgGroupPermissions['*']['edit'] = false;

Zobacz również Manual:Preventing access/pl.

Jak uniemożliwić niezalogowanym użytkownikom przeglądanie treści stron?

 * Pod koniec pliku LocalSettings.php ustaw wartość $wgGroupPermissions['*']['read'] = false;.

Zobacz również Manual:$wgWhitelistRead/pl oraz Manual:Preventing access/pl.

Jak ograniczyć możliwość tworzenia kont?

 * Pod koniec pliku LocalSettings.php ustaw wartość $wgGroupPermissions['*']['createaccount'] = false;.

Zobacz też Manual:Preventing access/pl.

Jak do wersji do wydruku dodać grafikę?
Możliwe jest to za pomocą odpowiedniej skórki, Należy dodać grafikę z klasą specjalną do pliku &lt;mySkin&gt;.php, zaś klasę zdefiniować w arkuszu CSS jako niewyświetlaną na ekranie (display: none).

Jak przyspieszyć działanie oprogramowania MediaWiki?
Zobacz Manual:Performance tuning/pl.

Aktualizacja
Ogólne instrukcje dotyczące procesu uaktualniania oprogramowania MediaWIki znaleźć można w pliku UPGRADE</tt> stanowiącym część pakietu instalacyjnego. Zobacz również Manual:Upgrading/pl.

Jak trudna jest aktualizacja?
Jeśli jedynym zmodyfikowanym w uaktualnianej wiki plikiem jest LocalSettings.php</tt>, a uaktualnienie oprogramowania MediaWiki przebiega z wersji co najmniej 1.5, proces jest wyjątkowo prosty. Nakład pracy operatora włożony w aktualizację systemu wynosi wtedy kilka minut. Zmiany w strukturze bazy danych zajmują czas proporcjonalny do wielkości bazy – w przypadku dużych serwisów wiki z milionami stron może to zając godziny, lecz w przypadku typowych serwisów z kilkoma tysiącami stron, zajmuje to zwykle kilka sekund.

Drobne aktualizacje, przebiegające w ramach jednej wersji, na przykład z wydania 1.13.01 do 1.13.1, nie wymagają zmian w obrębie bazy danych; wtedy wystarczające jest zastąpienie starych plików nowymi.

Uaktualnianie wiki z wersji 1.4 i starszej jest o tyle niebezpieczne, że w nowszych wersjach zrezygnowano ze wsparcia dla kodowań znaków innych niż UTF-8, zmieniono też mechanizm przechowywania dużych ilości tekstu. Szczegóły znajdują się w odpowiedniej sekcji pliku UPGRADE</tt>.

Uaktualnienie systemu jest również trudne, jeśli dokonano zmian w kodzie źródłowym oprogramowania, a administrator systemu nie chce, by wprowadzone zmiany zostały nadpisane. Pożyteczne mogą się wtedy okazać narzędzia takie, jak diff i patch. Kłopoty mogą się również pojawić w przypadku instalacji zawierających nieaktualne rozszerzenia. Należy je zawsze uaktualniać wraz z aktualizacją oprogramowania MediaWiki.

Jak przeprowadzić aktualizację z naprawdę dawnej wersji MediaWiki? Czy lepiej jest to zrobić w jednym etapie, czy w kilku?
Takie aktualizacje najlepiej przeprowadzać jednoetapowo, z aktualnej do najnowszej stabilnej wersji. Większość raportów z aktualizacji, w tym zautomatyzowane testy, potwierdza skuteczność takiej metody.

Osoby nie wierzące w skuteczność jednoetapowej aktualizacji z dawnej wersji MediaWiki mogą zapoznać się z odpowiednim postem na liście dyskusyjnej.

Czy najpierw powinienem wykonać kopię zapasową?
Krótka odpowiedź: tak.

Długa odpowiedź: zależy od a) tego, jak cenne są dla Ciebie dane zawarte w wiki, b) tego, jak trudne jest sporządzenie kopii zapasowej i c) jak radzisz sobie z administrowaniem bazami danych MySQL.

Błąd w trakcie aktualizacji może pozostawić bazę danych w dwuznacznym stanie, stojącym pomiędzy dwoma wersjami. Może przenieść ważną tablicę do tymczasowej lokalizacji i zatrzymać się przed ponownym prawidłowym utworzeniem tabel. Może zmienić definicję typu pola, wprowadzając niedozwoloną wartość. Błąd podczas uaktualniania MediaWiki rzadko prowadzi do nieodwracalnej utraty danych. Częściej uszkodzone dane da się odzyskać przy wsparciu zdolnego administratora baz danych.

Odzyskiwanie danych często jest skomplikowane. Ochotnicy oferujący wsparcie na forach pomocy chłodno reagują na użytkowników zapominających o sporządzeniu kopii zapasowej i szukających pomocy w przywróceniu ładu w bazie danych uszkodzonej podczas aktualizacji oprogramowania. Lepszym rozwiązaniem jest możliwość powrotu do wcześniejszej wersji bazy danych i zaraportowanie błędu procesu aktualizacji, który spowodował uszkodzenie danych.

Czy mogę zachować plik LocalSettings.php?
Tak, lecz konieczne może się okazać wprowadzenie w nim kilku zmian. Format pliku LocalSettings.php</tt> jest z zasady kompatybilny wstecznie. Zmiany w pliku, które mogą spowodować niekompatybilność opisane są w sekcji "configuration changes" pliku zawierającego informacje o wydaniu.

Czy wiki w trakcie uaktualniania oprogramowania może być aktywna?
Tak.

Jeśli dokonuje się uaktualniania w obrębie jednej wersji silnika MediaWiki, wystarczy zaktualizować pliki oprogramowania.

Jeśli aktualizacja przebiega pomiędzy różnymi wersjami MediaWiki, sugerowana procedura jest następująca:


 * 1) rozpakuj nową wersję oprogramowania MediaWiki w nowym katalogu
 * 2) przygotuj nowy katalog; skopiuj do niego aktualnie wykorzystywany plik LocalSettings.php</tt> oraz wykorzystywane rozszerzenia i skórki
 * 3) plik LocalSettings.php</tt> w katalogu dotychczasowej instalacji MediaWiki zablokuj pozostawiając go tylko do odczytu:


 * 1) uruchom skrypt aktualizacyjny w nowym katalogu
 * 2) zamień stary i nowy katalog

Jak zmienić logo serwisu?
Pojawiające się w lewym górnym rogu każdej strony logo określone jest w linii $wgLogo pliku LocalSettings.php.

Zmienić logo można na dwa sposoby.

Można przesłać do serwisu wiki nową grafikę i skorzystać z jej adresu. Pozwala to na szybką zmianę grafiki, więc dobrym pomysłem może okazać się zabezpieczenie przesłanego pliku.

Wpis $wgLogo można wtedy dodać do pliku LocalSettings.php w sposób następujący:

$wgLogo = 'http://www.example.com/wiki/images/6/62/photoname.jpg';

Można też przesłać plik graficzny na serwer innym sposobem, na przykład korzystając z protokołu FTP. Linia $wgLogo w pliku LocalSettings.php wyglądać wtedy będzie następująco:

$wgLogo = "{$wgScriptPath}/photoname.jpg";

W powyższym przykładzie grafika znajduje się w tym samym katalogu, co plik $LocalSettings.php.

Nie wolno po prostu nadpisywać istniejącego domyślnego pliku logo ; plik zostanie ponownie nadpisany podczas aktualizacji oprogramowania MediaWiki.

Rada: Logo powinno mieć wielkość 135 x 135 pikseli.

Jak edytować pliki CSS wiki?
Nie powinno się bezpośrednio edytować dystrybuowanych z oprogramowaniem MediaWiki plików CSS, takich, jak main.css, gdyż spowoduje to utrudnienia w aktualizacji – konieczne będzie ponowne wprowadzanie osobiście zdefiniowanych opcji przy każdej aktualizacji. Chcąc wprowadzić zmiany dla każdej skórki należny edytować plik MediaWiki:Common.css lub na przykłąd plik MediaWiki:Monobook.css, jeśli zmiany chcemy ograniczyć do jednej skórki (tu: Monobook).

Zawartość stron MediaWiki:Common.css i MediaWiki:Monobook.css zawsze ma pierwszeństwo przed domyślnymi stylami zdefiniowanymi w pliku main.css.

Jak ukryć pionowy pasek narzędzi nawigacyjnych z lewej strony ekranu?
Innymi słowy – jak sprawić by zawartość znacznika &bdquo;div&rdquo; mieszczącego główną treść stron zajmowała 100% szerokości ekranu, ukrywając również logo serwisu, pasek narzędzi, pasek nawigacyjny i wyszukiwarkę?

Stałe ukrycie paska narzędziowego uzyskuje się wpisując następujące wartości do pliku MediaWiki:Common.css:

By ukryć pasek narzędzi po wciśnięciu przez użytkownika klawisza F11, należny wpisać następujący tekst do pliku MediaWiki:Common.js:

Czy mogę dostosować logo w górnym lewym rogu każdej strony? Jeśli jest to możliwe, to jak to zrobić?
Logo stanowi blokowy portlet bez zdefiniowanej sekcji pBody, opisany identyfikatorem p-logo. Grafika stanowiąca tło zdefiniowana jest w zmiennej $wgLogo w pliku DefaultSettings.php. Lokalizacja grafiki z logo jest względna w stosunku do głównego katalogu serwera WWW nie zaś względem głównego katalogu systemowego. Zmianę grafiki logo uzyskuje się modyfikując odpowiedni wpis w pliku LocalSettings.php. Jeśli wartość zostanie ustawiona nieprawidłowo, nie będzie wyświetlane żadne logo. Wartość należy skorygować po zapoznaniu się z dziennikiem błędów serwera WWW. Rozmiar obiektu p-logo musi być wystarczająco duży, jeśli grafika ma nie być przycięta. Odpowiednie wpisy znajdują się w arkuszu stylów – main.css dla skórki Monobook, opisując obiekt p-logo. Wartości domyślne to:

Jak wprowadzić inny link powiązany z logo w lewym górnym rogu ekranu?
Domyślnie, kliknięcie logo serwisu przenosi do jego strony głównej. Chcąc zmienić &bdquo;wewnętrznie&rdquo; stronę główną serwisu należy wprowadzić zmiany w pliku MediaWiki:Mainpage.

To make the link of the site-logo link externally to any other arbitrary URL, for Monobook skin, you'll need to edit the MonoBook.php file, which is normally located in the skins subdirectory. In other words, you need to do a core hack. This core-hack requires that you find and replace  with the URL of your choice. You can also replace  with the desired link title.

Example:

To link the site-logo to your desired URL: Replace with

To also change the alternative text displayed during mouse-rollover, over the site-logo you can replace: with

Note1: The original "alternative text code line" example above may not be found in the source code. The programming syntax at the end of this code line may have to be altered slightly from above, taking care to replace only identically syntaxed elements. Such care should enable a proper code rewrite.

Note 2: After making these changes to your MonoBook.php file, should you wish to test your version of MediaWiki to verify the effectiveness of your most recent file edit, you may have to fully re-initialize your version of MediaWiki before you can see the effects of your changes to the MonoBook.php file. To re-initialize MediaWiki, log out of MediaWiki, then log back into it. You should then be able to see the effect(s) of your recent edit(s) properly displayed by MediaWiki.

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 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 <tt>$wgFavicon = "$wgScriptPath/path/to/your/favicon.ico";</tt>

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 Monobook skin are determined by the MediaWiki:Sidebar page there on your wiki. For information on customising these, please see Manual:Navigation bar.

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.

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 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 bug 6129), but you can use CSS to hide the title. Alternately, you can use the NoTitle extension.

Method 1 (display title)
Add to following line to any page you want to get rid of the title:

Method 2 (css)
Add the following to the MediaWiki:Monobook.css (if you're using Monobook; otherwise add this to MediaWiki:Common.css to have it applied to all skins) on your wiki:

If this doesn't work, look at the HTML source code to find the correct class to replace "page-Main_Page" with:

If no unique class exists, then you cannot use this. You may be using a custom or outdated 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 <tt> </tt> into the page markup.


 * For all pages
 * Add the following rule to MediaWiki:Common.css:

A simpler and more efficient alternative is to edit the file /includes/parser/Parser.php, altering the line in the formatHeadings function the limit of 4 headings:  to a higher value (e.g. 100). This way the table of contents will only be displayed in pages with 100 or more headings, OR in pages which contain one of the magic words <tt> </tt> or <tt>  </tt>.
 * Per user
 * Users can also opt to have the table of contents hidden. This is a user preference, set in Special:Preferences.

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 Manual:System message.


 * 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 minus sign.

How do I change the interface language?
To change the default interface language, alter the value of <tt>$wgLanguageCode</tt> in <tt>LocalSettings.php</tt>, for example $wgLanguageCode = "fr";

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

Changing the default interface language 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 can I prevent editing by anonymous users?
The recommended method is by changing the value of the  configuration option. Edit  and add the line:

For more information on using this option, see the Preventing access page and Manual:User rights.

How do I remove the article/edit etc tabs?
Edit MediaWiki:Monobook.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 (the default skin), and doesn't actually stop people editing. To get the same effect in other skins, use the corresponding css page for the skin in Mediawiki namespace.

How do I add/remove tabs throughout my wiki?
Use Extension:DynamicTabs or write your own extension:

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?
''This solution works in MediaWiki version 1.9 and above. In MediaWiki version 1.8 or below, first apply the above patch.''

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

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

See also: Manual:Hide page tabs

How do I remove a tab on all pages
''This solution works in MediaWiki version 1.9 and above. In MediaWiki version 1.8 or below, first apply the above patch.''

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

Other tabs to remove are #ca-history and #ca-viewsource. To modify MediaWiki:Monobook.css you must have administrative privileges.

How do I hide the section edit links for users who are not logged in?
Edit  and add the line:
 * 1) The recommended method is by changing the value of the  configuration option.


 * 1) Alternatively you could manually edit each skin (e.g. ) and add this before  :


 * Replace #ca-edit with #ca-viewsource if you disabled editing for anonymous users. Use .editsection for older MW versions.
 * If you want to hide the links for all users including logged in users, instead edit the page  and add:


 * Also see How can I prevent editing by anonymous users?

How do I remove the "Talk for this IP" link at the top right when $wgDisableAnonTalk is true?
Set $wgShowIPinHeader to false.

How do I remove the "Create an Account or Login" link at the top right of the screen?
In Monobook.php change this statement: to:

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, its 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 change the footer?

 * See: Manual:Footer, Manual:Skinning, Manual:Configuration settings

How can I edit / remove the Powered by MediaWiki image in the footer?
You can hide the Powered by MediaWiki image by adding the following to your wiki's MediaWiki:Common.css:

The Vector skin equivalent is:

If you want to remove it completely, you could alter <tt>/skins/MonoBook.php</tt>, which contains the following code that makes the Powered by MediaWiki image appear in the footer: If you would like to remove this image completely, or edit the image, you must locate and edit poweredbyico. It is located in <tt>skins/common/images/</tt> and the image is called <tt>poweredby_mediawiki_88x31.png</tt>.

If you're happy with the logo (or not) and simply want to change the destination link, the code is in getPoweredBy function of includes\Skin.php. Just change the line  $img = '<a href="http://www.mediawiki.org/"><img src="'.$url.'" alt="Powered by MediaWiki" /></a>';  to whatever.

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 <tt>languages/LanguageHe.php</tt> in your wiki directory.

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

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

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?
For adding more toolbar buttons above the edit field, you can use JavaScript code to register them in <tt>mwCustomEditButtons</tt> in your MediaWiki:Common.js. For example, a button for large text:

The following page is a more complex example which can work from an empty wiki: w:MediaWiki:Common.js/edit.js.

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 Wikipedia's new skin (Vector) on my wiki?
Vector is not available in MediaWiki versions prior to 1.16, and will be made default skin in 1.17. See here for information on configuring your default skin.

How do I edit a page?
To edit a page, simply click the edit link that appears on each page. Using the default MonoBook skin, this is in the form of a tab at the top of the page. A form will appear, containing the existing markup. When you have finished making modifications, click the Save button to commit your changes.

See also:

How do I create a new page?
There are several ways to create a new page:

On some wikis, a failed search for a page will contain a link which allows you to edit that page.
 * Create a link to the page on another page, then click on the red link which appears
 * Browse to the intended location of the page, e.g. http://www.example.com/index.php?title=New_page and click on the edit link.

See Help:Starting a new page

How do I delete an old version of a page?
Old versions of page data are retained in the database and can be accessed via the page history features. This is useful for reviewing changes and correcting or reverting undesirable ones, but in some cases, administrators might want to make this information unavailable, for legal reasons, or to reduce the size of the database.


 * Administrators can delete an old revision of a page by deleting the page, and then selectively undeleting revisions to be kept
 * The Oversight extension (also known as HideRevision) can be used to move harmful revisions out of page histories
 * For newer MediaWikis (1.14+), you can enable the core RevisionDelete feature that allows privileged users to remove single revisions from page histories
 * The <tt>maintenance/deleteOldRevisions.php</tt> maintenance script can mass-delete all old revisions of pages and their associated text records.
 * See also: Manual:Removing embarrassment.

Are there any editing tutorials available?
There are several editing tutorials available, mostly on Wikimedia sister projects, such as Wikipedia. There are also markup references, etc. available on Meta.


 * Editing help content on Meta
 * The How to edit a page guide on the English Wikipedia

How do I view the printable form of a page?
MediaWiki includes stylesheets which automatically style a page appropriately when it is printed; using the print or print preview function within your browser ought to render the page in a printable form.

You can also view this printable form using the printable version link in the toolbox.

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
Here are some info on importing from other types of files:


 * Massive text files importing
 * Massive image files uploading
 * Tools to converter from html to MediaWiki, and this.
 * Tools to converter from Microsoft .chm help files to MediaWiki
 * Converting tools from Microsoft Office files 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
<tt> 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 </tt>

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 its more difficult to configure and its 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.

This can be easily abused to attack users

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

How can I allow uploading of HTML files?
See Manual:Allowing HTML Uploads.

This can be easily abused to attack users

…is the Help namespace empty?
We don't currently have a clean, internationalised set of help pages under a free license. A few developers are hoping to make this possible; however, the Help namespace currently ships in a blank state. You are free to add your own help pages, copy the Public Domain help pages or copy certain of the items from Meta, e.g. the user guide or MediaWiki Handbook, these two collections being free to use under the GNU Free Documentation License.

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

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

…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'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's default stopword list.

…can't I download MediaWiki ?
MediaWiki is in a development state at present, and has not been packaged into a general release. The code can be downloaded from Subversion if desired. Or, if you want the latest revision packaged as an archive, get it from MediaWiki Nightly Dumps on Toolserver.

…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 wmf/1.16wmf4 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 SVN
 * 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.

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

Where do I get the spam blacklist from and how do I install it?
The spam blacklist extension can be found in Subversion, 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:

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

Is 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 MediaZilla, our implementation of Bugzilla. Please search the database prior to posting, to avoid creating duplicate entries.

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 knowledgabe users.

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 (perhaps search the archive first).
 * Ask the developers in our IRC channel (Freenode network, channel #mediawiki).

Recommended reading

 * Asking smart questions
 * Effective bug reporting
 * Getting help on IRC
 * Mizanur Rahman, MediaWiki Administrators' Tutorial Guide, ISBN 1904811590
 * Daniel J. Barrett, MediaWiki, ISBN 9780596519797