Oppsett av en wiki

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:

http://www.mediawiki.org/wiki/Download_from_Git

Her har du en kort oppskrift..

cd /var/www/html
git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git --depth=1
mv core wiki.mittnettsted.no     # PS! Viktig at denne katalogen er den samme som i .conf-filen ovenfor!
cd wiki.mittnettsted.no
git submodule update --init
chown -R apache: images
yum -y install composer
composer update --no-dev
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...

cd var/www/html/mittnettsted
git pull     # oppdatering av selve mediawiki
compose update --no-dev     # oppdatering av vendor-mappen
cd extenions/xxx     # du må inn i alle disse mappene og kjøre git pull der for å oppdatere dem
git pull
cd ../..
cd skins/Vector     # oppdatering av skin
git pull
cd ../..
php maintenance/update.php     # til slutt oppdateres selve databasen

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 config.example.yaml config.yaml

I config.yaml må du endre...

uri: 'http://yoursite.com/w/api.php'
domain: 'yousite.com'

...til...

uri: 'http://www.mittnettsted.no/api.php'
domain: 'mittnettsted'

Så må du starte Parsoid:

cd /root/parsoid
node bin/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 i mediawiki-katalogen

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
$wgVirtualRestConfig['modules']['parsoid'] = array(
    // URL to the Parsoid instance
    // Use port 8142 if you use the Debian package
    'url' => 'http://www.mittnettsted.no:8000',
    // Parsoid "domain", see below (optional)
    'domain' => 'mittnettsted'
);

Støtte for Google Login

https://www.mediawiki.org/wiki/Extension:GoogleLogin

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

http://www.mediawiki.org/wiki/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 ;-)