PatternSkin < System

%STARTINCLUDE%
<!--
   * Set SHORTDESCRIPTION = Pattern skin provides a CSS based default look and feel - flexible and [[http://www.w3.org/][W3C]] compliant. Its layout and color scheme are designed to provide a nice, clean and productive editing environment
-->
---+!! Pattern skin

Pattern skin provides a CSS based default look and feel - flexible and [[http://www.w3.org/][W3C]] compliant. Its layout and color scheme are designed to provide a nice, clean and productive editing environment

Select a theme to change the look, or tune the entire appearance with CSS or templates.

%TOC{title="Page contents"}%

---++ Browse available themes
You may quickly change the appearance of this skin by setting a theme.

---+++ Browse themes
Pattern skin has quite some flexibility out of the box. Try one of the provided themes or use them as inspiration for your own theme.
   * [[%SYSTEMWEB%.PatternSkinTheme][Foswiki (default)]]
   * [[%SYSTEMWEB%.PatternSkinTheme2009][Foswiki 2009]]
   * [[%SYSTEMWEB%.PatternSkinThemeFatWilly][Foswiki "Fat Willy" Site Skin]]

<!--
%STARTSECTION{"copysettings"}%
Do you want to keep these settings?
   * Copy the text below to [[%WIKIUSERNAME%][your personal topic]]
   * If you are a site admin, copy the text to %USERSWEB%.SitePreferences (or !WebPreferences for per-web themes)
%ENDSECTION{"copysettings"}%
-->

---+++ Other styling options
   1 Set =WEBHEADERART= (currently: =%WEBHEADERART%=)
      * Test [[%TOPIC%?webheaderart=%PUBURLPATH%/%SYSTEMWEB%/PatternSkin/header1.gif][header1]]
      * Test [[%TOPIC%?webheaderart=%PUBURLPATH%/%SYSTEMWEB%/PatternSkin/header2.gif][header2]]
      * Test [[%TOPIC%?webheaderart=%PUBURLPATH%/%SYSTEMWEB%/PatternSkin/header3.gif][header3]]
      * Test [[%TOPIC%?webheaderart=%PUBURLPATH%/%SYSTEMWEB%/PatternSkin/header4.gif][header4]]
      * Test [[%TOPIC%?webheaderart=%PUBURLPATH%/%SYSTEMWEB%/PatternSkin/header5.gif][header5]]
      * Test [[%TOPIC%?webheaderart=][(none)]] 
   1 Set =WEBBGCOLOR= (currently: =%WEBBGCOLOR%=)

Set these variables site wide in [[%USERSWEB%.SitePreferences]].
<!--
   * Local WEBHEADERART = %URLPARAM{"webheaderart" default="%PUBURLPATH%/%SYSTEMWEB%/PatternSkin/header5.gif"}%
-->

---++ Screenshot

Click to enlarge:%BR%
%SEARCH{ "%TOPIC%" scope="topic" nosearch="on" nototal="on" format="$pattern(.*\| *Screenshot\:[^\|]*\|([^\|]*).*)" }%
<div class="foswikiGrayText">Click to view full screenshot</div>

---++ Information for site administrators
---+++ Creating your own look
If you want to make more changes than the themes on this page allow, you have the option to change CSS files and templates to make changes (small or large).

---++++ Template customization
%SYSTEMWEB%.PatternSkinCustomization - how to configure page elements. %TWISTY{link="View Table of Contents..." remember="on"}%%TOC{"%SYSTEMWEB%.PatternSkinCustomization"}%%ENDTWISTY%

---++++ Style sheet customization
%SYSTEMWEB%.PatternSkinCssCookbook - how to customize the visual style. %TWISTY{link="View Table of Contents..." remember="on"}%%TOC{"%SYSTEMWEB%.PatternSkinCssCookbook"}%%ENDTWISTY%

---++++ Changing graphics
The original Photoshop files of the skin graphics (mainly background images) are attached to PatternSkinGraphics.

---++++ Top, Bottom and Left Bar customization

Most will customise top, bottom, and left bars.

   * Topic =%SYSTEMWEB%.WebTopBar= defines the content of the top bar. If this topic does not exist the topic =%SYSTEMWEB%.WebTopBarExample= will define the top bar. Foswiki does not ship with a =WebTopBar= topic so by creating this topic as a copy of =WebTopBarExample= and customizing the copy, you will not later risk that upgrading Foswiki will overwrite your top bar. The top bar is common for all webs.
   * Topic =%SYSTEMWEB%.WebBottomBar= defines the content of the bottom bar. If this topic does not exist the topic =%SYSTEMWEB%.WebBottomBarExample= will define the bottom bar. Foswiki does not ship with a =WebBottomBar= topic so by creating this topic as a copy of =WebBottomBarExample= and customizing the copy, you will not later risk that upgrading Foswiki will overwrite your bottom bar. The bottom bar is common for all webs.
   * Topic =WebLeftBar= defines the content of the left bar. Each web has its own =WebLeftBar=. If this topic does not exist the topic =WebLeftBarExample= will define the left bar. Foswiki does not ship with =WebLeftBar= topics so by creating these topics as copies of =WebLeftBarExample= and customizing the copies, you will not later risk that upgrading Foswiki will overwrite your left bars. You can choose to display the =WebLeftBar= on the right side of the screen.

See these topics for more information: %SYSTEMWEB%.WebLeftBarCookbook, %SYSTEMWEB%.WebLeftBarExample, %SYSTEMWEB%.WebLeftBarLogin, %SYSTEMWEB%.WebLeftBarPersonalTemplate, %SYSTEMWEB%.WebLeftBarSearch, %SYSTEMWEB%.WebLeftBarWebsList, %SYSTEMWEB%.WebTopBarExample, and %SYSTEMWEB%.WebBottomBarExample.

---+++ Installation
<div class="foswikiNotification">
*Upgrade notice for Foswiki 1.0 users*

Add =pattern01x00= to your skin path, like this:
<pre class="tml">
   * <nop>Set SKIN = pattern01x00,pattern
</pre>
</div>

*Note:* You do not need to install anything on the browser to use this skin. The following instructions are for the administrator who installs the skin on the server where Foswiki is running.

*Note 2:* !PatternSkin is included with Foswiki by default. Use the following instructions only if you are upgrading !PatternSkin.

   * Download the ZIP file from the Skin Home page (see below)
   * Unzip ==%TOPIC%.zip== in your Foswiki installation directory
   * [[%SCRIPTURLPATH{"view"}%/%WEB%/%TOPIC%?skin=pattern][Test if installed]]
   * For skin activation see [[%SYSTEMWEB%.Skins]]

To set pattern skin as default (site wide) skin, use these settings in [[%MAINWEB%.SitePreferences]]:

   * Global skin styles. To change the look of the site, point these variables to custom CSS attachments.
      * Set FOSWIKI_LAYOUT_URL = %PUBURLPATH%/%SYSTEMWEB%/PatternSkinTheme/layout.css
      * Set FOSWIKI_STYLE_URL = %PUBURLPATH%/%SYSTEMWEB%/PatternSkinTheme/style.css
      * Set FOSWIKI_COLORS_URL = %PUBURLPATH%/%SYSTEMWEB%/PatternSkinTheme/colors.css

   * Themes that add upon the global skin styles. Choose from the Theme Browser at PatternSkin.
      * Set PATTERNSKIN_THEME_VARIANT = %PUBURLPATH%/%SYSTEMWEB%/PatternSkinTheme/variant_foswiki_noframe.css
      * Set PATTERNSKIN_COLUMNS = %PUBURLPATH%/%SYSTEMWEB%/PatternSkinTheme/column_left.css

   * The topic that defines the main and meta navigation. See PatternSkinHorizontalNavigationExample. Not defined for default pattern skin.
      * Set PATTERNSKIN_NAVIGATION_TOPIC =

   * Overriding styles that add upon the global and theme styles. Enabled by default but empty to prevent browsers from fetching %<nop>USERLAYOUTURL%-style URLs.
      * Set USERLAYOUTURL =
      * Set USERSTYLEURL =
      * Set USERCOLORSURL =
      * Set WEBHEADERART =
      * Set WEBHEADERBGCOLOR =

---+++ Troubleshooting

If you have set the SKIN setting to =pattern= and you still don't see the layout as on the <a href="%ATTACHURL%/patternskin_screenshot_full.png">screenshot</a>, a few settings in may have been disabled.

Check these [[%SYSTEMWEB%.PreferenceSettings][preference settings]] here:
   * FOSWIKI_LAYOUT_URL = %FOSWIKI_LAYOUT_URL%
   * FOSWIKI_STYLE_URL = %FOSWIKI_STYLE_URL%
   * FOSWIKI_COLORS_URL = %FOSWIKI_COLORS_URL%
   * SKIN = %SKIN%

If =FOSWIKI_LAYOUT_URL= or =FOSWIKI_STYLE_URL= don't give a value or point to non-existing files, check in %SYSTEMWEB%.DefaultPreferences and in %USERSWEB%.SitePreferences that the following preferences do exist and that they are set to on:
<verbatim class="tml">
   * %SYSTEMWEB%.PatternSkin settings:
      * Set FOSWIKI_LAYOUT_URL = %PUBURLPATH%/%SYSTEMWEB%/PatternSkinTheme/layout.css
      * Set FOSWIKI_STYLE_URL = %PUBURLPATH%/%SYSTEMWEB%/PatternSkinTheme/style.css
      * Set FOSWIKI_COLORS_URL = %PUBURLPATH%/%SYSTEMWEB%/PatternSkinTheme/colors.css
</verbatim>

*NOTE:* customization of these values should be done in [[%USERSWEB%.SitePreferences]]

If this still does not work, contact the administrator who installs skins.

For further troubleshooting and feedback, go to http://foswiki.org/Support/%TOPIC%.

---+++ All !PatternSkin topics

   * %SYSTEMWEB%.PatternSkinTheme
   * %SYSTEMWEB%.PatternSkinTheme2009
   * %SYSTEMWEB%.PatternSkinThemeFatWilly
   * %SYSTEMWEB%.PatternSkinCss
   * %SYSTEMWEB%.PatternSkinCssCookbook
   * %SYSTEMWEB%.PatternSkinCssCookbookCenterPage
   * %SYSTEMWEB%.PatternSkinCssCookbookEditTableStyle
   * %SYSTEMWEB%.PatternSkinCssCookbookFonts
   * %SYSTEMWEB%.PatternSkinCssCookbookNoLeftBar
   * %SYSTEMWEB%.PatternSkinCssCookbookNoTopBar
   * %SYSTEMWEB%.PatternSkinCustomization
   * %SYSTEMWEB%.PatternSkinGraphics
   * %SYSTEMWEB%.WebBottomBar (not distributed with Foswiki)
   * %SYSTEMWEB%.WebBottomBarExample
   * %SYSTEMWEB%.WebLeftBar (not distributed with Foswiki)
   * %SYSTEMWEB%.WebLeftBarCookbook
   * %SYSTEMWEB%.WebLeftBarExample
   * %SYSTEMWEB%.WebLeftBarLogin
   * %SYSTEMWEB%.WebLeftBarPersonalTemplate
   * %SYSTEMWEB%.WebLeftBarSearch
   * %SYSTEMWEB%.WebLeftBarWebsList
   * %SYSTEMWEB%.WebTopBar (not distributed with Foswiki)
   * %SYSTEMWEB%.WebTopBarExample

---++ Skin Info

|  Copyright: | &copy; 2004-2013 Arthur Clemens, Foswiki contributors |
|  Screenshot: | <a href="%ATTACHURL%/patternskin_screenshot_full.png"><img src="%ATTACHURL%/patternskin_screenshot.png" style="border:1px solid #eee;" alt="Click for full screen image" width="600" /></a> |
|  Preview: | [[%SCRIPTURL{view}%/%WEB%/%TOPIC%?skin=pattern][Preview with this skin]] |
|  Base Name: | pattern |
|  Version: | v5.4.22 | 
|  Release: | 5.4.22 |
|  History: | <!-- specify latest version first -->&nbsp; |
|  23 Oct 2013: | v.5.4.22: Foswikitask:Item12577: adding support for jquery-ui tooltips |
|  31 Jan 2013: | v.5.4.21: Foswikitask:Item12351: Restore font settings back to 1.1.5 defaults |
|  26 May 2012: | v.5.4.20: !WebCreateNewTopicTemplate functionality moved to core. |
|  06 Apr 2012: | v.5.4.19: Foswiki 1.1.5 release.  Minor documentation updates and changes for consistency. %BR%\
                   Foswikitask:Item11622: Add &lt;div> to revision information.%BR%\
                   Foswikitask:Item11623: Improve linking of user topics for unknown but previously registered users.%BR%\
                   Foswikitask:Item11656: Pattern skin font definitions are too far into the html to work for JQDialogs. |
|  02 Dec 2011: | v.5.4.18: Foswiki 1.1.4 release.  Minor changes for consistency |
|  02 Oct 2011: | v.5.4.17: Update javascript for attachment counting. |
|  26 Aug 2011: | v.5.4.15, v.5.4.16: Additional support for running Pattern Skin on Foswiki 1.0.x release. |
|  28 May 2011: | v.5.4.14: Fixed search results on Foswiki 1.0.x versions. |
|  29 Apr 2011: | v.5.4.13: Added no-column CSS for Fatwilly theme. |
|  12 Mar 2011: | v.5.4.12: Visual fixes for Fatwilly theme. |
|  06 Mar 2011: | v.5.4.8: Now that !TablePlugin styles are not automatically loaded to every page, header style needs a small change. |
|  30 Dec 2010: | v.5.4.7: Added custom login.sudo template. |
|  26 Dec 2010: | v.5.4.6: Clean up templates regarding =foswikiFormStep= elements. |
|  18 Dec 2010: | v.5.4.5: Link author names when =NOAUTOLINK= is set to on. |
|  14 Dec 2010: | v.5.4.4: Fix check all / uncheck all checkboxes on rename and delete topic pages. |
|  12 Dec 2010: | v.5.4.3: Fix trimming and stripping spaces in web topic creator javascript. |
|  09 Nov 2010: | v.5.4.2: Remove redundant files from repository. v.5.4.1: Revert usage of =$<nop>percent= back to =$<nop>percnt= |
|  19 Aug 2010: | v.5.4 - Version for Foswiki 1.1. |
|  31 Jul 2010: | v.5.3.1 - Documentation updates |
|  27 May 2010: | v.5.3 - Added "flexible width" column styles. |
|  05 Apr 2010: | v.5.2 - Visual update. |
|  04 Apr 2010: | v.5.1 - Added Foswiki site skin as theme, including horizontal navigation topic; see PatternSkinHorizontalNavigationExample. |
|  04 Apr 2010: | v.5.0 - Changed themes from single css file to file collections to preserve older appearance and to provide bigger restyling within a theme. |
|  12 Mar 2010: | v.4.0.9 - Fixes printing in Firefox 3.6. |
|  23 Feb 2010: | v.4.0.8 - Signature format can be set in preference =SIGNATUREFORMAT=. |
|  17 Jan 2010: | v.4.0.7 - Repeat search phrase in search box. Version for Foswiki 1.0.9 |
|  07 Dec 2009: | v.4.0.6 - Remove spurious newline from attachagain template. Add support for new option to work around IE8 bug with slow/erratic textareas. Fix printing in Safari (thanks Foswiki:Main.MichaelMoss). Remove bogus info on setting view template on topic creation (thanks Foswiki:Main.MartinKaufmann). Make action buttons easier to skin. Fix textareabuttons not displayed when NOWYSIWYG=1. |
|  29 Sep 2009: | v.4.0.5 - Fixed broken link in !PatternSkinCustomization. Fix code/pre white-space styling. Make behaviour javascript work with IE8. Add clear:both to the css for the .foswikiContentFooter - that way it _could_ be over-ridden by a subskin. Made links in headers should look like links. |
|  07 Sep 2009: | v.4.0.4 - Consolidated versions in trunk and release branch. Version for Foswiki 1.0.7. |
|  26 Jul 2009: | v.4.0.3 - Fixes a couple of minor template/css bugs. |
|  18 Jan 2009: | v.4.0.2 - Fix printing with theme =theme_foswiki= and =column_right=. |
|  17 Jan 2009: | v.4.0.1 - Fix reading of WEBHEADERART variable. |
|  30 Nov 2008: | v.4.0.0 - Foswiki 1.0.0 RELEASE VERSION |
|  03 Aug 2008: | v.3.0.1 - TWiki 4.2.1 (Edinburgh) RELEASE VERSION |
|  13 Jul 2007: | v.3.0.0 - TWiki 4.2.0 (Edinburgh) RELEASE VERSION |
|  15 Jan 2006: | v.2.0.6 - TWiki 4.1.0 (Edinburgh) RELEASE VERSION |
|  26 Sep 2006: | v.2.0.5 - Fixed form background colors |
|  22 Jul 2006: | v.2.0.4 - Refactored info in colors.css; fixed textarea color |
|  26 Jun 2006: | v.2.0.3 - TWiki 4.0.3 (Dakar) RELEASE VERSION |
|  31 Jan 2006: | v.2.0.0 - TWiki 4.0.0 (Dakar) RELEASE VERSION |
|  28 Aug 2004: | v.1.0.9 - TWiki 3.0 (Cairo) RELEASE VERSION |
|  08 Aug 2004: | Initial version (v1.0.0) |
|  Dependencies: | Foswiki:Extensions/TwistyPlugin (automatically provided with Foswiki) |
|  Skin Home: | http://foswiki.org/Extensions/%TOPIC% |
|  Support: | http://foswiki.org/Support/%TOPIC% | %STOPINCLUDE%

---++ Feedback

Leave remarks, suggestions and other feedback in http://foswiki.org/Support/%TOPIC%.
<!-- %JQREQUIRE{"chili"}% -->
This topic: System > Skins > PatternSkin
Topic revision: 26 Aug 2011, ProjectContributor (raw view)
Copyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback