TWiki/PatternSkin.mdwn

   1 # <a name="Pattern skin"></a><a name=" Pattern skin"></a> Pattern skin
   2
   3 **PatternSkin provides a CSS based default look and feel for TWiki - flexible and W3C-compliant.** Its layout and color scheme are designed to provide a nice, clean and productive _editing environment_. For use in corporate or perhaps in personal websites it should be fairly easy to tune the looks or even create a PatternSkin-based new skin.
   4
   5 <div><span>Page contents</span><ul>
   6     <li>
   7       <ul>
   8         <li><a href="#Screenshot"> Screenshot</a></li>
   9       </ul>
  10     </li>
  11     <li><a href="#TWiki Installation Error">TWiki Installation Error</a><ul>
  12         <li><a href="#Creating your own look"> Creating your own look</a><ul>
  13             <li><a href="#Template customization"> Template customization</a></li>
  14             <li><a href="#Style sheet customization"> Style sheet customization</a></li>
  15           </ul>
  16         </li>
  17         <li><a href="#Supported browsers"> Supported browsers</a></li>
  18         <li><a href="#Installation"> Installation</a><ul>
  19             <li><a href="#Troubleshooting"> Troubleshooting</a></li>
  20           </ul>
  21         </li>
  22         <li><a href="#Skin Info"> Skin Info</a></li>
  23         <li><a href="#Related topics"> Related topics</a></li>
  24         <li><a href="#Feedback"> Feedback</a></li>
  25       </ul>
  26     </li>
  27   </ul>
  28 </div>
  29
  30 ## <a name="Screenshot"></a> Screenshot
  31
  32 [<img src="http://www.dementia.org/twiki//view/patternskin_screenshot.jpg" width="600" height="130" alt="Click for full screen image" style="border: 1px solid #eee" />](http://www.dementia.org/twiki//view/patternskin_screenshot_full.png)
  33
  34 ## <a name="Creating your own look"></a> Creating your own look
  35
  36 ### <a name="Template customization"></a> Template customization
  37
  38 [[PatternSkinCustomization]] - how to configure page elements
  39
  40 ### <a name="Style sheet customization"></a> Style sheet customization
  41
  42 [[PatternSkinCssCookbook]] - how to customize the visual style
  43
  44 ## <a name="Supported browsers"></a> Supported browsers
  45
  46 PatternSkin has been tested successfully on the following browsers:
  47
  48 - Windows
  49   - Internet Explorer 6.0, 5.5 (note: Explorer 5.0 is **not** supported: will function but shows visual quirks)
  50   - Mozilla/Firefox
  51 - Mac OS X
  52   - Safari 2.0.3
  53   - Mozilla/Firefox 1.5 (note: Firefox 1.0 will show visual quirks)
  54 - \*nix
  55   - Mozilla/Firefox 1.5 (note: Firefox 1.0 will show visual quirks)
  56
  57 ## <a name="Installation"></a> Installation
  58
  59 **Note:** You do not need to install anything on the browser to use this skin. The following instructions are for the administrator who installs the skin on the server where TWiki is running.
  60
  61 **Note 2:** PatternSkin is included with TWiki by default. Use the following instructions only if you are upgrading PatternSkin.
  62
  63 - Download the ZIP file from the Skin Home page (see below)
  64 - Unzip <code>**%TOPIC%.zip**</code> in your twiki installation directory
  65 - Test if installed: [[http://www.dementia.org/twiki/view/%WEB%/%TOPIC%?skin=pattern|%WEB%/%TOPIC%?skin=pattern]]
  66 - For skin activation see [[TWikiSkins]]
  67
  68 ### <a name="Troubleshooting"></a> Troubleshooting
  69
  70 If you have set the SKIN variable setting to `pattern` and you still don't see the layout as on the [screenshot](http://www.dementia.org/twiki//view/patternskin_screenshot_full.png), a few settings in may have been disabled.
  71
  72 Check these variables here:
  73
  74 - TWIKILAYOUTURL = %TWIKILAYOUTURL%
  75 - TWIKISTYLEURL = %TWIKISTYLEURL%
  76 - TWIKICOLORSURL = %TWIKICOLORSURL%
  77 - SKIN = %SKIN%
  78
  79 If TWIKILAYOUTURL or TWIKISTYLEURL don't give a value or point to non-existing files, check in [[TWikiPreferences]] that the following variables do exist and that they are set to on:
  80
  81        * %TWIKIWEB%.PatternSkin settings:
  82           * Set TWIKILAYOUTURL = %PUBURLPATH%/%TWIKIWEB%/PatternSkin/layout.css
  83           * Set TWIKISTYLEURL = %PUBURLPATH%/%TWIKIWEB%/PatternSkin/style.css
  84           * Set TWIKICOLORSURL = %PUBURLPATH%/%TWIKIWEB%/PatternSkin/colors.css
  85
  86 **NOTE:** customization of these values should be done in [[Main.TWikiPreferences|Main/TWikiPreferences]]
  87
  88 If this still does not work, contact the administrator who installs skins.
  89
  90 For further troubleshooting and feedback, go to TWiki:Plugins/PatternSkinDev. Report bugs in the [[Support web|TWiki:Support/WebHome]].
  91
  92 ## <a name="Skin Info"></a> Skin Info
  93
  94 <table border="1" cellpadding="0" cellspacing="0">
  95   <tr>
  96     <td align="right"> Description: </td>
  97     <td> TWiki's default skin; CSS based, flexible and W3C-compliant </td>
  98   </tr>
  99   <tr>
 100     <td align="right"> Screenshot: </td>
 101     <td><a href="http://www.dementia.org/twiki//view/patternskin_screenshot_full.png"><img alt="Click for full screen image" height="130" src="http://www.dementia.org/twiki//view/patternskin_screenshot.jpg" style="border: 1px solid #eee" width="600" /></a></td>
 102   </tr>
 103   <tr>
 104     <td align="right"> Preview: </td>
 105     <td>[[%WEB%/%TOPIC%?skin=pattern]]</td>
 106   </tr>
 107   <tr>
 108     <td align="right"> Base Name: </td>
 109     <td> pattern </td>
 110   </tr>
 111   <tr>
 112     <td align="right"> Skin Author: </td>
 113     <td> TWiki:Main/ArthurClemens </td>
 114   </tr>
 115   <tr>
 116     <td align="right"> Skin Version: </td>
 117     <td> 15 Jan 2006 (v2.0.6) </td>
 118   </tr>
 119   <tr>
 120     <td align="right"> History: </td>
 121     <td>  </td>
 122   </tr>
 123   <tr>
 124     <td align="right"> 15 Jan 2006: </td>
 125     <td> v.2.0.6 - TWiki 4.1.0 (Edinburgh) RELEASE VERSION </td>
 126   </tr>
 127   <tr>
 128     <td align="right"> 26 Sep 2006: </td>
 129     <td> v.2.0.5 - Fixed form background colors </td>
 130   </tr>
 131   <tr>
 132     <td align="right"> 22 Jul 2006: </td>
 133     <td> v.2.0.4 - Refactored info in colors.css; fixed textarea color </td>
 134   </tr>
 135   <tr>
 136     <td align="right"> 26 Jun 2006: </td>
 137     <td> v.2.0.3 - TWiki 4.0.3 (Dakar) RELEASE VERSION </td>
 138   </tr>
 139   <tr>
 140     <td align="right"> 31 Jan 2006: </td>
 141     <td> v.2.0.0 - TWiki 4.0.0 (Dakar) RELEASE VERSION </td>
 142   </tr>
 143   <tr>
 144     <td align="right"> 28 Aug 2004: </td>
 145     <td> v.1.0.9 - TWiki 3.0 (Cairo) RELEASE VERSION </td>
 146   </tr>
 147   <tr>
 148     <td align="right"> 08 Aug 2004: </td>
 149     <td> Initial version (v1.0.0) </td>
 150   </tr>
 151   <tr>
 152     <td align="right"> Dependencies: </td>
 153     <td> TWiki:Plugins/TwistyContrib (automatically supported by Dakar) </td>
 154   </tr>
 155   <tr>
 156     <td align="right"> Skin Home: </td>
 157     <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td>
 158   </tr>
 159   <tr>
 160     <td align="right"> Feedback: </td>
 161     <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev</a></td>
 162   </tr>
 163   <tr>
 164     <td align="right"> Download: </td>
 165     <td><a href="http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%" target="_top">http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%</a></td>
 166   </tr>
 167 </table>
 168
 169 ## <a name="Related topics"></a> Related topics
 170
 171 - [[TWikiCss]]
 172 - [[PatternSkinCss]]
 173 - [[PatternSkinCssCookbook]]
 174 - [[PatternSkinCssCookbookCenterPage]]
 175 - [[PatternSkinCssCookbookEditTableStyle]]
 176 - [[PatternSkinCssCookbookFonts]]
 177 - [[PatternSkinCssCookbookNoLeftBar]]
 178 - [[PatternSkinCssCookbookNoTopBar]]
 179 - [[PatternSkinCustomization]]
 180 - [[PatternSkinJavascripts]]
 181 - [[WebBottomBar]]
 182 - [[WebLeftBar]]
 183 - [[WebLeftBarCookbook]]
 184 - [[WebLeftBarExample]]
 185 - [[WebLeftBarLogin]]
 186 - [[WebLeftBarPersonalTemplate]]
 187 - [[WebLeftBarSearch]]
 188 - [[WebLeftBarWebsList]]
 189 - [[WebTopBar]]
 190 - [[AdminDocumentationCategory]]
 191
 192 Other skins:
 193
 194 - [[TWikiSkins]]
 195 - [[TWikiSkinBrowser]]
 196
 197 ## <a name="Feedback"></a> Feedback
 198
 199 Leave remarks, suggestions and other feedback in TWiki:Plugins.PatternSkinDev.