docs/skin.txt

   1
   2 skin.txt
   3
   4 This document describes the overall architecture of MediaWiki's HTML rendering
   5 code as well as some history about the skin system. It is placed here rather
   6 than in comments in the code itself to help reduce the code size.
   7
   8 == Version 1.6 and greater ==
   9
  10 PHPTal skins doesn't exist anymore. They were replaced by SkinTemplate skins,
  11 introduced since 1.4 to remove the depedency of PHPTal.
  12
  13 A new experimental (disabled by default) callback-based template processor
  14 has been introduced to try to speed up the generation of html pages. See for
  15 example skins/disabled/MonoBookCBT.php.
  16
  17 You can find more informations at http://www.mediawiki.org/wiki/Manual:Skins.
  18
  19
  20 == Version 1.4 ==
  21
  22 MediaWiki still use the PHPTal skin system introduced in version 1.3 but some
  23 changes have been made to the file organisation.
  24
  25 PHP class and PHPTal templates have been moved to /skins/ (respectivly from
  26 /includes/ and /templates/). This way skin designer and end user just stick to
  27 one directory.
  28
  29 Two samples are provided to start with, one for PHPTal use (SkinPHPTal.sample)
  30 and one without (Skin.sample).
  31
  32
  33 == Version 1.3 ==
  34
  35 The following might help a bit though.
  36
  37 Firstly, there's Skin.php; this file will check various settings, and it
  38 contains a base class from which new skins can be derived.
  39
  40 Before version 1.3, each skin had its own PHP file (with a sub-class to Skin)
  41 to generate the output. The files are:
  42  * SkinCologneBlue.php
  43  * SkinNostalgia.php
  44  * SkinStandard.php
  45  * SkinWikimediaWiki.php
  46 If you want to change those skins, you have to edit these PHP files.
  47
  48 Since 1.3 a new special skin file is available: SkinPHPTal.php. It makes use of
  49 the PHPTal template engine and allows you to separate code and layout of the
  50 pages. The default 1.3 skin is MonoBook and it uses the SkinPHPTAL class.
  51
  52 To change the layout, just edit the PHPTal template (templates/xhtml_slim.pt)
  53 as well as the stylesheets (stylesheets/monobook/*).
  54
  55
  56 == pre 1.3 version ==
  57
  58 Unfortunately there isn't any documentation, and the code's in a bit of a mess
  59 right now during the transition from the old skin code to the new template-based
  60 skin code in 1.3.