MediaWiki

We do have 2,5 Mediawiki installations:

The TDFWIKI is a full-featured installation and has many extensions installed.

The HELPWIKI is a “half”-featured installation, has many sym-links to the TDFWIKI, and only a few extensions.

Help-API is “only a config file” so that the usage of the API is allowed. Every other file is a sym-link to HELPWIKI.

Installation

Following prerequisites we do need
  • Ploticus (for Extension:EasyTimeline)
  • perl (for at least Extension:EasyTimeline)
  • texvc (for Extension:math)
  • more for Extension:math
  • graphviz (for Extension:Graphviz)
  • Exim4 or PostFix (for Extension:BounceHandler)

Installed Extensions

We do have the following extensions installed at the moment:

TDFWIKI

  • BounceHandler (installed, but not working atm)
  • CategoryTree (see at the bottom the cas - used)
  • CheckUser (used by dennis for identifying spammers (e.g. by same UserAgents))
  • Interwiki (candidate for being deinstalled again)
  • Add_HTML_Meta_and_Title (need for [[Design]] for google verification)
  • Cite (to be removed for 1.25, maybe instal then CiteThisPage)
  • EasyTimeline (used at e.g. [[Template:LibOReleaseLifecycle]])
  • Graphviz (used at e.g. [[Development/Build System]])
  • ImageMap (prerequisit for Graphiz)
  • MapSources (used for event and hackfest pages to integrate a OSM)
  • Math (used at e.g. [[Documentation/Color and Tone Adjustment]])
  • ParserFunctions (additional code stuff for extensions)
  • RSS (e.g. [[EasyHacks]] bugs listed inwiki)
  • SyntaxHighlight (very much used for development pages)
  • Widgets (Calendar in wiki, e.g. tdfwiki/EventsCalendar)
  • AbuseFilter (prevent spammer, most config onwiki, see [[Special:AbuseFilter]])
  • AntiBot (anti bot framework - is it used?)
  • AntiSpoof (prevent account creation with mixed-scripts)
  • ConfirmEdit (recaptcha extension for registation and first edits)
  • SpamBlacklist (prevent spammers, see [[MediaWiki:Spam-blacklist]])
  • TitleBlacklist (prevent spamers, see [[MediaWiki:Titleblacklist]])
  • CodeMirror (syntaxhighlight in text field)
  • Bugzilla (used at [[EasyHacks]], at the moment fork by colonelqubit)
  • Gadgets (needed for G+ Calendar)
  • LanguageSelector (see helpwiki)
  • OpenSearchXml (to be removed for 1.25)
  • PCR GUI Inserts (piwiki integration)
  • WikiEditor

HELPWIKI

  • PCR GUI Inserts (piwik integration)
  • ParserFunctions (using for templates in functions)
  • SyntaxHighlight (in use for OOBAS macros, e.g. [[Basic/Reset_Statement_Runtime]])
  • LanguageSelector (switch languages from en to de, etc. depending on users browser language)
  • WikiEditor (good q - in use?)
  • WikihelpRedirect (Kendy’s extension for redirecting to the correct version page)

Accessing Help-API

To access help-api.libreoffice.org simply add to your /etc/host

Adding new extensions

New extensions should be git cloned to /var/www/sites/wiki.documentfoundation.org/extensions/ (or if no git repository is available, then unpack it there and document it here)

The extension needs to be included in the ./core/LocalSettings.php by using require_once “$IP”/extensions/Name/Name.php”;

Extensions which do need to load additional files (e.g. images for toolbars) have to be symlinked to /var/www/sites/wiki.documentfoundation.org/core/extensions/ - be careful there exists extensions which canot be symlinked (e.g. Bugzilla integration)

Upgrading

  • add to /var/www/sites/wiki.documentfoundation.org/core/LocalSettings.php and /var/www/sites/help.libreoffice.org/core/LocalSettings.php:

    $wgReadOnly = 'This wiki is currently being upgraded to a newer software version.';

  • Update the core repository to the wanted tag:

    cd /var/www/sites/wiki.documentfoundation.org/core
sudo su -s/bin/bash www-data
git pull
git checkout REL1_24
git submodule update --init

  • Update the internal extensions repository to the wanted tag:

    cd extensions
git pull
git checkout REL1_24
git submodule update --init

  • Update the external extensions repository to the wanted tag:

    cd ../../extensions
git pull
git checkout REL1_24
git submodule update --init

  • Update the skins to the wanted tag:

    cd /var/www/sites/wiki.documentfoundation.org/skins/Vector/
git pull
git checkout REL1_24

  • adapt the file /var/www/sites/wiki.documentfoundation.org/extensions/Widgets/WidgetRenderer.php:

    sed -i s/"\$IP\/extensions"/"\$IP2\/extensions"/g /var/www/sites/wiki.documentfoundation.org/extensions/Widgets/WidgetRenderer.php
sed -i s/"global \$IP;"/"global \$IP2;"/g /var/www/sites/wiki.documentfoundation.org/extensions/Widgets/WidgetRenderer.php

  • udpate the Math extension:

    cd /var/www/sites/wiki.documentfoundation.org/core/extensions/Math/math
make

  • Enable AntiBot:

    cp -R /var/www/sites/wiki.documentfoundation.org/extensions/AntiBot/available/ /var/www/sites/wiki.documentfoundation.org/extensions/AntiBot/active/

  • Fix permissions:

    chown -R www-data: /var/www/sites/wiki.documentfoundation.org

  • Run maintenance script:

    cd core
php maintenance/update.php --nopurge --quick


cd /var/www/sites/wiki.documentfoundation.org/core
php maintenance/update.php --nopurge --quick --conf /var/www/sites/help.libreoffice.org/core/LocalSettings.php

  • Comment out $wgReadOnly from /var/www/sites/wiki.documentfoundation.org/core/LocalSettings.php and /var/www/sites/help.libreoffice.org/core/LocalSettings.php

Skins

Since Mediawiki 1.24 no standard skins are any longer distributed by the Wikimedia Foundation.

We have only one skin installed at the moment: skin “Vector” (also standard skin at Wikipedia). It is installed at

  • /var/www/sites/wiki.documentfoundation.org/skins/

and respectively symlinked for help and help-api

Extension

Additional speciality notes about extensions can be found here:

  • Syntaxhighligh_GeShi has to be on branch REL1_23 instead of REL1_24 as REL1_24 throughs errors (at least at Special:Version)
  • Bugzilla-Integration, Math, CodeMirror and WikiEditor have hardcoded paths for .../core/extensions/.../images and thus are symlinked

Start/Stop/Enable/Disable

This is done via the webserver:

/etc/init.d/apache2 start/stop

Responsible

Dennis Roczek <dennisroczek@gmail.com>