Användare:Strangnet/MediaWiki

Efter att ha tragglat runt lite med att få en installation av MediaWiki att fungera på en Windows XP-dator, så kommer här en liten genomgång för hur man enklast får det att fungera.

Installation av servertjänster

Det finns några varianter för hur man kör en lokal webbserver i Windows XP. Dels kan man, om man använder XP Professional, installera Microsofts egen webbserver, IIS. Det är förstås praktiskt om man också vill kunna köra asp och ASP.NET för att nämna några exempel. Till det måste man installera databas och andra funktioner som MediaWiki kräver. Därför är min rekommendation att satsa på ett paket som erbjuder allt-i-ett: Apache Friends XAMPP är ett sådant.

Ladda ner Basic package som inkluderar allt och lite till.
Installera och följ anvisningarna, de standardval som gjorts rekommenderas om du inte har särskilda behov.
När installationen är klar har du en fungerande Apache webbserver och MySQL databasserver.

Databas

När installationen är klar så bör du ha xampp istallerat under c:\xampp och en lokal webbserver som du når med webbläsaren på http://localhost. Nu behöver du skapa en databas att lagra wikins artiklar i. Öppna adressen http://localhost/phpmyadmin och klicka på Privileges. Skapa en ny användare, kalla den exempelvis mediawiki och ange local i alternativet för host. Skriv in ett lösenord och upprepa det en gång.

Välj sedan alternativet att skapa en databas med samma namn som användaren och grant all privileges, vilket ger den användaren full tillgång till den databas vi kommer att använda. Klicka inte i några alternativ under global privileges och klicka på Go-knappen nederst till höger. Nu kan MediaWiki installeras.

MediaWiki

För att köra MediaWiki behövs inget mer än en installation av programvaran. Nu vill man ju förstås ha lite mer bells-and-whistles än så och kunna ladda upp bilder och till och med några enstaka SVG då och då. För bildhanteringen så är ImageMagick ett bra tillägg som dessutom fungerar smidigt tillsammans med Apache och MediaWiki. Dock är dess stöd för SVG något bristfälligt, så där kommer Inkscape in i bilden. Förutom att vara ett utmärkt open source-alternativ till dyra Adobe Illustrator, så kan den enkelt integreras med MediaWiki för att hantera SVG och göra små tumnagelbilder av dem, som du säkert stött på i någon av de färglada mallarna som används flitigt på Wikipedia eller i länders och landskaps vapen.

Börja med att ladda ned MediaWiki, ImageMagick (välj den som har Q16-windows-dll i namnet) och Inkscape.
MediaWiki packas upp med exempelvis 7-Zip. Packa upp filen i katalogen där de dokument som webbservern har tillgång till ligger, vilket bör vara c:\xampp\htdocs. Börja med att byta namn på mediawiki-katalogen till wiki.
När nu det är gjort, så surfar du till din wiki-installation på http://localhost/wiki och får uppmaningen att konfigurera och installera MediaWiki. Fyll i de uppgifter du använde tidigare då databasen och dess användare skapades. Se även MediaWikis installationsmanual. Kopiera filen LocalSettings.php som skapats i config-katalogen och lägg den i installationskatalogen, dvs c:\xampp\htdocs\wiki\, ett steg upp i katalogstrukturen. Ta sedan bort config-katalogen helt.

Nu ska du hamna i din helt egen wiki om du går till http://localhost/wiki.

När nu själva installationen av MediaWiki fungerar, så kan vi fortsätta med att installera ImageMagick och Inkscape. Följ instruktionerna så ska det inte vara några problem. Om inget oförutsett skett så bör de vara installerade i c:\Program Files\ImageMagick-6.3.8-Q16 respektive c:\Program Files\Inkscape - lägg dem på minnet.

ImageMagick och Inkscape

För att MediaWiki ska förstå att du vill använda dig av de två externa programmen för bildhantering, så måste några inställningar i filen LocalSettings.php göras. Öppna filen med valfri texteditor, Notepad++ rekommenderas till förmån för Windows inbyggda Notepad.

Leta upp raden som innehåller $wgEnableUpload och se till så att den är true.
På raderna under kan vi nu fylla i de inställningar som gör att ImageMagick och Inkscape fungerar:

$wgEnableUploads = true;
$wgUseImageMagick = true;
$wgSVGConverter = 'Inkscape';
$wgSVGConverters = array(
  'ImageMagick' => '"C:/Program Files/ImageMagick-6.3.8-Q16/convert" -background none -geometry $width $input $output',
  'Inkscape' => '"C:/Program Files/Inkscape/inkscape" -z -w $width -f $input -e $output'
);
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'ogg', 'zip', 'svg');

Se till så att sökvägarna till ImageMagick och Inkscape stämmer med verkligheten. Den sista raden med $wgFileExtensions kanske redan finns i LocalSettings.php - applicera då de ändringarna jag föreslår där, eller flytta raden som jag har gjort.

Snyggare wikiadresser

Som standard ser adresserna till artiklar och sidor i MediaWiki lite krångliga ut, vilket vi kan råda bot på omedelbart, nu när vi ändå är i LocalSettings.php och ändrar. Vi ska nämligen se till att /wiki/index.php/Huvudsida ändras till /wiki/Huvudsida. För att göra det ska vi byta namn på katalogen som MediaWiki installerats i, men först:

Leta upp raden med $wgScript och sätt den till "/w". Nedanstående är de inställningar jag använder:

$wgScriptPath = "/w";
$wgScript = "$wgScriptPath/index.php";
$wgArticlePath = "/wiki/$1";
$wgStylePath = "$wgScriptPath/skins";
$wgLogo = "$wgStylePath/monobook/wiki.png";

Spara filen och stäng. Byt nu namn på katalogen wiki till w.

Därefter ska du ändra i webbserverns inställningsfil för att få webbservern att automatiskt hantera anrop till wiki som ett anrop till w. Det görs med hjälp av ett alias.

Öppna filen httpd.conf som finns i c:\xampp\apache\conf\.
Gå till rad 308 eller däromkring, den som innehåller ett Alias-exempel, och skriv Alias /wiki c:/xampp/htdocs/w/index.php på en ny rad utan brädgård (#) framför.
Spara filen och starta om apacheservern med hjälp av XAMPP Control Panel, som du hittar i startmenyn.

Nu borde allting fungera smärtfritt och du skall kunna börja redigera och ladda upp bilder i din wiki.

Utökningar

För att få miljön på din egen wiki att likna den här på Wikipedia så behövs ytterligare lite handpåläggning. Exempelvis finns det en del tillägg (extensions) som du hittar mer information om under Special:Version. De är inte så krångliga att installera och med den vana du har fått att ändra i LocalSettings.php, så borde det vara en baggis.

Lycka till...