KDE.org/mediawiki: Difference between revisions
m Improved spelling. |
Corrected the section about customisations. Made the code semantic. |
||
| Line 1: | Line 1: | ||
{{Warning|This is an unfinished article}} | {{Warning|This is an unfinished article.}} | ||
__TOC__ | __TOC__ | ||
| Line 9: | Line 9: | ||
==The Setup== | ==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. | All wikis share a single codebase. The difference comes through a customized <code>Localsettings.php</code>, which loads the config for each wiki depending on the URL that was requested. Those configs are named according to the wiki, e.g. <code>Localsettings.community.php</code> for this one. | ||
Those files only have configuration options which are dependent on the Domain, like the DB that is used or Domain name. Everything else is configured through either LocalSettings.php or CommonSettings.php | Those files only have configuration options which are dependent on the Domain, like the DB that is used or Domain name. Everything else is configured through either <code>LocalSettings.php</code> or <code>CommonSettings.php</code>. | ||
===Configuration=== | ===Configuration=== | ||
There is a certain order in which the configs are loaded: | 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) | # <code>includes/DefaultSettings.php</code> | ||
# Localsettings.XXX.php (Domain dependant settings) | # <code>Localsettings.php</code> (here we set those parts that are common to all wikis and which need to be set BEFORE the Domain itself) | ||
# CommonSettings.php (the last settings we want to set, especially extensions we are using) | # <code>Localsettings.XXX.php</code> (Domain dependant settings) | ||
# <code>CommonSettings.php</code> (the last settings we want to set, especially extensions we are using) | |||
== Customizations == | == Customizations == | ||
Our wikis use a custom skin, named '''Oxygen''', which is hosted in | Our wikis used to use a custom skin by default, named '''Oxygen''', which is hosted in SVN. See [http://websvn.kde.org/trunk/www/patches/mediawiki/skins/]. There was an effort to replace it with a new custom skin, called '''Chihuahua''', after the name of the skin from KDE's main site. You can find it in the same repository. | ||
You can find it in the same repository. | |||
However, this effort was disregarded when the new Vector skin was introduced in upstream MediaWiki, because it supported non-16:9 form factors significantly better. | |||
[[Category:KDE Web Team]] | [[Category:KDE Web Team]] | ||
Latest revision as of 10:32, 25 March 2025
Warning
KDE uses MediaWiki[1] for its wikis at https://userbase.kde.org/, https://techbase.kde.org/, this one and the Brazilian team page at https://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 set up 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 dependent 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.phpLocalsettings.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 used to use a custom skin by default, named Oxygen, which is hosted in SVN. See [2]. There was an effort to replace it with a new custom skin, called Chihuahua, after the name of the skin from KDE's main site. You can find it in the same repository.
However, this effort was disregarded when the new Vector skin was introduced in upstream MediaWiki, because it supported non-16:9 form factors significantly better.