Oppsett av en wiki

Fra GNUskole
Hopp til: navigasjon, søk

Mediawiki er utrolig nyttig!

Installering av Mediawiki

Klargjøring av webtjeneren

cd /etc/httpd/conf.d
nano wiki-mittnettsted-no.conf

Det er det samme hva du kaller filen, så lenge den har .conf til slutt. Gi den et navn du kjenner igjen :-)

Legg inn denne informasjonen i filen:

<VirtualHost *:80>
        ServerAdmin meg@minepost.no
        DocumentRoot /var/www/html/wiki.mittnettsted.no
        Servername wiki.mittnettsted.no
        Errorlog logs/wiki.mittnettsted.no-error_log
        CustomLog logs/wiki.mittnettsted.no-access_log common
# Det følgende er nødvendig om du ønsker å bruke "short URL" i mediawiki.
# Mer om dette seinere i innstallasjonsveiledningen.
#        RewriteEngine On
#        RewriteRule ^/?wiki(/.*)?$ %{DOCUMENT_ROOT}/index.php [L]
#
#        RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f
#        RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d
#        RewriteRule ^/?images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/thumb.php?f=$1&width=$2 [L,QSA,B]
#
#        RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f
#        RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d
#        RewriteRule ^/?images/thumb/archive/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/([0-9]+)px-.*$ %{DOCUMENT_ROOT}/thumb.php?f=$1&width=$2&archived=1 [L,QSA,B]
</VirtualHost>

...og lagre filen.

Kjør kommandoen service httpd restart for å få registrert endringene.

Installasjon av mediawiki via git

Instruktive lenker fra Mediawiki:

Her har du en kort oppskrift..

cd /var/www/html
git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git
mv core wiki.mittnettsted.no     # PS! Viktig at denne katalogen er den samme som i .conf-filen ovenfor!
cd wiki.mittnettsted.no
chown -R apache: images
git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git
cd skins
git clone https://gerrit.wikimedia.org/r/p/mediawiki/skins/Vector.git

Pek nettleseren din til http://wiki.mittnettsted.no og følg instruksjonene.

Oppdatere mediawiki via git

Du kan lett oppdatere Mediawiki ved å stå i /var/www/html/wiki.mittnettsted.no og skrive git pull. Men du må huske å gjøre både i hoved-, vendor- og skins-katalogene.

Etter en oppdatering må du alltid kjøre:

cd maintenance
php update.php

...for å oppdatere databasen i wikien din!

VisualEditor

VisualEditor er en WYSIWYG-editor som gjør det enklere for alle å legge inn tekst i Mediawiki. Du slipper å tenke på alle kodene som må skrives o.l. Dette har de gjort i håpet om at flere vil skrive i Wikipedia, men vi kan også dra nytte av det i lokale wikier. Det er enklere å skrive i VisualEditor enn i den vanlige editoren i Mediawiki.

Lenker til viktige sider:

Det er litt tungvint å sette opp Parsoid og VisualEditor - men det er verdt det!

# Installere Parsoid (som er det vanskelige!)
yum install nodejs npm
cd /root/
git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid
cd parsoid
npm install
cd api
cp localsettings.js.example localsettings.js

I localsettings.js må du endre...

parsoidConfig.setMwApi({ uri: 'http://yoursite.com/w/api.php', domain: 'yoursite.com', prefix: 'someuniqueid' });

...til...

parsoidConfig.setMwApi({ uri: 'http://wiki.mittnettsted/api.php', domain: 'wiki.mittnettsted.no' });

Så må du starte Parsoid:

cd /root/parsoid/js
node api/server.js

Dette starter Parsoid på port 8000 i terminalvinduet (og stopper hvis du lukker det!). Du kan teste om den virker ved å surfe til http://localhost:8000

Om du vil starte Parsoid i bakgrunnen kan du gjøre det slik:

cd /root/parsoid
nohup node api/server.js &

Da må du lete frem prosessen ( ps -ef |grep node) og drepe prosessen med kill-kommandoen.

Du er god som henger med enda!

# Installere VisualEditor
cd /var/www/html/wiki.mittnettsted.no/extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/VisualEditor.git
cd VisualEditor
git submodule update --init

Legg til dette i Localsettings.conf

require_once("$IP/extensions/VisualEditor/VisualEditor.php");
// OPTIONAL: Enable VisualEditor in other namespaces
// By default, VE is only enabled in NS_MAIN
//$wgVisualEditorNamespaces[] = NS_PROJECT;
// Enable by default for everybody
$wgDefaultUserOptions['visualeditor-enable'] = 1;
// Don't allow users to disable it
$wgHiddenPrefs[] = 'visualeditor-enable';
// OPTIONAL: Enable VisualEditor's experimental code features
//$wgVisualEditorEnableExperimentalCode = true;
// URL to the Parsoid instance
// MUST NOT end in a slash due to Parsoid bug
$wgVisualEditorParsoidURL = 'http://wiki.mittnettsted.no:8000';

Education Program

Viktige lenker:

Installasjon av CLDR

cd extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/cldr.git
Legg til denne linjen nederst i Localsettings.php
require_once(c "$IP/extensions/cldr/cldr.php" );
Installasjon av Education Program
cd extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/EducationProgram.git
cd /var/www/html/wiki.mittnettsted.no/maintenance
php update.php

Legg til denne linjen nederst i Localsettings.php

require_once( "$IP/extensions/EducationProgram/EducationProgram.php" );

Støtte for Google Login

cd extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/GoogleLogin.git
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/GoogleAPIClient.git

Følg instruksjoner på nettsiden til utvidelsen Google Login. Du må gjøre litt forskjellig med API-innstillinger i Google, så dette er ikke helt for nybegynnere ;-)

Støtte for LDAP

cd extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/LdapAuthentication.git

Mer kommer, men dette burde nesten holde for de som virkerlig vil dette ;-)