data/TWiki/TWikiSkins.txt,v
author Colas Nahaboo <colas@nahaboo.net>
Sat, 26 Jan 2008 15:50:53 +0100
changeset 0 414e01d06fd5
child 1 e2915a7cbdfa
permissions -rw-r--r--
RELEASE 4.2.0 freetown
     1 head	1.19;
     2 access;
     3 symbols;
     4 locks; strict;
     5 comment	@# @;
     6 
     7 
     8 1.19
     9 date	2008.01.22.03.21.34;	author TWikiContributor;	state Exp;
    10 branches;
    11 next	1.18;
    12 
    13 1.18
    14 date	2007.01.16.04.11.59;	author TWikiContributor;	state Exp;
    15 branches;
    16 next	1.17;
    17 
    18 1.17
    19 date	2006.04.01.05.55.15;	author TWikiContributor;	state Exp;
    20 branches;
    21 next	1.16;
    22 
    23 1.16
    24 date	2006.02.01.12.01.19;	author TWikiContributor;	state Exp;
    25 branches;
    26 next	1.15;
    27 
    28 1.15
    29 date	2004.07.25.23.29.00;	author PeterThoeny;	state Exp;
    30 branches;
    31 next	1.14;
    32 
    33 1.14
    34 date	2003.10.12.18.11.37;	author PeterThoeny;	state Exp;
    35 branches;
    36 next	1.13;
    37 
    38 1.13
    39 date	2003.10.12.06.15.00;	author PeterThoeny;	state Exp;
    40 branches;
    41 next	1.12;
    42 
    43 1.12
    44 date	2003.07.26.20.58.00;	author PeterThoeny;	state Exp;
    45 branches;
    46 next	1.11;
    47 
    48 1.11
    49 date	2003.01.08.07.14.49;	author PeterThoeny;	state Exp;
    50 branches;
    51 next	1.10;
    52 
    53 1.10
    54 date	2003.01.05.04.59.21;	author PeterThoeny;	state Exp;
    55 branches;
    56 next	1.9;
    57 
    58 1.9
    59 date	2003.01.04.08.38.00;	author PeterThoeny;	state Exp;
    60 branches;
    61 next	1.8;
    62 
    63 1.8
    64 date	2001.09.16.05.51.07;	author MikeMannix;	state Exp;
    65 branches;
    66 next	1.7;
    67 
    68 1.7
    69 date	2001.09.14.08.43.22;	author PeterThoeny;	state Exp;
    70 branches;
    71 next	1.6;
    72 
    73 1.6
    74 date	2001.09.10.00.07.45;	author MikeMannix;	state Exp;
    75 branches;
    76 next	1.5;
    77 
    78 1.5
    79 date	2001.09.07.10.07.38;	author MikeMannix;	state Exp;
    80 branches;
    81 next	1.4;
    82 
    83 1.4
    84 date	2001.08.30.22.08.21;	author MikeMannix;	state Exp;
    85 branches;
    86 next	1.3;
    87 
    88 1.3
    89 date	2001.07.15.06.49.40;	author PeterThoeny;	state Exp;
    90 branches;
    91 next	1.2;
    92 
    93 1.2
    94 date	2001.03.16.08.59.35;	author PeterThoeny;	state Exp;
    95 branches;
    96 next	1.1;
    97 
    98 1.1
    99 date	2001.01.20.23.28.47;	author PeterThoeny;	state Exp;
   100 branches;
   101 next	;
   102 
   103 
   104 desc
   105 @none
   106 @
   107 
   108 
   109 1.19
   110 log
   111 @buildrelease
   112 @
   113 text
   114 @%META:TOPICINFO{author="TWikiContributor" date="1168736701" format="1.1" version="19"}%
   115 %STARTINCLUDE%
   116 ---+ TWiki Skins
   117 
   118 _Skins overlay regular templates to give different looks and feels to TWiki screens._
   119 
   120 %TOC%
   121 
   122 ---++ Overview
   123 
   124 TWiki uses TWikiTemplates files as the basis of all the screens it uses to interact with users. Each screen has an associated template file that contains the basic layout of the screen. This is then filled in by the code to generate what you see in the browser.
   125 
   126 TWiki ships with a default set of template files that give a very basic, CSS-themable, look-and-feel. TWiki also includes support for _skins_ that can be selected to give different, more sophisticated, look and feels. A default TWiki installation will usually start up with the PatternSkin already selected. Skins may also be defined by third parties and loaded into a TWiki installation to give more options. To see how TWiki looks when *no* skin is selected, [[%SCRIPTURL{"view"}%/%WEB%/%TOPIC%?skin=not_a_skin][view this topic with a non-existant skin]].
   127 
   128 Topic text is not affected by the choice of skin, though a skin can be defined to use a CSS (Cascading Style Sheet), which can sometimes give a radically different appearance to the text.
   129 
   130 __Relevant links on TWiki.org:__
   131    * TWiki:TWiki.TWikiSkinsSupplement - __%T% tip:__ supplemental documentation on TWiki skins
   132    * TWiki:Plugins.SkinPackage - list of all contributed skin packages
   133    * TWiki:Plugins.SkinDevelopment - discussion and feedback on contributed skins
   134    * TWiki:Plugins.SkinBrainstorming - open forum for new skin ideas
   135    * TWiki:Plugins.SkinPackageHowTo - template to create a new skin package
   136 
   137 __See other types of extensions:__ TWikiAddOns, TWikiContribs, TWikiPlugins
   138 
   139 ---++ Changing the default TWiki skin
   140 
   141 TWiki default ships with the skin PatternSkin activated. You can set the skin for the whole site, a single web or topic, or for each user individually, by setting the SKIN variable to the name of a skin. If the skin you select doesn't exist, then TWiki will pick up the default templates.
   142 
   143 ---++ Defining Skins
   144 
   145 You may want to define your own skin, for example to comply with corporate web guidelines, or because you have a aesthetic vision that you want to share. There are a couple of places you an start doing this.
   146 
   147 The TWikiTemplates files used for skins are located in the =twiki/templates= directory and are named according to the skin: ==&lt;scriptname&gt;.&lt;skin&gt;.tmpl==. Skin files may also be defined in TWiki topics - see TWikiTemplates for details.
   148 
   149 To start creating a new skin, copy the default TWikiTemplates (like =view.tmpl=), or copy an existing skin to use as a base for your own skin. You should only need to copy the files you intend to customise, as TWiki can be configured to fall back to another skin if a template is not defined in your skin. Name the files as described above (for example =view.myskin.tmpl=.
   150 
   151 If you use PatternSkin as your starting point, and you want to modify the layout, colors or even the templates to suit your own needs, have a look first at the topics PatternSkinCustomization and PatternSkinCssCookbook.
   152 
   153 For your own TWiki skin you are encouraged to show a small 80x31 pixel <a href="http://twiki.org/"><img src="%PUBURL%/%SYSTEMWEB%/TWikiLogos/T-logo-80x15.gif" alt="This site is powered by the TWiki collaboration platform" width="80" height="15" title="This site is powered by the TWiki collaboration platform" border="0" /></a> logo at the bottom of your skin:
   154 
   155 =&lt;a href="http://twiki.org/"&gt;&lt;img src="%<nop>PUBURL%/%<nop>SYSTEMWEB%/TWikiLogos/T-logo-80x15.gif" alt="This site is powered by the TWiki collaboration platform" width="80" height="15" title="This site is powered by the TWiki collaboration platform" border="0" /&gt;&lt;/a&gt;=
   156 
   157 The standard TWiki skins show the logo in the =%<nop>WEBCOPYRIGHT%= variable.
   158 
   159 __%X% Note:__ Two skin names have _reserved_ meanings; =text= skin, and skin names starting with =rss= have [[#HardCodedSkins][hard-coded meanings]].
   160 
   161 The following template files are used for TWiki screens, and are referenced in the TWiki core code. If a skin doesn't define its own version of a template file, then TWiki will fall back to the next skin in the skin path, or finally, to the default version of the template file.
   162 
   163 (Certain template files are expected to provide certain TMPL:DEFs - these are listed in sub-bullets)
   164    * =addform= - used to select a new form for a topic
   165    * =attachagain= - used when refreshing an existing attachment
   166    * =attachnew= - used when attaching a new file to a topic
   167    * =attachtables= - defines the format of attachments at the bottom of the standard topic view
   168       * =ATTACH:files:footer=, =ATTACH:files:header=, =ATTACH:files:row=, =ATTACH:versions:footer=, =ATTACH:versions:header=, =ATTACH:versions:row=
   169    * =changeform= - used to change the form in a topic
   170    * =changes= - used by the =changes= script
   171    * =edit= - used for the edit screen
   172    * =form=
   173    * =formtables= - used to defined the format of forms
   174       * =FORM:display:footer=, =FORM:display:header=, =FORM:display:row=
   175    * =login= - used for loggin in when using the !TemplateLoginManager
   176       * =LOG_IN=, =LOG_IN_BANNER=, =LOG_OUT=, =LOGGED_IN_BANNER=, =NEW_USER_NOTE=, =UNRECOGNISED_USER=
   177    * =moveattachment= - used when moving an attachment
   178    * =oopsaccessdenied= - used to format Access Denied messages
   179       * =no_such_topic=, =no_such_web=, =only_group=, =topic_access=
   180    * =oopsattention= - used to format Attention messages
   181       * =already_exists=, =bad_email=, =bad_ver_code=, =bad_wikiname=, =base_web_missing=, =confirm=, =created_web=, =delete_err=, =invalid_web_color=, =invalid_web_name=, =in_a_group=, =mandatory_field=, =merge_notice=, =missing_action=, =missing_fields=, =move_err=, =missing_action=, =no_form_def=, =no_users_to_reset=, =notwikiuser=, =oversized_upload=, =password_changed=, =password_mismatch=, =problem_adding=, =remove_user_done=, =rename_err=, =rename_not_wikiword=, =rename_topic_exists=, =rename_web_err=, =rename_web_exists=, =rename_web_prerequisites=, =reset_bad=, =reset_ok=, =save_error=, =send_mail_error=, =thanks=, =topic_exists=, =unrecognized_action=, =upload_name_changed=, =web_creation_error=, =web_exists=, =web_missing=, =wrong_password=, =zero_size_upload=
   182    * =oopschangelanguage= - used to prompt for a new language when internationalisation is enabled
   183    * =oopsgeneric= - a basic dialog for user information; provides "ok" button only
   184    * =oopslanguagechanged= - used to confirm a new language when internationalisation is enabled
   185    * =oopsleaseconflict= - used to format lease Conflict messages
   186       * =lease_active=, =lease_old=
   187    * =preview= - used for previewing edited topics before saving
   188    * =rdiff= - used for viewing topic differences
   189    * =registernotify= - used by the user registration system
   190    * =registernotifyadmin= - used by the user registration system
   191    * =rename= - used when renaming a topic
   192    * =renameconfirm= - used when renaming a topic
   193    * =renamedelete= - used when renaming a topic
   194    * =renameweb= - used when renaming a web
   195    * =renamewebconfirm= - used when renaming a web
   196    * =renamewebdelete= - used when renaming a web
   197    * =searchbookview= - used to format inline search results in book view
   198    * =searchformat= - used to format inline search results
   199    * =search= - used by the =search= CGI script
   200    * =settings=
   201    * =view= - used by the =view= CGI script
   202    * =viewprint= - used to create the printable view
   203    
   204 =twiki.tmpl= is a master template conventionally used by other templates, but not used directly by code.
   205 
   206 
   207 __%X% Note:__ It is best to create these templates for your skin. If you =TMPL:INCLUDE= the default templates, or templates from other skins, when you are defining your own skin, you run the risk that the included file might change and break your skin. 
   208 
   209 ---+++ Partial customisation, or adding in new features to an existing skin
   210 
   211 You can use recusion in the TMPL:INCLUDE chain (eg twiki.classic.tmpl contains =%<nop>TMPL:INCLUDE{"twiki"}%=, the templating system will include the next twiki.SKIN in the skin path. 
   212 For example, to create a customisation of pattern skin, where you _only_ want to remove the edit & WYSIWYG buttons from view page, you create only a =view.yourlocal.tmpl=:
   213 <verbatim>
   214 %TMPL:INCLUDE{"view"}%
   215 %TMPL:DEF{"edit_topic_link"}%%TMPL:END%
   216 %TMPL:DEF{"edit_wysiwyg_link"}%%TMPL:END%
   217 </verbatim>
   218 and then set =SKIN=yourlocal,pattern=.
   219 
   220 Because ClassicSkin and the default templates use the same Template definition names, you can over-ride the edit links in them (or any skin derived from them) using the same =view.yourlocal.tmpl= (just set SKIN=yourlocal,classic either in %USERSWEB%.TWikiPreferences for globally, or a Web's <nop>Webname.<nop>WebPreferences for a particular web) 
   221 
   222 ---++ Variables in Skins
   223 
   224 You can use [[TWikiTemplates#TemplateVariables][template variables]], TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
   225 
   226 | *Variable:* | *Expanded to:* |
   227 | =%<nop>WEBLOGONAME%= | Filename of web logo |
   228 | =%<nop>WEBLOGOIMG%= | Image URL of web logo |
   229 | =%<nop>WEBLOGOURL%= | Link of web logo |
   230 | =%<nop>WEBLOGOALT%= | Alt text of web logo |
   231 | =%<nop>WIKILOGOURL%= | Link of page logo |
   232 | =%<nop>WIKILOGOIMG%= | Image URL of page logo |
   233 | =%<nop>WIKILOGOALT%= | Alt text of page logo |
   234 | =%<nop>WEBBGCOLOR%= | Web-specific background color, defined in the WebPreferences |
   235 | =%<nop>WIKITOOLNAME%= | The name of your TWiki site |
   236 | =%<nop>SCRIPTURL%= | The script URL of TWiki |
   237 | =%<nop>SCRIPTURLPATH%= | The script URL path |
   238 | =%<nop>SCRIPTSUFFIX%= | The script suffix, ex: =.pl=, =.cgi= |
   239 | =%<nop>WEB%= | The name of the current web. |
   240 | =%<nop>TOPIC%= | The name of the current topic. |
   241 | =%<nop>WEBTOPICLIST%= | Common links of current web, defined in the WebPreferences. It includes a [[#GoBox][Go box]] |
   242 | =%<nop>TEXT%= | The topic text, e.g. the content that can be edited |
   243 | =%<nop>META{"form"}%= | [[TWikiForms][TWikiForm]], if any |
   244 | =%<nop>META{"attachments"}%= | FileAttachment table |
   245 | =%<nop>META{"parent"}%= | The topic parent |
   246 | =%<nop>EDITTOPIC%= | Edit link |
   247 | =%<nop>REVTITLE%= | The revision title, if any, ex: =(r1.6)= |
   248 | =%<nop>REVINFO%= | Revision info, ex: =r1.6 - 24 Dec 2002 - 08:12 GMT - %WIKIUSERNAME%= |
   249 | =%<nop>WEBCOPYRIGHT%= | Copyright notice, defined in the WebPreferences |
   250 | =%<nop>BROADCASTMESSAGE%= | Broadcast message at the beginning of your view template, can be used to alert users of scheduled downtimes; can be set in %LOCALSITEPREFS% |
   251 
   252 #GoBox
   253 ---++ The "Go" Box and Navigation Box
   254 
   255 The default skins include a [[GoBox]["Go" box]], also called "Jump" box, to jump to a topic.
   256 
   257 The box also understands URLs, e.g. you can type =http://www.google.com/= to jump to an external web site. The feature is handy if you build a skin that has a select box of frequently used links, like Intranet home, employee database, sales database and such. A little <nop>JavaScript gets into action on the =onchange= method of the select tag to fill the selected URL into the "Go" box field, then submits the form.
   258 
   259 Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have <nop>JavaScript enabled for this to work:
   260 
   261 <form name="sample" action="%SCRIPTURLPATH{"view"}%/%WEB%/%TOPIC%">
   262 <table border="0" cellpadding="5" bgcolor="#DDDDDD"><tr><td colspan="2">
   263 Bare bones header, for demo only
   264 </td></tr><tr><td>
   265 Navigate:
   266 </td><td>
   267 <select name="sel" onchange="this.form.topic.value=this.options[this.selectedIndex].value; this.form.submit()">
   268 <option selected="selected" value="">...</option>
   269 <option value="http://twiki.org/">Intranet home</option>
   270 <option value="%USERSWEB%.%WIKIUSERSTOPIC%">Employee index</option>
   271 <option value="%USERSWEB%.%HOMETOPIC%">%USERSWEB% web</option>
   272 <option value="%SYSTEMWEB%.%HOMETOPIC%">%SYSTEMWEB% web</option>
   273 <option value="http://www.google.com/">Google</option>
   274 <option value="http://www.yahoo.com/">Yahoo!</option>
   275 </select>
   276 </td></tr><tr><td>
   277 Jump:
   278 </td><td>
   279 <input type="text" name="topic" size="16" />
   280 </td></tr></table>
   281 </form> 
   282 
   283 __Note:__ Redirect to a URL only works if it is enabled in =configure= (Miscellaneous, ={AllowRedirectUrl}=).
   284 
   285 ---++ Using Cascading Style Sheets
   286 
   287 CSS files are gererally attachments to the skin topic that are included in the the skin templates - in the case of PatternSkin in the template =styles.pattern.tmpl=.
   288 
   289    * To see how CSS is used in the default TWiki skin, see: PatternSkin
   290    * If you write a complete new skin, this is the syntax to use in a template file:
   291 <verbatim>
   292 <style type='text/css' media='all'>@@import url('%PUBURLPATH%/%SYSTEMWEB%/MySkin/mystyle.css');</style>
   293 </verbatim>
   294 
   295 ---++ Attachment Tables
   296 Controlling the look and feel of attachment tables is a little bit more complex than for the rest of a skin. By default, the attachment table is a standard TWiki table, and the look is controlled in the same way as other tables. In a very few cases you may want to change the _content_ of the table as well.
   297 
   298 The format of standard attachment tables is defined through the use of special _TWiki template macros_ which by default, are defined in the =attachtables.tmpl= template using the =%TMPL:DEF= macro syntax described in TWikiTemplates. These macros are:
   299 | *Macro* | *Description* |
   300 | =ATTACH:files:header= | Standard title bar |
   301 | =ATTACH:files:row= | Standard row |
   302 | =ATTACH:files:footer= | Footer for all screens |
   303 | =ATTACH:files:header:A= | Title bar for upload screens, with attributes column |
   304 | =ATTACH:files:row:A= | Row for upload screen |
   305 | =ATTACH:files:footer:A= | Footer for all screens |
   306 
   307 The format of tables of file versions in the Upload screen can also be changed, using the macros:
   308 | *Macro* | *Description* |
   309 | =ATTACH:versions:header= | Header for versions table on upload screen |
   310 | =ATTACH:versions:row= | Row format for versions table on upload screen |
   311 | =ATTACH:versions:footer= | Footer for versions table on upload screen |
   312 
   313 The =ATTACH:row= macros are expanded for each file in the attachment table, using the following special tags:
   314 | *Tag* | *Description* |
   315 | =%A_URL%= | =viewfile= URL that will recover the file |
   316 | =%A_REV%= | Revision of this file |
   317 | =%A_ICON%= | A file icon suitable for representing the attachment content |
   318 | =%A_FILE%= | The name of the file. To get the 'pub' url of the file, use =%<nop>PUBURL%/%<nop>WEB%/%<nop>TOPIC%/%<nop>A_FILE%= |
   319 | =%A_SIZE%= | The size of the file |
   320 | =%A_DATE%= | The date the file was uploaded |
   321 | =%A_USER%= | The user who uploaded it |
   322 | =%A_COMMENT%= | The comment they put in when uploading it |
   323 | =%A_ATTRS%= | The attributes of the file as seen on the upload screen e.g "h" for a hidden file |
   324 
   325 ---++ Packaging and Publishing Skins
   326 
   327 See TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
   328 
   329 ---++ Browsing Installed Skins
   330 
   331 You can try out all installed skins in the TWikiSkinBrowser.
   332 
   333 ---++ Activating Skins
   334 
   335 TWiki uses a _skin search path_, which lets you combine skins additively. The skin path is defined using a combination of TWikiVariables and URL parameters.
   336 
   337 TWiki works by asking for a template for a particular function - for example, 'view'. The detail of how templates are searched for is described in TWikiTemplates, but in summary, the templates directory is searched for a file called <code>view.</code><i>skin</i><code>.tmpl</code>, where _skin_ is the name of the skin e.g. =pattern=. If no template is found, then the fallback is to use =view.tmpl=. Each skin on the path is searched for in turn. For example, if you have set the skin path to =local,pattern= then =view.local.tmpl= will be searched for first, then =view.pattern.tmpl= and finally =view.tmpl=.
   338 
   339 The basic skin is defined by a =SKIN= setting:
   340 
   341    * =Set SKIN = catskin, bearskin=
   342 
   343 You can also add a parameter to the URL, such as =?skin=catskin,bearskin=:
   344 
   345    * %SCRIPTURL{view}%/%WEB%/%TOPIC%?skin=catskin,bearskin
   346 
   347 Setting =SKIN= (or the =?skin= parameter in the URL) replaces the existing skin path setting, for the current page only. You can also _extend_ the existing skin path as well, using _covers_.
   348 
   349    * =Set COVER = ruskin=
   350 
   351 This pushes a different skin to the front of the skin search path (so for our example above, that final skin path will be =ruskin, catskin, bearskin=). There is also an equivalent =cover= URL parameter. The difference between setting =SKIN= vs. =COVER= is that if the chosen template is not found (e.g., for included templates), =SKIN= will fall back onto the next skin in line, or the default skin, if only one skin was present, while =COVER= will always fall back onto the current skin.
   352 
   353 An example would be invoking the printable mode, which is achieved by applying =?cover=print=. The =view.print.tmpl= simply invokes the =viewprint= template for the current skin which then can appropriately include all other used templates for the current skin. Where the printable mode be applied by using =SKIN=, all skins would have the same printable appearance.
   354 
   355 The full skin path is built up as follows: =SKIN= setting (or =?skin= if it is set), then =COVER= setting is added, then =?cover=.
   356 
   357 #HardCodedSkins
   358 ---++ Hard-Coded Skins
   359 
   360 The =text= skin is reserved for TWiki internal use.
   361 
   362 Skin names starting with =rss= also have a special meaning; if one or more of the skins in the skin path starts with 'rss' then 8-bit characters will be encoded as XML entities in the output, and the =content-type= header will be forced to =text/xml=.
   363 
   364 __Related Topics:__ TWikiSkinBrowser, AdminDocumentationCategory, DeveloperDocumentationCategory, TWiki:TWiki.TWikiSkinsSupplement
   365 
   366 -- __Contributors:__ TWiki:Main.PeterThoeny, TWiki:Main.MikeMannix, TWiki:Main.CrawfordCurrie
   367 @
   368 
   369 
   370 1.18
   371 log
   372 @buildrelease
   373 @
   374 text
   375 @d1 1
   376 a1 2
   377 %META:TOPICINFO{author="TWikiContributor" date="1168736701" format="1.1" version="18"}%
   378 %TOC%
   379 d3 1
   380 a3 1
   381 ---# TWiki Skins
   382 d7 2
   383 d13 1
   384 a13 1
   385 TWiki ships with a default set of template files that give a basic look-and-feel. TWiki also includes support for _skins_ that can be selected to give different, more sophisticated, look and feels. A default TWiki installation will usually start up with the PatternSkin already selected. Skins may also be defined by third parties and loaded into a TWiki installation to give more options. To see how TWiki looks when *no* skin is selected, [[%SCRIPTURL{"view"}%/%WEB%/%TOPIC%?skin=not_a_skin][view this topic with a non-existant skin]].
   386 d28 1
   387 a28 1
   388 TWiki default ships with the skin PatternSkin activated. If you want to modify the layout, colors or even the templates to suit your own needs, have a look first at the topics PatternSkinCustomization and PatternSkinCssCookbook.
   389 d32 1
   390 a32 1
   391 You may want to define your own skin, for example to comply with corporate web guidelines, or because you have a aesthetic vision that you want to share.
   392 d38 3
   393 a40 1
   394 For your own TWiki skin you are encouraged to show a small 80x31 pixel <a href="http://twiki.org/"><img src="%PUBURL%/%TWIKIWEB%/TWikiLogos/T-logo-80x15.gif" alt="This site is powered by the TWiki collaboration platform" width="80" height="15" title="This site is powered by the TWiki collaboration platform" border="0" /></a> logo at the bottom of your skin:
   395 d42 1
   396 a42 1
   397 =&lt;a href="http://twiki.org/"&gt;&lt;img src="%<nop>PUBURL%/%<nop>TWIKIWEB%/TWikiLogos/T-logo-80x15.gif" alt="This site is powered by the TWiki collaboration platform" width="80" height="15" title="This site is powered by the TWiki collaboration platform" border="0" /&gt;&lt;/a&gt;=
   398 d107 1
   399 a107 1
   400 Because ClassicSkin and the default templates use the same Template definition names, you can over-ride the edit links in them (or any skin derived from them) using the same =view.yourlocal.tmpl= (just set SKIN=yourlocal,classic either in %MAINWEB%.TWikiPreferences for globally, or a Web's <nop>Webname.<nop>WebPreferences for a particular web) 
   401 d157 3
   402 a159 3
   403 <option value="%MAINWEB%.%WIKIUSERSTOPIC%">Employee index</option>
   404 <option value="%MAINWEB%.%HOMETOPIC%">%MAINWEB% web</option>
   405 <option value="%TWIKIWEB%.%HOMETOPIC%">%TWIKIWEB% web</option>
   406 d179 1
   407 a179 1
   408 <style type='text/css' media='all'>@@import url('%PUBURLPATH%/%TWIKIWEB%/MySkin/mystyle.css');</style>
   409 d202 1
   410 a202 1
   411 | =%A_URL%= | URL that will recover the file |
   412 d205 1
   413 a205 1
   414 | =%A_FILE%= | The name of the file |
   415 @
   416 
   417 
   418 1.17
   419 log
   420 @buildrelease
   421 @
   422 text
   423 @d1 1
   424 a1 1
   425 %META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="17"}%
   426 d16 8
   427 a23 1
   428 __%T% Tip:__ TWiki:TWiki.TWikiSkinsSupplement on TWiki.org has supplemental documentation on TWiki Skins.
   429 d33 1
   430 a33 1
   431 The TWikiTemplates files used for skins are located in the =twiki/templates= directory and are named according to the skin: ==&lt;scriptname&gt;.&lt;skin&gt;.tmpl==. For example, the template used for pages generated by the =view= script with the =print= skin selected is =view.print.tmpl= (this is how the *Printable* control is implemented). Skin files may also be defined in TWiki topics - see TWikiTemplates for details.
   432 d37 6
   433 d67 1
   434 d86 2
   435 d90 15
   436 a104 1
   437 __%X% Note:__ You are strongly recommended *not* to =TMPL:INCLUDE= the default templates, or templates from other skins, when you are defining your own skin. If you do, you run the risk that the included file might change and break your skin.
   438 d137 1
   439 a137 1
   440 ---+++ The "Go" Box and Navigation Box
   441 d139 3
   442 a141 1
   443 The default =%<nop>WEBTOPICLIST%= includes a "Go" box, also called "Jump" box, to jump to a topic. The box also understands URLs, e.g. you can type http://www.google.com/ to jump to an external web site. The feature is handy if you build a skin that has a select box of frequently used links, like Intranet home, employee database, sales database and such. A little <nop>JavaScript gets into action on the onSelect method of the select tag to fill the selected URL into the "Go" box field, then submits the form.
   444 d146 5
   445 a150 1
   446 <table border="3"><tr><td>
   447 d152 8
   448 a159 9
   449  <option selected="selected" value="">Navigate...</option>
   450  <option value="http://www.twiki.org/">Intranet home</option>
   451  <option value="%MAINWEB%.%WIKIUSERSTOPIC%">Employee index</option>
   452  <option value="%MAINWEB%.%HOMETOPIC%">%MAINWEB% web</option>
   453  <option value="%TWIKIWEB%.%HOMETOPIC%">%TWIKIWEB% web</option>
   454  <option value="http://www.google.com/">Google</option>
   455  <option value="http://www.yahoo.com/">Yahoo!</option>
   456  </select>
   457 Bare bones header for demo only
   458 d161 3
   459 a163 1
   460 %WEBTOPICLIST%
   461 d166 3
   462 a168 1
   463  
   464 d171 1
   465 a171 1
   466 CSS is used by PatternSkin, the TWiki skin that is selected in new installations. See that skin topic for information how CSS is used.
   467 d173 2
   468 a174 3
   469 CSS files are gererally attachments to the skin topic that are included in the the skin templates - in the case of PatternSkin in the template =css.pattern.tmpl=.
   470 
   471 Write in your main template:
   472 d227 1
   473 a227 1
   474 You can also add a parameter to the URL, such as =?skin=catskin, bearskin=. Example activation of PrintSkin that generates a printable page:
   475 d229 1
   476 a229 1
   477    * %SCRIPTURL{view}%/%WEB%/%TOPIC%?skin=print
   478 d231 1
   479 a231 1
   480 Setting =SKIN= (or the =?skin= parameter in the URL) replaces the existing skin path setting. You can also _extend_ the existing skin path as well, using _covers_.
   481 d235 3
   482 a237 1
   483 This pushes a different skin to the front of the skin search path (so for our example above, that final skin path will be =ruskin, catskin, bearskin=). There is also an equivalent =cover= URL parameter.
   484 @
   485 
   486 
   487 1.16
   488 log
   489 @buildrelease
   490 @
   491 text
   492 @d1 1
   493 a1 1
   494 %META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="16"}%
   495 d35 37
   496 a71 37
   497 	* =addform= - used to select a new form for a topic
   498 	* =attachagain= - used when refreshing an existing attachment
   499 	* =attachnew= - used when attaching a new file to a topic
   500 	* =attachtables= - defines the format of attachments at the bottom of the standard topic view
   501 		* =ATTACH:files:footer=, =ATTACH:files:header=, =ATTACH:files:row=, =ATTACH:versions:footer=, =ATTACH:versions:header=, =ATTACH:versions:row=
   502 	* =changeform= - used to change the form in a topic
   503 	* =changes= - used by the =changes= script
   504 	* =edit= - used for the edit screen
   505 	* =form=
   506 	* =formtables= - used to defined the format of forms
   507 		* =FORM:display:footer=, =FORM:display:header=, =FORM:display:row=
   508 	* =login= - used for loggin in when using the !TemplateLoginManager
   509 		* =LOG_IN=, =LOG_IN_BANNER=, =LOG_OUT=, =LOGGED_IN_BANNER=, =NEW_USER_NOTE=, =UNRECOGNISED_USER=
   510 	* =moveattachment= - used when moving an attachment
   511 	* =oopsaccessdenied= - used to format Access Denied messages
   512 		* =no_such_topic=, =no_such_web=, =only_group=, =topic_access=
   513 	* =oopsattention= - used to format Attention messages
   514 		* =already_exists=, =bad_email=, =bad_ver_code=, =bad_wikiname=, =base_web_missing=, =confirm=, =created_web=, =delete_err=, =invalid_web_color=, =invalid_web_name=, =in_a_group=, =mandatory_field=, =merge_notice=, =missing_action=, =missing_fields=, =move_err=, =missing_action=, =no_form_def=, =no_users_to_reset=, =notwikiuser=, =oversized_upload=, =password_changed=, =password_mismatch=, =problem_adding=, =remove_user_done=, =rename_err=, =rename_not_wikiword=, =rename_topic_exists=, =rename_web_err=, =rename_web_exists=, =rename_web_prerequisites=, =reset_bad=, =reset_ok=, =save_error=, =send_mail_error=, =thanks=, =topic_exists=, =unrecognized_action=, =upload_name_changed=, =web_creation_error=, =web_exists=, =web_missing=, =wrong_password=, =zero_size_upload=
   515 	* =oopschangelanguage= - used to prompt for a new language when internationalisation is enabled
   516 	* =oopslanguagechanged= - used to confirm a new language when internationalisation is enabled
   517 	* =oopsleaseconflict= - used to format lease Conflict messages
   518 		* =lease_active=, =lease_old=
   519 	* =preview= - used for previewing edited topics before saving
   520 	* =rdiff= - used for viewing topic differences
   521 	* =registernotify= - used by the user registration system
   522 	* =registernotifyadmin= - used by the user registration system
   523 	* =rename= - used when renaming a topic
   524 	* =renameconfirm= - used when renaming a topic
   525 	* =renamedelete= - used when renaming a topic
   526 	* =renameweb= - used when renaming a web
   527 	* =renamewebconfirm= - used when renaming a web
   528 	* =renamewebdelete= - used when renaming a web
   529 	* =searchbookview= - used to format inline search results in book view
   530 	* =searchformat= - used to format inline search results
   531 	* =search= - used by the =search= CGI script
   532 	* =settings=
   533 	* =view= - used by the =view= CGI script
   534 d104 1
   535 a104 1
   536 | =%<nop>BROADCASTMESSAGE%= | Broadcast message at the beginning of your view template, can be used to alert users of scheduled downtimes; can be set in %MAINWEB%.TWikiPreferences |
   537 d187 1
   538 a187 1
   539 	* =Set SKIN = catskin, bearskin=
   540 d191 1
   541 a191 1
   542 	* %SCRIPTURL{view}%/%WEB%/%TOPIC%?skin=print
   543 d195 1
   544 a195 1
   545 	* =Set COVER = ruskin=
   546 @
   547 
   548 
   549 1.15
   550 log
   551 @none
   552 @
   553 text
   554 @d1 1
   555 a1 1
   556 %META:TOPICINFO{author="PeterThoeny" date="1090798140" format="1.0" version="1.15"}%
   557 d6 1
   558 a6 1
   559 _Skins overlay regular templates with alternate header/footer layouts; topic text is not affected_
   560 d10 11
   561 a20 1
   562 Skins are customized TWikiTemplates files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example, the layout of the header and footer. Rendered text between header and footer does __not__ change. You can also use skins to define an alternate view, like a view optimized for printing.
   563 d24 5
   564 a28 1
   565 Skin files are located in the =twiki/templates= directory and are named with the syntax: ==&lt;scriptname&gt;.&lt;skin&gt;.tmpl==. For example, the *Printable* skin for the =view= template is =view.print.tmpl=.
   566 d30 45
   567 a74 1
   568 Use the existing TWikiTemplates (like =view.tmpl=) or skin files as a base for your own skin, name it for example =view.myskin.tmpl=.
   569 d81 4
   570 d88 1
   571 a88 1
   572 | =%<nop>WEBBGCOLOR%= | Web specific background color, defined in the WebPreferences |
   573 d91 1
   574 d93 3
   575 a95 3
   576 | =%<nop>WEB%= | The name of the current web. __Note:__ It is recommended to URL-encode the variable in form actions with =%<nop>INTURLENCODE{"%<nop>WEB%"}%= for proper handling in an internationalized environment |
   577 | =%<nop>TOPIC%= | The name of the current topic. __Note:__ It is recommended to URL-encode the variable in form actions with =%<nop>INTURLENCODE{"%<nop>TOPIC%"}%= for proper handling in an internationalized environment |
   578 | =%<nop>WEBTOPICLIST%= | Common links of current web, defined in the WebPreferences. It includes a [[#GoBox]] |
   579 d104 1
   580 a104 1
   581 | =%<nop>BROADCASTMESSAGE%= | Broadcast message at the beginning of your view template, can be used to alert users of scheduled downtimes; is set in TWikiPreferences |
   582 d109 1
   583 a109 1
   584 The =%<nop>WEBTOPICLIST%= includes a "Go" box to jump to a topic. The box also understand URLs, e.g. you can type http://www.google.com/ to jump to an external web site. The feature is handy if you build a skin that has a select box of frequently used links, like Intranet home, employee database, sales database and such. A little <nop>JavaScript gets into action on the onSelect method of the select tag to fill the selected URL into the "Go" box field, then submits the form.
   585 d113 1
   586 a113 1
   587 <form name="sample" action="%SCRIPTURL%/view%SCRIPTSUFFIX%/%INTURLENCODE{"%WEB%/%TOPIC%"}%">
   588 d129 1
   589 a129 1
   590 
   591 d132 1
   592 a132 1
   593 Although work is underway at TWiki:Codev.CssClassNames, the regular templates files currently do not use style sheets.  Many skin developers, however, choose to use them; it helps in separating style from content.
   594 d134 1
   595 a134 1
   596 Example: To use a style sheet for the broadcast message, add this to =view.myskin.tmpl=:
   597 d136 1
   598 d138 1
   599 a138 13
   600 <style type="text/css">
   601 .broadcastmessage {
   602 	 background: yellow; display:block;
   603 	 border-style:solid;border-width: 2px;border-color:red;
   604 }
   605 .broadcastmessage strong {color: red}
   606 </style>
   607 </verbatim>
   608 
   609 Then add a div tag to the =%<nop>BROADCASTMESSAGE%= variable located after the =#PageTop= anchor or after the opening form tag:
   610 
   611 <verbatim>
   612 <div class="broadcastmessage"> %BROADCASTMESSAGE% </div>
   613 d142 1
   614 a142 1
   615 Controlling the look and feel of attachment tables is a little bit more complex than for the rest of a skin. By default the attachment table is a standard TWiki table, and the look is controlled in the same ay as other tables. In a very few cases you may want to change the _content_ of the table as well.
   616 d144 1
   617 a144 1
   618 The format of standard attachment tables is defined through the use of special _TWiki template macros_ which by default are defined in the =templates/twiki.tmpl= template using the =%TMPL:DEF= macro syntax described in TWikiTemplates. These macros are:
   619 d152 2
   620 a153 1
   621 The format of tables of file versions in the Upload screen are also formattable, using the macros:
   622 d162 1
   623 a162 1
   624 | =%A_REV%= | Revision of this file e.g. "1.1" |
   625 a170 2
   626 Note: it is easy to change the look and feel for an entire site by editing the =twiki.tmpl= template file. However, to simplify upgrading, you should avoid doing this. Instead, write a skin-specific template file e.g. =attach.myskin.tmpl= and use =%TMPL:INCLUDE{attach.myskin.tmpl}%= to include it in each of your skin files. As long as it it included _after_ twiki.tmpl, your macro definitions will override the defaults defined there.
   627 
   628 d177 1
   629 a177 1
   630 You can try all installed skins in TWikiSkinBrowser.
   631 d181 19
   632 a199 1
   633 A skin can be activated in two ways:
   634 d201 2
   635 a202 2
   636 	* Define the =SKIN= Preference variable in TWiki.TWikiPreferences, one of the WebPreferences, or in a user - %WIKIUSERNAME% - topic.
   637 		* =Set SKIN = print=
   638 d204 1
   639 a204 3
   640 	* Add =?skin=name= to the URL, for this example:
   641 		* %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?skin=print (for the print view skin)
   642 		* %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?skin=plain (for the plain view skin that has no header and footer)
   643 d206 1
   644 a206 1
   645 The ==?skin=name== URL parameter overrides the SKIN Preference value.
   646 d208 1
   647 a208 2
   648 -- TWiki:Main.PeterThoeny - 25 Jul 2004 %BR%
   649 -- TWiki:Main.CrawfordCurrie - 30 Jun 2004 %BR%
   650 d210 1
   651 @
   652 
   653 
   654 1.14
   655 log
   656 @none
   657 @
   658 text
   659 @d1 143
   660 a143 106
   661 %META:TOPICINFO{author="PeterThoeny" date="1065982296" format="1.0" version="1.14"}%
   662 %TOC%
   663 %STARTINCLUDE%
   664 ---# TWiki Skins
   665 
   666 _Skins overlay regular templates with alternate header/footer layouts; topic text is not affected_
   667 
   668 ---++ Overview
   669 
   670 Skins are customized TWikiTemplates files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example, the layout of the header and footer. Rendered text between header and footer does __not__ change. You can also use skins to define an alternate view, like a view optimized for printing.
   671 
   672 ---++ Defining Skins
   673 
   674 Skin files are located in the =twiki/templates= directory and are named with the syntax: ==&lt;scriptname&gt;.&lt;skin&gt;.tmpl==. For example, the *Printable* skin for the =view= template is =view.print.tmpl=.
   675 
   676 Use the existing TWikiTemplates (like =view.tmpl=) or skin files as a base for your own skin, name it for example =view.myskin.tmpl=.
   677 
   678 ---++ Variables in Skins
   679 
   680 You can use [[TWikiTemplates#TemplateVariables][template variables]], TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
   681 
   682 | *Variable:* | *Expanded to:* |
   683 | =%<nop>WIKILOGOURL%= | Link of page logo |
   684 | =%<nop>WIKILOGOIMG%= | Image URL of page logo |
   685 | =%<nop>WIKILOGOALT%= | Alt text of page logo |
   686 | =%<nop>WEBBGCOLOR%= | Web specific background color, defined in the WebPreferences |
   687 | =%<nop>WIKITOOLNAME%= | The name of your TWiki site |
   688 | =%<nop>SCRIPTURL%= | The script URL of TWiki |
   689 | =%<nop>SCRIPTSUFFIX%= | The script suffix, ex: =.pl=, =.cgi= |
   690 | =%<nop>WEB%= | The name of the current web. __Note:__ It is recommended to URL-encode the variable in form actions with =%<nop>INTURLENCODE{"%<nop>WEB%"}%= for proper handling in an internationalized environment |
   691 | =%<nop>TOPIC%= | The name of the current topic. __Note:__ It is recommended to URL-encode the variable in form actions with =%<nop>INTURLENCODE{"%<nop>TOPIC%"}%= for proper handling in an internationalized environment |
   692 | =%<nop>WEBTOPICLIST%= | Common links of current web, defined in the WebPreferences. It includes a [[#GoBox]] |
   693 | =%<nop>TEXT%= | The topic text, e.g. the content that can be edited |
   694 | =%<nop>META{"form"}%= | [[TWikiForms][TWikiForm]], if any |
   695 | =%<nop>META{"attachments"}%= | FileAttachment table |
   696 | =%<nop>META{"parent"}%= | The topic parent |
   697 | =%<nop>EDITTOPIC%= | Edit link |
   698 | =%<nop>REVTITLE%= | The revision title, if any, ex: =(r1.6)= |
   699 | =%<nop>REVINFO%= | Revision info, ex: =r1.6 - 24 Dec 2002 - 08:12 GMT - %WIKIUSERNAME%= |
   700 | =%<nop>WEBCOPYRIGHT%= | Copyright notice, defined in the WebPreferences |
   701 | =%<nop>BROADCASTMESSAGE%= | Broadcast message at the beginning of your view template, can be used to alert users of scheduled downtimes; is set in TWikiPreferences |
   702 
   703 #GoBox
   704 ---+++ The "Go" Box and Navigation Box
   705 
   706 The =%<nop>WEBTOPICLIST%= includes a "Go" box to jump to a topic. The box also understand URLs, e.g. you can type http://www.google.com/ to jump to an external web site. The feature is handy if you build a skin that has a select box of frequently used links, like Intranet home, employee database, sales database and such. A little <nop>JavaScript gets into action on the onSelect method of the select tag to fill the selected URL into the "Go" box field, then submits the form.
   707 
   708 Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have <nop>JavaScript enabled for this to work:
   709 
   710 <form name="sample" action="%SCRIPTURL%/view%SCRIPTSUFFIX%/%INTURLENCODE{"%WEB%/%TOPIC%"}%">
   711 <table border="3"><tr><td>
   712 <select name="sel" onchange="this.form.topic.value=this.options[this.selectedIndex].value; this.form.submit()">
   713  <option selected="selected" value="">Navigate...</option>
   714  <option value="http://www.twiki.org/">Intranet home</option>
   715  <option value="%MAINWEB%.%WIKIUSERSTOPIC%">Employee index</option>
   716  <option value="%MAINWEB%.%HOMETOPIC%">%MAINWEB% web</option>
   717  <option value="%TWIKIWEB%.%HOMETOPIC%">%TWIKIWEB% web</option>
   718  <option value="http://www.google.com/">Google</option>
   719  <option value="http://www.yahoo.com/">Yahoo!</option>
   720  </select>
   721 Bare bones header for demo only
   722 </td></tr><tr><td>
   723 %WEBTOPICLIST%
   724 </td></tr></table>
   725 </form> 
   726 
   727 ---++ Using Cascading Style Sheets
   728 
   729 The regular templates files currently do not use style sheets. Many skin developers choose to use them, it helps in separating style from content.
   730 
   731 Example: To use a style sheet for the broadcast message, add this to =view.myskin.tmpl=:
   732 
   733 <verbatim>
   734 <style type="text/css">
   735 .broadcastmessage {
   736 	 background: yellow; display:block;
   737 	 border-style:solid;border-width: 2px;border-color:red;
   738 }
   739 .broadcastmessage strong {color: red}
   740 </style>
   741 </verbatim>
   742 
   743 Then add a div tag to the =%<nop>BROADCASTMESSAGE%= variable located after the =#PageTop= anchor or after the opening form tag:
   744 
   745 <verbatim>
   746 <div class="broadcastmessage"> %BROADCASTMESSAGE% </div>
   747 </verbatim>
   748 
   749 ---++ Packaging and Publishing Skins
   750 
   751 See TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
   752 
   753 ---++ Activating Skins
   754 
   755 A skin can be activated in two ways:
   756 
   757 	* Define the =SKIN= Preference variable in TWiki.TWikiPreferences, one of the WebPreferences, or in a user - %WIKIUSERNAME% - topic.
   758 		* =Set SKIN = print=
   759 
   760 	* Add =?skin=name= to the URL, for this example:
   761 		* %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?skin=print (for the print view skin)
   762 		* %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?skin=plain (for the plain view skin that has no header and footer)
   763 
   764 The ==?skin=name== URL parameter overrides the SKIN Preference value.
   765 
   766 -- PeterThoeny - 05 Jan 2003
   767 @
   768 
   769 
   770 1.13
   771 log
   772 @none
   773 @
   774 text
   775 @d1 1
   776 a1 1
   777 %META:TOPICINFO{author="PeterThoeny" date="1065939300" format="1.0" version="1.13"}%
   778 d41 1
   779 a41 1
   780 | =%<nop>BROADCASTMESSAGE%= | Broadcast message at the beginning of your view template, can be used to alert users of scheduled downtimes; is defined in TWikiPreferences |
   781 d66 22
   782 @
   783 
   784 
   785 1.12
   786 log
   787 @none
   788 @
   789 text
   790 @d1 1
   791 a1 1
   792 %META:TOPICINFO{author="PeterThoeny" date="1059253080" format="1.0" version="1.12"}%
   793 d41 1
   794 d69 1
   795 a69 1
   796 See TWiki:Plugins/SkinPackagingHowTo 
   797 @
   798 
   799 
   800 1.11
   801 log
   802 @none
   803 @
   804 text
   805 @d1 1
   806 a1 1
   807 %META:TOPICINFO{author="PeterThoeny" date="1042010089" format="1.0" version="1.11"}%
   808 d54 3
   809 a56 3
   810  <option value="%MAINWEB%.TWikiUsers">Employee index</option>
   811  <option value="%MAINWEB%.WebHome">%MAINWEB% web</option>
   812  <option value="%TWIKIWEB%.WebHome">%TWIKIWEB% web</option>
   813 @
   814 
   815 
   816 1.10
   817 log
   818 @none
   819 @
   820 text
   821 @d1 1
   822 a1 1
   823 %META:TOPICINFO{author="PeterThoeny" date="1041742761" format="1.0" version="1.10"}%
   824 d30 2
   825 a31 2
   826 | =%<nop>WEB%= | The name of the current web. __Note:__ It is recommended to URL-encode the variable in form actions with =%<nop>URLENCODE{"%<nop>WEB%"}%= for proper handling in an internationalized environment |
   827 | =%<nop>TOPIC%= | The name of the current topic. __Note:__ It is recommended to URL-encode the variable in form actions with =%<nop>URLENCODE{"%<nop>TOPIC%"}%= for proper handling in an internationalized environment |
   828 d49 1
   829 a49 1
   830 <form name="sample" action="%SCRIPTURL%/view%SCRIPTSUFFIX%/%URLENCODE{"%WEB%/%TOPIC%"}%">
   831 @
   832 
   833 
   834 1.9
   835 log
   836 @none
   837 @
   838 text
   839 @d1 1
   840 a1 1
   841 %META:TOPICINFO{author="PeterThoeny" date="1041669480" format="1.0" version="1.9"}%
   842 d30 2
   843 a31 4
   844 | =%<nop>WEB%= | The name of the current web |
   845 | =%<nop>WEBURLENCODED%= | The name of the current web, URL encoded (for form action) |
   846 | =%<nop>TOPIC%= | The name of the current topic |
   847 | =%<nop>TOPICURLENCODED%= | The name of the current topic, URL encoded (for form action) |
   848 d49 1
   849 a49 1
   850 <form name="sample" action="%SCRIPTURL%/view%SCRIPTSUFFIX%/%WEBURLENCODED%/%TOPICURLENCODED%">
   851 d83 1
   852 a83 1
   853 -- PeterThoeny - 03 Jan 2003
   854 @
   855 
   856 
   857 1.8
   858 log
   859 @none
   860 @
   861 text
   862 @d1 1
   863 a1 1
   864 %META:TOPICINFO{author="MikeMannix" date="1000619467" format="1.0" version="1.8"}%
   865 d16 56
   866 d85 1
   867 a85 1
   868 -- PeterThoeny - 14 Jul 2001 <br>
   869 @
   870 
   871 
   872 1.7
   873 log
   874 @none
   875 @
   876 text
   877 @d1 1
   878 a1 1
   879 %META:TOPICINFO{author="PeterThoeny" date="1000457002" format="1.0" version="1.7"}%
   880 d6 1
   881 a6 1
   882 _Overlay regular templates with alternate header/footer layouts_
   883 @
   884 
   885 
   886 1.6
   887 log
   888 @none
   889 @
   890 text
   891 @d1 1
   892 a1 1
   893 %META:TOPICINFO{author="MikeMannix" date="1000080465" format="1.0" version="1.6"}%
   894 d10 1
   895 a10 1
   896 Skins are customized [[TWikiDocumentation#TWiki_Template_System][TWiki Templates]] files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example, the layout of the header and footer. Rendered text between header and footer does __not__ change. You can also use skins to define an alternate view, like a view optimized for printing.
   897 d12 1
   898 a12 1
   899 --++ Defining Skins
   900 @
   901 
   902 
   903 1.5
   904 log
   905 @none
   906 @
   907 text
   908 @d1 3
   909 a3 1
   910 %META:TOPICINFO{author="MikeMannix" date="999857258" format="1.0" version="1.5"}%
   911 d6 1
   912 a6 1
   913 Skins are customized [[TWikiTemplates][TWikiTemplate]] files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example the layout of the header and footer. Note that the renderd text between header and footer does __not__ change. You can also use skins to define an alternate view, ex: a view optimized for printing.
   914 d8 9
   915 a16 1
   916 Skin files are located in the ==twiki/template== directory and are name with this syntax: ==&lt;scriptname&gt;.&lt;skin&gt;.tmpl==. For example, the ==print== skin for the ==view== template is ==view<font color="red">.print</font>.tmpl== (red color added for clarification).
   917 d19 2
   918 a20 1
   919 	* Define the SKIN preference variable in TWiki.TWikiPreferences, one of the WebPreferences, or a user preference. Ex: 
   920 d22 1
   921 d27 1
   922 a27 1
   923 The ==?skin=name== URL parameter overrides the SKIN preference value.
   924 @
   925 
   926 
   927 1.4
   928 log
   929 @none
   930 @
   931 text
   932 @d1 2
   933 a2 2
   934 %META:TOPICINFO{author="MikeMannix" date="999209301" format="1.0" version="1.4"}%
   935 ---## TWiki Skins
   936 @
   937 
   938 
   939 1.3
   940 log
   941 @none
   942 @
   943 text
   944 @d1 1
   945 a1 1
   946 %META:TOPICINFO{author="PeterThoeny" date="995179879" format="1.0beta2" version="1.3"}%
   947 d4 1
   948 a4 1
   949 Skins are customized [[TWikiTemplates][TWikiTemplate]] files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example the layout of the header and footer. Note that the renderd text between header and footer does __not__ change. You can use skins also to define an alternate view, i.e. a view optimized for printing.
   950 d6 1
   951 a6 1
   952 A skin file is located in the ==twiki/template== directory and has a name like ==&lt;scriptname&gt;.&lt;skin&gt;.tmpl==. For example, the ==print== skin for the ==view== template is ==view<font color="red">.print</font>.tmpl== (red color added for clarification).
   953 d9 3
   954 a11 3
   955 	* Define the SKIN preference variable in TWiki.TWikiPreferences, one of the WebPreferences, or a user preference. I.e. 
   956 		* =Set SKIN = wikiwiki=
   957 	* Add =?skin=name= to the URL, i.e. for this topic:
   958 @
   959 
   960 
   961 1.2
   962 log
   963 @none
   964 @
   965 text
   966 @d1 1
   967 d4 1
   968 a4 1
   969 Skins are customized template files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example the layout of the header and footer. Note that the renderd text between header and footer does __not__ change. You can use skins also to define an alternate view, i.e. a view optimized for printing.
   970 d6 1
   971 a6 1
   972 A skin file is located in the ==twiki/template== directory and has a name like ==&lt;scriptname&gt;.&lt;skin&gt;.tmpl== or ==&lt;scriptname&gt;.&lt;topicname&gt;.&lt;skin&gt;.tmpl==. For example, the ==print== skin for the ==view== template is ==view<font color="red">.print</font>.tmpl== (red color added for clarification).
   973 d10 1
   974 a10 1
   975 		* <nop>Set SKIN = wikiwiki <br> *Note:* Who has time to create the classic =wikiwiki= skin?
   976 d17 1
   977 a17 1
   978 -- PeterThoeny - 16 Mar 2001 <br>
   979 @
   980 
   981 
   982 1.1
   983 log
   984 @none
   985 @
   986 text
   987 @d1 2
   988 d5 1
   989 a5 1
   990 A skin file is located in the =twiki/template= directory and has a name like =&lt;scriptname&gt;.&lt;skin&gt;.tmpl= or =&lt;scriptname&gt;.&lt;topicname&gt;.&lt;skin&gt;.tmpl=. For example, the =print= skin for the =view= template is =view<font color="red">.print</font>.tmpl= (red color added for clarification).
   991 d14 1
   992 a14 1
   993 The =?skin=name= URL parameter overrides the SKIN preference value.
   994 d16 1
   995 a16 1
   996 -- Main.PeterThoeny - 20 Jan 2001 <br>
   997 @