Wiki veranderingen

[qurben]

De wiki kwestie. Er zijn een aantal dingen die een keer overwogen moeten worden en een aantal dingen die gedaan moeten worden.

Moet gedaan worden

• Coupling tussen csrdelft/wiki en csrdelft/csrdelft.nl moet één richting op zijn, namelijk wiki -> stek. De repo csrdelft/csrdelft.nl moet niet afweten van wiki, behalve dat de submodule erin zit. #3
• Er moet een overzicht gemaakt worden met alle veranderingen die wij zelf aan de wiki gemaakt hebben. Er zijn een aantal bestanden in de wiki (authcsr, bieblink, profiellink) die custom zijn en bij een update gecontroleerd moeten worden.

Dingen die overwogen moeten worden

• Switchen naar mediawiki of een andere wiki.

[qurben]

Overstappen naar een andere wiki is waarschijnlijk geen optie. Er is echt een gigantische wiki geschiedenis en er zijn allerlei custom plugins geinstalleerd. Veel van deze plugins zijn outdated, maar zijn ook weer snel gefixt. Deze plugins zijn de enige dingen die stuk gaan bij een switch naar php7. Zie ook #299

[qurben]

Mediawiki heeft pas een aantal hele mooie updates gehad. Er is nu een hele chille editor. Met een makeover van de wiki kunnen we ook weer wat meer aandacht voor de wiki creeren.

Ik ga binnenkort even kijken wat de mogelijkheden zijn qua overzetten.

[Klap-in]

Als je vragen hebt met betrekking tot DokuWiki kan ik allicht wel helpen. Ik ben namelijk nog steeds bij de ontwikkeling van DokuWiki betrokken.

[qurben]

Voor een eventuele overstap naar Mediawiki is (in ieder geval) het volgende nodig:

• Installatie van Mediawiki ergens neerzetten
• Authenticatie fixen, (als het lukt me oauth)
  • https://www.mediawiki.org/wiki/Extension:WSOAuth
• Pagina's van dokuwiki naar mediawiki formaat converteren
  • http://www.staerk.de/thorsten/Mediasyntax
• Pagina's inladen
• Media overzetten
• Pagina's met beperkte rechten ergens anders neerzetten
• 'Database' pagina's (vormingsbank, motiedatabeest, ...) overzetten.
  • Kijken hoe dit werkt, of hier een mooie manier voor is in Mediawiki
• Image maps overzetten
  • https://www.mediawiki.org/wiki/Extension:ImageMap

En mogelijk nog meer.

[Klap-in]

Ik ben nieuwsgierig, wat is eigenlijk de reden dat je naar een andere wiki kijkt in plaats van DokuWiki?

[qurben]

Goede vraag. Grotendeels is het nog een idee waar mee gespeeld wordt om te kijken wat de mogelijkheden zijn.

Het idee is ontstaan omdat er op dit moment wat issues zijn met de wiki.

• De integratie met de stek is op sommige plekken redelijk 'tight', waardoor er onverhoops dingen in de wiki stuk gaan als de stek veranderd. De stek ondersteund sinds een paar maanden OAuth en hiermee kunnen we een 'lossere' integratie bouwen.
• Opslaan van pagina's in een sql database is mijns inziens een groot pluspunt, omdat in de andere systeem die we hebben draaien ook al alle 'veranderende' data in een sql database staat. Dokuwiki kan dit helaas niet.
• Er is het idee dat leden mediawiki makkelijker zouden kunnen gebruiken omdat ze al bekend zijn met Wikipedia. (en er zijn af en toe leden met uitgebreide Wikipedia kennis, die dat voor de wiki zouden kunnen hergebruiken)
• Op sommige plekken voelt dokuwiki een beetje ouderwets aan.
• Ik heb het idee dat we de features alleen in dokuwiki, zoals acl en namespacing, niet echt gebruiken of dat ze de boel alleen maar minder overzichtelijk maken.
• De wiki wordt soms gezien als een beetje chaotisch en niemand heeft een goed idee hoe dit wel zou moeten werken.
• wiki syntax word als een drempel gezien.

Het eerste en laatste punt is sowieso ook te fixen in de huidige dokuwiki installatie. Het eerste punt is de grootste reden dat er gekeken wordt naar een eventuele overstap. De andere punten zijn wat vager en daardoor ook lastiger, het zou ook goed kunnen dat een overstap naar bijv. mediawiki deze problemen ook niet oplost.

Voordat een overstap naar iets anders besloten kan worden moet er eerst even gekeken worden of het überhaupt haalbaar is. Er is een grote kans dat een overstap naar mediawiki te ingewikkeld blijkt en geschrapt wordt.

[nk22]

Een wilde am. Kramer jr. is verschenen op de GitHub. Als iemand die nu meer dan 10 jaar aan affiniteit heeft met het gebruik van MediaWiki kan ik met enige zekerheid zeggen dat MediaWiki een stuk fijner is om mee te werken dan DokuWiki. Een paar aanknopingspunten:

• De MediaWiki-syntax is een stuk logischer dan de achenebbisj aanpak van DW, voor nieuwe gebruikers is MediaWiki dan ook een stuk makkelijker om te leren dan DW, wat affiniteit met onze wiki onder leden aanzienlijk kan vergroten
• Daarover, met de nieuwe visuele editor van MediaWiki is syntax kennen niet eens meer nodig, iets wat de drempel door de grond doet laten zakken.
• Infoboxes (zoals deze op Wikipedia) zijn op dit moment niet echt mogelijk in DokuWiki, wat overzichtelijke pagina's voor bijvoorbeeld besturen en commissies nagenoeg onmogelijk maakt.
• Categorisering maakt wiki's een stuk overzichtelijker en bevorderd onderlinge verbinding tussen verschillende pagina's
• Overzetten DokuWiki naar MediaWiki levert bij de plugins weinig moeilijkheden op, huidige functionaliteit C.S.R.-wiki kan nagenoeg volledig intact blijven
• MediaWiki ondersteunt onder andere SQLite en MySQL databases, volgens mij werkt de huidige C.S.R.-wiki nu met die laatste, dus daar is weinig qua problemen

Een aantal nadelen die nog aangestipt moeten worden:

• MediaWiki werkt vooral goed met informatieve pagina's, iets minder voor overzichten zoals die nu soms op de wiki te vinden zijn
• De overdracht van DokuWiki naar MediaWiki kan enige problemen opleveren, denk daarbij aan geautomatiseerde pagina's als het motie-overzicht en de vormingsbank. Dit zou wel opgelost kunnen worden, maar een complete analogie in MediaWiki weet ik voor die pagina's niet zo-even, misschien met navboxes?

Het is moeilijk om echt goede voorbeelden te vinden van andere toegankelijke interne wiki's met MediaWiki, omdat ze, nou ja, intern zijn. Maar al met al is mijn advies dus positief!

[qurben]

De huidige wiki gebruikt platte tekst als opslag, maar er draait al een MySQL database. Die kan gebruikt worden.

---

De geautomatiseerde pagina's kunnen evt worden opgevangen door een van de data extensies van mediawiki.

• Cargo
  • Met Page Forms
• WikiDB

[qurben]

Ik ben al een beetje aan het spelen gegaan: https://github.com/csrdelft/mediawiki-scripts

Er zijn nog wel een boel dingen die gefixt moeten worden.

[nk22]

Ik gooi hier maar even mijn opmerking, is wat handiger dan de stek. Hulde voor de nieuwe Mediawiki-wiki, gaat de goeie kant op. Het grootste probleem wat er nu nog ligt bestaat nog steeds uit de verschillende templates, wat een beetje monnikenwerk kan zijn. Maar bijvoorbeeld iets als infoboxes vereisen nog een hoop extensies als TemplateStyles en volgens mij ook WikiBase.

Ik zal binnenkort eens kijken wat ik nog kan doen hierbij.