Difference: TWikiSkins (1 vs. 22)
Revision 222011-08-12 - TWikiContributor
TWiki SkinsSkins overlay regular templates to give different looks and feels to TWiki screens.
On this page:
OverviewTWiki 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. 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, view this topic with a non-existant skin. 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. Relevant links on TWiki.org:
See other types of extensions: TWikiAddOns, TWikiContribs, TWikiPlugins
Changing the default TWiki skinTWiki 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.
Defining Skins | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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 can start doing this. | ||||||||||||||||||||||||||||||||||||||||||||||||||
The TWikiTemplates files used for skins are located in the twiki/templates directory and are named according to the skin: <scriptname>.<skin>.tmpl. Skin files may also be defined in TWiki topics - see TWikiTemplates for details.
To start creating a new skin, copy the default TWikiTemplates (like 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.
For your own TWiki skin you are encouraged to show a small 80x31 pixel
The standard TWiki skins show the logo in the
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. (Certain template files are expected to provide certain TMPL:DEFs - these are listed in sub-bullets)
Partial customisation, or adding in new features to an existing skin
You can use recusion in the TMPL:INCLUDE chain (eg twiki.classic.tmpl contains %TMPL:INCLUDE{"view"}%
%TMPL:DEF{"edit_topic_link"}%%TMPL:END%
%TMPL:DEF{"edit_wysiwyg_link"}%%TMPL:END%
and then set SKIN=yourlocal,pattern.
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
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
The Jump Box and Navigation BoxThe default skins include a Jump Box, to jump to a topic.
The box also understands URLs, e.g. you can type Here is an example form that has a select box and the Jump Box for illustration purposes. You need to have JavaScript enabled for this to work:
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||||||||||||||
Note: Redirect to a URL only works if it is enabled in
Using Cascading Style Sheets
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
<style type='text/css' media='all'>@import url('%PUBURLPATH%/%SYSTEMWEB%/MySkin/mystyle.css');</style>
Attachment TablesControlling 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.
The format of standard attachment tables is defined through the use of special TWiki template macros which by default, are defined in the
The format of tables of file versions in the Upload screen can also be changed, using the macros:
The
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
Browsing Installed SkinsYou can try out all installed skins in the TWikiSkinBrowser.
Activating SkinsTWiki uses a skin search path, which lets you combine skins additively. The skin path is defined using a combination of TWikiVariables and URL parameters.
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
The basic skin is defined by a
You can also add a parameter to the URL, such as
Setting
This pushes a different skin to the front of the skin search path (so for our example above, that final skin path will be
An example would be invoking the printable mode, which is achieved by applying
The full skin path is built up as follows: Hard-Coded Skins
The
Skin names starting with Related Topics: TWikiSkinBrowser, AdminDocumentationCategory, DeveloperDocumentationCategory, TWiki:TWiki.TWikiSkinsSupplement -- Contributors: TWiki:Main.PeterThoeny, TWiki:Main.MikeMannix, TWiki:Main.CrawfordCurrie | |||||||||||||||||||||||||||||||||||||||||||||||||||
Revision 212010-05-14 - TWikiContributor
TWiki SkinsSkins overlay regular templates to give different looks and feels to TWiki screens.
On this page:
OverviewTWiki 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. 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, view this topic with a non-existant skin. 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. Relevant links on TWiki.org:
See other types of extensions: TWikiAddOns, TWikiContribs, TWikiPlugins
Changing the default TWiki skinTWiki 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.
Defining SkinsYou 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.
The TWikiTemplates files used for skins are located in the
To start creating a new skin, copy the default TWikiTemplates (like 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.
For your own TWiki skin you are encouraged to show a small 80x31 pixel
The standard TWiki skins show the logo in the
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. (Certain template files are expected to provide certain TMPL:DEFs - these are listed in sub-bullets)
Partial customisation, or adding in new features to an existing skin
You can use recusion in the TMPL:INCLUDE chain (eg twiki.classic.tmpl contains %TMPL:INCLUDE{"view"}%
%TMPL:DEF{"edit_topic_link"}%%TMPL:END%
%TMPL:DEF{"edit_wysiwyg_link"}%%TMPL:END%
and then set SKIN=yourlocal,pattern.
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
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
| |||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||
| < < |
| ||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||
| < < | The "Go" Box and Navigation Box | ||||||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||
| > > | The Jump Box and Navigation Box | ||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||
| < < | The default skins include a "Go" box, also called "Jump" box, to jump to a topic. | ||||||||||||||||||||||||||||||||||||||||||
| > > | The default skins include a 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 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. | |||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||
| < < | Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work: | ||||||||||||||||||||||||||||||||||||||||||
| > > | Here is an example form that has a select box and the Jump Box for illustration purposes. You need to have JavaScript enabled for this to work: | ||||||||||||||||||||||||||||||||||||||||||
|
Note: Redirect to a URL only works if it is enabled in
Using Cascading Style Sheets
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
<style type='text/css' media='all'>@import url('%PUBURLPATH%/%SYSTEMWEB%/MySkin/mystyle.css');</style>
Attachment TablesControlling 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.
The format of standard attachment tables is defined through the use of special TWiki template macros which by default, are defined in the
The format of tables of file versions in the Upload screen can also be changed, using the macros:
The
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
Browsing Installed SkinsYou can try out all installed skins in the TWikiSkinBrowser.
Activating SkinsTWiki uses a skin search path, which lets you combine skins additively. The skin path is defined using a combination of TWikiVariables and URL parameters.
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
The basic skin is defined by a
You can also add a parameter to the URL, such as
Setting
This pushes a different skin to the front of the skin search path (so for our example above, that final skin path will be
An example would be invoking the printable mode, which is achieved by applying
The full skin path is built up as follows: Hard-Coded Skins
The
Skin names starting with Related Topics: TWikiSkinBrowser, AdminDocumentationCategory, DeveloperDocumentationCategory, TWiki:TWiki.TWikiSkinsSupplement -- Contributors: TWiki:Main.PeterThoeny, TWiki:Main.MikeMannix, TWiki:Main.CrawfordCurrie | |||||||||||||||||||||||||||||||||||||||||||
Revision 202007-01-14 - TWikiContributor
TWiki SkinsSkins overlay regular templates to give different looks and feels to TWiki screens.
On this page:
OverviewTWiki 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. 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, view this topic with a non-existant skin. 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. Relevant links on TWiki.org:
See other types of extensions: TWikiAddOns, TWikiContribs, TWikiPlugins
Changing the default TWiki skinTWiki 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.
Defining SkinsYou 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.
The TWikiTemplates files used for skins are located in the
To start creating a new skin, copy the default TWikiTemplates (like 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.
For your own TWiki skin you are encouraged to show a small 80x31 pixel
The standard TWiki skins show the logo in the
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. (Certain template files are expected to provide certain TMPL:DEFs - these are listed in sub-bullets)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| > > |  Note: Make sure templates do not end with a newline. Any newline will expand to an empty <p /> in the generated html. It will produce invalid html, and may break the page layout. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Deleted: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Partial customisation, or adding in new features to an existing skin
You can use recusion in the TMPL:INCLUDE chain (eg twiki.classic.tmpl contains %TMPL:INCLUDE{"view"}%
%TMPL:DEF{"edit_topic_link"}%%TMPL:END%
%TMPL:DEF{"edit_wysiwyg_link"}%%TMPL:END%
and then set SKIN=yourlocal,pattern.
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
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
The "Go" Box and Navigation BoxThe default skins include a "Go" box, also called "Jump" box, to jump to a topic.
The box also understands URLs, e.g. you can type Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work:
Note: Redirect to a URL only works if it is enabled in
Using Cascading Style Sheets
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
<style type='text/css' media='all'>@import url('%PUBURLPATH%/%SYSTEMWEB%/MySkin/mystyle.css');</style>
Attachment TablesControlling 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.
The format of standard attachment tables is defined through the use of special TWiki template macros which by default, are defined in the
The format of tables of file versions in the Upload screen can also be changed, using the macros:
The
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
Browsing Installed SkinsYou can try out all installed skins in the TWikiSkinBrowser.
Activating SkinsTWiki uses a skin search path, which lets you combine skins additively. The skin path is defined using a combination of TWikiVariables and URL parameters.
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
The basic skin is defined by a
You can also add a parameter to the URL, such as
Setting
This pushes a different skin to the front of the skin search path (so for our example above, that final skin path will be
An example would be invoking the printable mode, which is achieved by applying
The full skin path is built up as follows: Hard-Coded Skins
The
Skin names starting with Related Topics: TWikiSkinBrowser, AdminDocumentationCategory, DeveloperDocumentationCategory, TWiki:TWiki.TWikiSkinsSupplement -- Contributors: TWiki:Main.PeterThoeny, TWiki:Main.MikeMannix, TWiki:Main.CrawfordCurrie | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Revision 192007-01-14 - TWikiContributor
| Deleted: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | TWiki Skins | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | TWiki Skins | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Skins overlay regular templates to give different looks and feels to TWiki screens. | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||||||||||||||
OverviewTWiki 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. | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | 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, view this topic with a non-existant skin. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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, view this topic with a non-existant skin. | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
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.
Relevant links on TWiki.org:
See other types of extensions: TWikiAddOns, TWikiContribs, TWikiPlugins
Changing the default TWiki skin | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
Defining Skins | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
The TWikiTemplates files used for skins are located in the twiki/templates directory and are named according to the skin: <scriptname>.<skin>.tmpl. Skin files may also be defined in TWiki topics - see TWikiTemplates for details.
To start creating a new skin, copy the default TWikiTemplates (like | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | For your own TWiki skin you are encouraged to show a small 80x31 pixel  logo at the bottom of your skin: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | <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> | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | For your own TWiki skin you are encouraged to show a small 80x31 pixel logo at the bottom of your skin: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | <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> | ||||||||||||||||||||||||||||||||||||||||||||||||||
The standard TWiki skins show the logo in the %WEBCOPYRIGHT% variable.
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. (Certain template files are expected to provide certain TMPL:DEFs - these are listed in sub-bullets)
Partial customisation, or adding in new features to an existing skin
You can use recusion in the TMPL:INCLUDE chain (eg twiki.classic.tmpl contains %TMPL:INCLUDE{"view"}%
%TMPL:DEF{"edit_topic_link"}%%TMPL:END%
%TMPL:DEF{"edit_wysiwyg_link"}%%TMPL:END%
and then set SKIN=yourlocal,pattern. | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | 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 TWikiPreferences for globally, or a Web's Webname.WebPreferences for a particular web) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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 TWikiPreferences for globally, or a Web's Webname.WebPreferences for a particular web) | ||||||||||||||||||||||||||||||||||||||||||||||||||
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
The "Go" Box and Navigation BoxThe default skins include a "Go" box, also called "Jump" box, to jump to a topic.
The box also understands URLs, e.g. you can type Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work:
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||||||||||||||
Note: Redirect to a URL only works if it is enabled in
Using Cascading Style Sheets
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
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||||||||||||||
|
Attachment TablesControlling 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.
The format of standard attachment tables is defined through the use of special TWiki template macros which by default, are defined in the
The format of tables of file versions in the Upload screen can also be changed, using the macros:
The
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < |
| ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < |
| ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||||||||||
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
Browsing Installed SkinsYou can try out all installed skins in the TWikiSkinBrowser.
Activating SkinsTWiki uses a skin search path, which lets you combine skins additively. The skin path is defined using a combination of TWikiVariables and URL parameters.
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
The basic skin is defined by a
You can also add a parameter to the URL, such as
Setting
This pushes a different skin to the front of the skin search path (so for our example above, that final skin path will be
An example would be invoking the printable mode, which is achieved by applying
The full skin path is built up as follows: Hard-Coded Skins
The
Skin names starting with Related Topics: TWikiSkinBrowser, AdminDocumentationCategory, DeveloperDocumentationCategory, TWiki:TWiki.TWikiSkinsSupplement -- Contributors: TWiki:Main.PeterThoeny, TWiki:Main.MikeMannix, TWiki:Main.CrawfordCurrie | |||||||||||||||||||||||||||||||||||||||||||||||||||
Revision 182007-01-14 - TWikiContributor
On this page:
TWiki SkinsSkins overlay regular templates to give different looks and feels to TWiki screens.
OverviewTWiki 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. 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, view this topic with a non-existant skin. 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. | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < |  Tip: TWiki:TWiki.TWikiSkinsSupplement on TWiki.org has supplemental documentation on TWiki Skins. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | Relevant links on TWiki.org: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | See other types of extensions: TWikiAddOns, TWikiContribs, TWikiPlugins | ||||||||||||||||||||||||||||||||||||||||||||||||||
Changing the default TWiki skinTWiki 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.
Defining SkinsYou 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. | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | The TWikiTemplates files used for skins are located in the twiki/templates directory and are named according to the skin: <scriptname>.<skin>.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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | The TWikiTemplates files used for skins are located in the twiki/templates directory and are named according to the skin: <scriptname>.<skin>.tmpl. Skin files may also be defined in TWiki topics - see TWikiTemplates for details. | ||||||||||||||||||||||||||||||||||||||||||||||||||
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. | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | For your own TWiki skin you are encouraged to show a small 80x31 pixel logo at the bottom of your skin:
The standard TWiki skins show the logo in the | ||||||||||||||||||||||||||||||||||||||||||||||||||
Note: Two skin names have reserved meanings; text skin, and skin names starting with rss have hard-coded meanings.
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. (Certain template files are expected to provide certain TMPL:DEFs - these are listed in sub-bullets)
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||||||||||
twiki.tmpl is a master template conventionally used by other templates, but not used directly by code. | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Deleted: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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.
Partial customisation, or adding in new features to an existing skin
You can use recusion in the TMPL:INCLUDE chain (eg twiki.classic.tmpl contains %TMPL:INCLUDE{"view"}%
%TMPL:DEF{"edit_topic_link"}%%TMPL:END%
%TMPL:DEF{"edit_wysiwyg_link"}%%TMPL:END%
and then set SKIN=yourlocal,pattern.
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 | ||||||||||||||||||||||||||||||||||||||||||||||||||
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | The "Go" Box and Navigation Box | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | The "Go" Box and Navigation Box | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | The default %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 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | The default skins include a "Go" box, also called "Jump" box, to jump to a topic. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work:
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | Bare bones header, for demo only
| ||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Deleted: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | Bare bones header for demo only | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | Welcome | Register | Changes | Topics | Index | Search | Go | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | Jump: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Deleted: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < |
Using Cascading Style Sheets | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | CSS is used by PatternSkin, the TWiki skin that is selected in new installations. See that skin topic for information how CSS is used. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | Note: Redirect to a URL only works if it is enabled in configure (Miscellaneous, {AllowRedirectUrl}). | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | Using Cascading Style Sheets | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | Write in your main template: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||||||||||
<style type='text/css' media='all'>@import url('%PUBURLPATH%/%TWIKIWEB%/MySkin/mystyle.css');</style>
Attachment TablesControlling 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.
The format of standard attachment tables is defined through the use of special TWiki template macros which by default, are defined in the
The format of tables of file versions in the Upload screen can also be changed, using the macros:
The
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
Browsing Installed SkinsYou can try out all installed skins in the TWikiSkinBrowser.
Activating SkinsTWiki uses a skin search path, which lets you combine skins additively. The skin path is defined using a combination of TWikiVariables and URL parameters.
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
The basic skin is defined by a
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | You can also add a parameter to the URL, such as ?skin=catskin, bearskin. Example activation of PrintSkin that generates a printable page: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | You can also add a parameter to the URL, such as ?skin=catskin,bearskin: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | 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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
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. | ||||||||||||||||||||||||||||||||||||||||||||||||||
The full skin path is built up as follows: SKIN setting (or ?skin if it is set), then COVER setting is added, then ?cover.
Hard-Coded Skins
The
Skin names starting with Related Topics: TWikiSkinBrowser, AdminDocumentationCategory, DeveloperDocumentationCategory, TWiki:TWiki.TWikiSkinsSupplement -- Contributors: TWiki:Main.PeterThoeny, TWiki:Main.MikeMannix, TWiki:Main.CrawfordCurrie | |||||||||||||||||||||||||||||||||||||||||||||||||||
Revision 172005-03-27 - TWikiContributor
On this page:
TWiki SkinsSkins overlay regular templates to give different looks and feels to TWiki screens.
OverviewTWiki 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. 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, view this topic with a non-existant skin. 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.
Changing the default TWiki skinTWiki 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.
Defining SkinsYou 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.
The TWikiTemplates files used for skins are located in the
To start creating a new skin, copy the default TWikiTemplates (like
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. (Certain template files are expected to provide certain TMPL:DEFs - these are listed in sub-bullets) | |||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||
| < < |
| ||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||||||||
twiki.tmpl is a master template conventionally used by other templates, but not used directly by code.
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
| |||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||
| < < |
| ||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||||||||
The "Go" Box and Navigation Box
The default Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work:
Using Cascading Style SheetsCSS is used by PatternSkin, the TWiki skin that is selected in new installations. See that skin topic for information how CSS is used.
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 Write in your main template: <style type='text/css' media='all'>@import url('%PUBURLPATH%/%TWIKIWEB%/MySkin/mystyle.css');</style>
Attachment TablesControlling 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.
The format of standard attachment tables is defined through the use of special TWiki template macros which by default, are defined in the
The format of tables of file versions in the Upload screen can also be changed, using the macros:
The
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
Browsing Installed SkinsYou can try out all installed skins in the TWikiSkinBrowser.
Activating SkinsTWiki uses a skin search path, which lets you combine skins additively. The skin path is defined using a combination of TWikiVariables and URL parameters.
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
The basic skin is defined by a | |||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||
| < < |
| ||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||||||||
You can also add a parameter to the URL, such as ?skin=catskin, bearskin. Example activation of PrintSkin that generates a printable page: | |||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||
| < < | |||||||||||||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||||||||||||
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. | |||||||||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||
| < < |
| ||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||||||||||||
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 full skin path is built up as follows: Hard-Coded Skins
The
Skin names starting with Related Topics: TWikiSkinBrowser, AdminDocumentationCategory, DeveloperDocumentationCategory, TWiki:TWiki.TWikiSkinsSupplement -- Contributors: TWiki:Main.PeterThoeny, TWiki:Main.MikeMannix, TWiki:Main.CrawfordCurrie | |||||||||||||||||||||||||||||||||||||||||||||||||
Revision 162005-03-27 - TWikiContributor
On this page:
TWiki Skins | |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | Skins overlay regular templates with alternate header/footer layouts; topic text is not affected | ||||||||||||||||
| > > | Skins overlay regular templates to give different looks and feels to TWiki screens. | ||||||||||||||||
Overview | |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | Skins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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. | ||||||||||||||||
| > > | 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. | ||||||||||||||||
| Added: | |||||||||||||||||
| > > | 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, view this topic with a non-existant skin.
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.
Changing the default TWiki skinTWiki 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. | ||||||||||||||||
Defining Skins | |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | Skin files are located in the twiki/templates directory and are named with the syntax: <scriptname>.<skin>.tmpl. For example, the Printable skin for the view template is view.print.tmpl. | ||||||||||||||||
| > > | 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. | ||||||||||||||||
| Changed: | |||||||||||||||||
| < < | Use the existing TWikiTemplates (like view.tmpl) or skin files as a base for your own skin, name it for example view.myskin.tmpl. | ||||||||||||||||
| > > | The TWikiTemplates files used for skins are located in the twiki/templates directory and are named according to the skin: <scriptname>.<skin>.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. | ||||||||||||||||
| Added: | |||||||||||||||||
| > > | 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.
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. (Certain template files are expected to provide certain TMPL:DEFs - these are listed in sub-bullets)
twiki.tmpl is a master template conventionally used by other templates, but not used directly by code.
| ||||||||||||||||
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
| |||||||||||||||||
| Added: | |||||||||||||||||
| > > |
| ||||||||||||||||
| |||||||||||||||||
| Changed: | |||||||||||||||||
| < < |
| ||||||||||||||||
| > > |
| ||||||||||||||||
| |||||||||||||||||
| Added: | |||||||||||||||||
| > > |
| ||||||||||||||||
| |||||||||||||||||
| Changed: | |||||||||||||||||
| < < |
| ||||||||||||||||
| > > |
| ||||||||||||||||
| |||||||||||||||||
| Changed: | |||||||||||||||||
| < < |
| ||||||||||||||||
| > > |
| ||||||||||||||||
The "Go" Box and Navigation Box | |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | The %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 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. | ||||||||||||||||
| > > | The default %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 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. | ||||||||||||||||
| Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work: | |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | |||||||||||||||||
| > > | |||||||||||||||||
| |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | |||||||||||||||||
| > > | |||||||||||||||||
Using Cascading Style Sheets | |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | 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. | ||||||||||||||||
| > > | CSS is used by PatternSkin, the TWiki skin that is selected in new installations. See that skin topic for information how CSS is used. | ||||||||||||||||
| Changed: | |||||||||||||||||
| < < | Example: To use a style sheet for the broadcast message, add this to view.myskin.tmpl: | ||||||||||||||||
| > > | 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. | ||||||||||||||||
| Added: | |||||||||||||||||
| > > | Write in your main template: | ||||||||||||||||
| Changed: | |||||||||||||||||
| < < | |||||||||||||||||
| Deleted: | |||||||||||||||||
| < < | .broadcastmessage { background: yellow; display:block; border-style:solid;border-width: 2px;border-color:red; } .broadcastmessage strong {color: red} | ||||||||||||||||
| Deleted: | |||||||||||||||||
| < < | Then add a div tag to the %BROADCASTMESSAGE% variable located after the #PageTop anchor or after the opening form tag:
<div class="broadcastmessage"> %BROADCASTMESSAGE% </div> | ||||||||||||||||
Attachment Tables | |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | 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. | ||||||||||||||||
| > > | 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. | ||||||||||||||||
| Changed: | |||||||||||||||||
| < < | 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: | ||||||||||||||||
| > > | 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: | ||||||||||||||||
| |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | The format of tables of file versions in the Upload screen are also formattable, using the macros: | ||||||||||||||||
| > > | |||||||||||||||||
| Added: | |||||||||||||||||
| > > | The format of tables of file versions in the Upload screen can also be changed, using the macros: | ||||||||||||||||
The
| |||||||||||||||||
| Changed: | |||||||||||||||||
| < < |
| ||||||||||||||||
| > > |
| ||||||||||||||||
| |||||||||||||||||
| Deleted: | |||||||||||||||||
| < < | 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. | ||||||||||||||||
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
Browsing Installed Skins | |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | You can try all installed skins in TWikiSkinBrowser. | ||||||||||||||||
| > > | You can try out all installed skins in the TWikiSkinBrowser. | ||||||||||||||||
Activating Skins | |||||||||||||||||
| Changed: | |||||||||||||||||
| < < | A skin can be activated in two ways: | ||||||||||||||||
| > > | 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. | ||||||||||||||||
| Changed: | |||||||||||||||||
| < < |
| ||||||||||||||||
| > > | 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 view.skin.tmpl, 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. | ||||||||||||||||
| Deleted: | |||||||||||||||||
| < < |
| ||||||||||||||||
| Changed: | |||||||||||||||||
| < < |
| ||||||||||||||||
| > > | The basic skin is defined by a SKIN setting: | ||||||||||||||||
| Deleted: | |||||||||||||||||
| < < |
| ||||||||||||||||
| Changed: | |||||||||||||||||
| < < | The ?skin=name URL parameter overrides the SKIN Preference value. | ||||||||||||||||
| > > |
| ||||||||||||||||
| Changed: | |||||||||||||||||
| < < | -- TWiki:Main.PeterThoeny - 25 Jul 2004 | ||||||||||||||||
| > > | You can also add a parameter to the URL, such as ?skin=catskin, bearskin. Example activation of PrintSkin that generates a printable page: | ||||||||||||||||
| Deleted: | |||||||||||||||||
| < < | -- TWiki:Main.CrawfordCurrie - 30 Jun 2004 | ||||||||||||||||
| Added: | |||||||||||||||||
| > > |
Setting
This pushes a different skin to the front of the skin search path (so for our example above, that final skin path will be
The full skin path is built up as follows: Hard-Coded Skins
The
Skin names starting with Related Topics: TWikiSkinBrowser, AdminDocumentationCategory, DeveloperDocumentationCategory, TWiki:TWiki.TWikiSkinsSupplement -- Contributors: TWiki:Main.PeterThoeny, TWiki:Main.MikeMannix, TWiki:Main.CrawfordCurrie | ||||||||||||||||
Revision 152004-07-25 - PeterThoeny
| Changed: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| < < | On this page:
TWiki SkinsSkins overlay regular templates with alternate header/footer layouts; topic text is not affected
OverviewSkins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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.
Defining Skins
Skin files are located in the
Use the existing TWikiTemplates (like
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
The "Go" Box and Navigation Box
The Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work:
Using Cascading Style SheetsThe regular templates files currently do not use style sheets. Many skin developers choose to use them, it helps in separating style from content.
Example: To use a style sheet for the broadcast message, add this to
<style type="text/css">
.broadcastmessage {
background: yellow; display:block;
border-style:solid;border-width: 2px;border-color:red;
}
.broadcastmessage strong {color: red}
</style>
Then add a div tag to the
<div class="broadcastmessage"> %BROADCASTMESSAGE% </div>
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
Activating SkinsA skin can be activated in two ways:
The -- PeterThoeny - 05 Jan 2003 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| > > | On this page:
TWiki SkinsSkins overlay regular templates with alternate header/footer layouts; topic text is not affected
OverviewSkins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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.
Defining Skins
Skin files are located in the
Use the existing TWikiTemplates (like
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
The "Go" Box and Navigation Box
The Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work:
Using Cascading Style SheetsAlthough 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.
Example: To use a style sheet for the broadcast message, add this to
<style type="text/css">
.broadcastmessage {
background: yellow; display:block;
border-style:solid;border-width: 2px;border-color:red;
}
.broadcastmessage strong {color: red}
</style>
Then add a div tag to the
<div class="broadcastmessage"> %BROADCASTMESSAGE% </div>
Attachment TablesControlling 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.
The format of standard attachment tables is defined through the use of special TWiki template macros which by default are defined in the
The | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| > > |
Note: it is easy to change the look and feel for an entire site by editing the
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
Browsing Installed SkinsYou can try all installed skins in TWikiSkinBrowser.
Activating SkinsA skin can be activated in two ways:
The
-- TWiki:Main.PeterThoeny - 25 Jul 2004 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Revision 142003-10-12 - PeterThoeny
On this page:
TWiki SkinsSkins overlay regular templates with alternate header/footer layouts; topic text is not affected
OverviewSkins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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.
Defining Skins
Skin files are located in the
Use the existing TWikiTemplates (like
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
| |||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||
| < < |
| ||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||
The "Go" Box and Navigation Box
The Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work:
| |||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||
| > > |
Using Cascading Style SheetsThe regular templates files currently do not use style sheets. Many skin developers choose to use them, it helps in separating style from content.
Example: To use a style sheet for the broadcast message, add this to
<style type="text/css">
.broadcastmessage {
background: yellow; display:block;
border-style:solid;border-width: 2px;border-color:red;
}
.broadcastmessage strong {color: red}
</style>
Then add a div tag to the
<div class="broadcastmessage"> %BROADCASTMESSAGE% </div> | ||||||||||||||||||||||||||||||||||||||
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
Activating SkinsA skin can be activated in two ways:
The -- PeterThoeny - 05 Jan 2003 | |||||||||||||||||||||||||||||||||||||||
Revision 132003-10-12 - PeterThoeny
On this page:
TWiki SkinsSkins overlay regular templates with alternate header/footer layouts; topic text is not affected
OverviewSkins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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.
Defining Skins
Skin files are located in the
Use the existing TWikiTemplates (like
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
| |||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||
| > > |
| ||||||||||||||||||||||||||||||||||||||
The "Go" Box and Navigation Box
The Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work:
Packaging and Publishing Skins | |||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||
| < < | See TWiki:Plugins/SkinPackagingHowTo | ||||||||||||||||||||||||||||||||||||||
| > > | See TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ | ||||||||||||||||||||||||||||||||||||||
Activating SkinsA skin can be activated in two ways:
The -- PeterThoeny - 05 Jan 2003 | |||||||||||||||||||||||||||||||||||||||
Revision 122003-07-26 - PeterThoeny
On this page:
TWiki SkinsSkins overlay regular templates with alternate header/footer layouts; topic text is not affected
OverviewSkins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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.
Defining Skins
Skin files are located in the
Use the existing TWikiTemplates (like
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
The "Go" Box and Navigation Box
The Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work:
| |||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||
| < < | |||||||||||||||||||||||||||||||||||||||
| > > | |||||||||||||||||||||||||||||||||||||||
Bare bones header for demo only
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo
Activating SkinsA skin can be activated in two ways:
The -- PeterThoeny - 05 Jan 2003 | |||||||||||||||||||||||||||||||||||||||
Revision 112003-01-08 - PeterThoeny
On this page:
TWiki SkinsSkins overlay regular templates with alternate header/footer layouts; topic text is not affected
OverviewSkins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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.
Defining Skins
Skin files are located in the
Use the existing TWikiTemplates (like
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
| |||||||||||||||||||
| Changed: | |||||||||||||||||||
| < < |
| ||||||||||||||||||
| > > |
| ||||||||||||||||||
The "Go" Box and Navigation Box
The Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work: | |||||||||||||||||||
| Changed: | |||||||||||||||||||
| < < | |||||||||||||||||||
| > > | |||||||||||||||||||
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo
Activating SkinsA skin can be activated in two ways:
The -- PeterThoeny - 05 Jan 2003 | |||||||||||||||||||
Revision 102003-01-05 - PeterThoeny
On this page:
TWiki SkinsSkins overlay regular templates with alternate header/footer layouts; topic text is not affected
OverviewSkins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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.
Defining Skins
Skin files are located in the
Use the existing TWikiTemplates (like
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
| |||||||||||||||||||
| Changed: | |||||||||||||||||||
| < < |
| ||||||||||||||||||
| > > |
| ||||||||||||||||||
| Deleted: | |||||||||||||||||||
| < < |
| ||||||||||||||||||
The "Go" Box and Navigation Box
The Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work: | |||||||||||||||||||
| Changed: | |||||||||||||||||||
| < < | |||||||||||||||||||
| > > | |||||||||||||||||||
Packaging and Publishing SkinsSee TWiki:Plugins/SkinPackagingHowTo
Activating SkinsA skin can be activated in two ways:
The | |||||||||||||||||||
| Changed: | |||||||||||||||||||
| < < | -- PeterThoeny - 03 Jan 2003 | ||||||||||||||||||
| > > | -- PeterThoeny - 05 Jan 2003 | ||||||||||||||||||
Revision 92003-01-04 - PeterThoeny
On this page:
TWiki SkinsSkins overlay regular templates with alternate header/footer layouts; topic text is not affected
OverviewSkins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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.
Defining Skins
Skin files are located in the | |||||||||||||||||||||||||||||||||||||||||||
| Added: | |||||||||||||||||||||||||||||||||||||||||||
| > > | Use the existing TWikiTemplates (like view.tmpl) or skin files as a base for your own skin, name it for example view.myskin.tmpl.
Variables in SkinsYou can use template variables, TWikiVariables, and other predefined variables to compose your skins. Some commonly used variables in skins:
The "Go" Box and Navigation Box
The Here is an example form that has a select box and the "Go" box for illustration purposes. You need to have JavaScript enabled for this to work:
Packaging and Publishing Skins | ||||||||||||||||||||||||||||||||||||||||||
Activating SkinsA skin can be activated in two ways:
The | |||||||||||||||||||||||||||||||||||||||||||
| Changed: | |||||||||||||||||||||||||||||||||||||||||||
| < < | -- PeterThoeny - 14 Jul 2001 | ||||||||||||||||||||||||||||||||||||||||||
| > > | -- PeterThoeny - 03 Jan 2003 | ||||||||||||||||||||||||||||||||||||||||||
Revision 82001-09-16 - MikeMannix
On this page:
TWiki Skins | ||||||||
| Changed: | ||||||||
| < < | Overlay regular templates with alternate header/footer layouts | |||||||
| > > | Skins overlay regular templates with alternate header/footer layouts; topic text is not affected | |||||||
OverviewSkins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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.
Defining Skins
Skin files are located in the
Activating SkinsA skin can be activated in two ways:
The
-- PeterThoeny - 14 Jul 2001 | ||||||||
Revision 72001-09-14 - PeterThoeny
On this page:
TWiki SkinsOverlay regular templates with alternate header/footer layouts
Overview | ||||||||
| Changed: | ||||||||
| < < | Skins are customized TWiki Templates files. You can use skins to change the look of a TWiki 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. | |||||||
| > > | Skins are customized TWikiTemplates files. You can use skins to change the look of a TWiki 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. | |||||||
| Changed: | ||||||||
| < < | --++ Defining Skins | |||||||
| > > | Defining Skins | |||||||
Skin files are located in the twiki/templates directory and are named with the syntax: <scriptname>.<skin>.tmpl. For example, the Printable skin for the view template is view.print.tmpl.
Activating SkinsA skin can be activated in two ways:
The
-- PeterThoeny - 14 Jul 2001 | ||||||||
Revision 62001-09-10 - MikeMannix
| Added: | ||||||||
| > > | ||||||||
TWiki Skins | ||||||||
| Changed: | ||||||||
| < < | Skins are customized TWikiTemplate files. You can use skins to change the look of a TWiki 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. | |||||||
| > > | Overlay regular templates with alternate header/footer layouts | |||||||
| Changed: | ||||||||
| < < | Skin files are located in the twiki/template directory and are name with this syntax: <scriptname>.<skin>.tmpl. For example, the print skin for the view template is view.print.tmpl (red color added for clarification). | |||||||
| > > | Overview | |||||||
| Added: | ||||||||
| > > | Skins are customized TWiki Templates files. You can use skins to change the look of a TWiki 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.
--++ Defining Skins
Skin files are located in the
Activating Skins | |||||||
| A skin can be activated in two ways: | ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > | ||||||||
| Added: | ||||||||
| > > |
| |||||||
| ||||||||
| Added: | ||||||||
| > > | ||||||||
| ||||||||
| Changed: | ||||||||
| < < | The ?skin=name URL parameter overrides the SKIN preference value. | |||||||
| > > | The ?skin=name URL parameter overrides the SKIN Preference value. | |||||||
|
-- PeterThoeny - 14 Jul 2001 | ||||||||
Revision 52001-09-07 - MikeMannix
| Changed: | ||||||||
| < < | TWiki Skins | |||||||
| > > | TWiki Skins | |||||||
|
Skins are customized TWikiTemplate files. You can use skins to change the look of a TWiki 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.
Skin files are located in the A skin can be activated in two ways:
The
-- PeterThoeny - 14 Jul 2001 | ||||||||
Revision 42001-08-30 - MikeMannix
TWiki Skins | ||||||||
| Changed: | ||||||||
| < < | Skins are customized TWikiTemplate files. You can use skins to change the look of a TWiki 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. | |||||||
| > > | Skins are customized TWikiTemplate files. You can use skins to change the look of a TWiki 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. | |||||||
| Changed: | ||||||||
| < < | A skin file is located in the twiki/template directory and has a name like <scriptname>.<skin>.tmpl. For example, the print skin for the view template is view.print.tmpl (red color added for clarification). | |||||||
| > > | Skin files are located in the twiki/template directory and are name with this syntax: <scriptname>.<skin>.tmpl. For example, the print skin for the view template is view.print.tmpl (red color added for clarification). | |||||||
| A skin can be activated in two ways: | ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
The
-- PeterThoeny - 14 Jul 2001 | ||||||||
Revision 32001-07-15 - PeterThoeny
TWiki Skins | ||||||||
| Changed: | ||||||||
| < < | Skins are customized template files. You can use skins to change the look of a TWiki 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. | |||||||
| > > | Skins are customized TWikiTemplate files. You can use skins to change the look of a TWiki 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. | |||||||
| Changed: | ||||||||
| < < | A skin file is located in the twiki/template directory and has a name like <scriptname>.<skin>.tmpl or <scriptname>.<topicname>.<skin>.tmpl. For example, the print skin for the view template is view.print.tmpl (red color added for clarification). | |||||||
| > > | A skin file is located in the twiki/template directory and has a name like <scriptname>.<skin>.tmpl. For example, the print skin for the view template is view.print.tmpl (red color added for clarification). | |||||||
A skin can be activated in two ways:
| ||||||||
| Changed: | ||||||||
| < < |
| |||||||
| > > |
| |||||||
The | ||||||||
| Changed: | ||||||||
| < < | -- PeterThoeny - 16 Mar 2001 | |||||||
| > > | -- PeterThoeny - 14 Jul 2001 | |||||||
Revision 22001-03-16 - PeterThoeny
| Added: | ||||||||
| > > | TWiki Skins | |||||||
| Skins are customized template files. You can use skins to change the look of a TWiki 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. | ||||||||
| Changed: | ||||||||
| < < | A skin file is located in the twiki/template directory and has a name like <scriptname>.<skin>.tmpl or <scriptname>.<topicname>.<skin>.tmpl. For example, the print skin for the view template is view.print.tmpl (red color added for clarification). | |||||||
| > > | A skin file is located in the twiki/template directory and has a name like <scriptname>.<skin>.tmpl or <scriptname>.<topicname>.<skin>.tmpl. For example, the print skin for the view template is view.print.tmpl (red color added for clarification). | |||||||
A skin can be activated in two ways:
| ||||||||
| Changed: | ||||||||
| < < | The ?skin=name URL parameter overrides the SKIN preference value. | |||||||
| > > | The ?skin=name URL parameter overrides the SKIN preference value. | |||||||
| Changed: | ||||||||
| < < | -- PeterThoeny - 20 Jan 2001 | |||||||
| > > | -- PeterThoeny - 16 Mar 2001 | |||||||
Revision 12001-01-20 - PeterThoeny
| Skins are customized template files. You can use skins to change the look of a TWiki 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.
A skin file is located in the A skin can be activated in two ways:
The
-- PeterThoeny - 20 Jan 2001 |
Copyright © 1999-2025 by the contributing authors. All material on this collaboration platform is the property of the contributing authors. Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.TWikiSkins.