KDE.org/mediawiki: Difference between revisions

From KDE Community Wiki
(Add mediawiki documentation)
 
No edit summary
Line 1: Line 1:
{{Warning|This is an unfinished article}}
{{Warning|This is an unfinished article}}
__TOC__


KDE uses Mediawiki[http://www.mediawiki.org] for its wikis at userbase.kde.org, techbase.kde.org, this one and the brazilian team page at br.kde.org
KDE uses Mediawiki[http://www.mediawiki.org] for its wikis at userbase.kde.org, techbase.kde.org, this one and the brazilian team page at br.kde.org
This page should give you an idea on how they are set up.
This page should give you an idea on how they are set up.
This is not intended to give instructions on how to install Mediawiki, you can find extensive documentation on their site. Here we will explain how it is setup on our KDE servers.
==The Setup==
All wikis share a single codebase. The difference comes through a customized Localsettings.php, which loads the config for each wiki depending on the URL that was requested. Those configs are named according to the wiki, e.g. Localsettings.community.php for this one.
Those files only have configuration options which are dependant on the Domain, like the DB that is used or Domain name. Everything else is configured through either LocalSettings.php or CommonSettings.php
===Configuration===
There is a certain order in which the configs are loaded:
# includes/DefaultSettings.php
# Localsettings.php (here we set those parts that are common to all wikis and which need to be set BEFORE the Domain itself)
# Localsettings.XXX.php (Domain dependant settings)
# CommonSettings.php (the last settings we want to set, especially extensions we are using)
== Customizations ==
Our wikis use a custom skin, named '''Oxygen''', which is hosted in svn, see [http://websvn.kde.org/trunk/www/patches/mediawiki/skins/]. Lately there is also a new skin in development, called '''Chihuahua''', after the name of the skin from KDE's main site.
You can find it in the same repository.

Revision as of 07:21, 9 September 2010

Warning

This is an unfinished article


KDE uses Mediawiki[1] for its wikis at userbase.kde.org, techbase.kde.org, this one and the brazilian team page at br.kde.org This page should give you an idea on how they are set up.

This is not intended to give instructions on how to install Mediawiki, you can find extensive documentation on their site. Here we will explain how it is setup on our KDE servers.

The Setup

All wikis share a single codebase. The difference comes through a customized Localsettings.php, which loads the config for each wiki depending on the URL that was requested. Those configs are named according to the wiki, e.g. Localsettings.community.php for this one.

Those files only have configuration options which are dependant on the Domain, like the DB that is used or Domain name. Everything else is configured through either LocalSettings.php or CommonSettings.php

Configuration

There is a certain order in which the configs are loaded:

  1. includes/DefaultSettings.php
  2. Localsettings.php (here we set those parts that are common to all wikis and which need to be set BEFORE the Domain itself)
  3. Localsettings.XXX.php (Domain dependant settings)
  4. CommonSettings.php (the last settings we want to set, especially extensions we are using)

Customizations

Our wikis use a custom skin, named Oxygen, which is hosted in svn, see [2]. Lately there is also a new skin in development, called Chihuahua, after the name of the skin from KDE's main site. You can find it in the same repository.