Difference: NatSkinConfiguration (1 vs. 4)

Revision 4
19 Nov 2013 - Main.AdminUser
Line: 1 to 1
 
META TOPICPARENT name="NatSkin"

NatSkinConfiguration

Revision 3
19 Nov 2013 - Main.AdminUser
Line: 1 to 1
 
META TOPICPARENT name="NatSkin"

NatSkinConfiguration

On this page:

Theme configuration

Changed:
<
<		 The different NatSkin styles (themes) are controlled using preference
>
>

The different NatSkin styles are controlled using preference
  variables and can be set
Added:
>
>
 
Changed:
<
<		 Use the NatSkinStyleBrowser to preview the known styles and settings. Note,
>
>		 Use the NatSkinStyleBrowser to preview the known styles and settings. Note
  that the selection made there will only last for the current session. You need to add the respective preference variables to your home topic or the WebPreferences or the SitePreferences to make the selection
Line: 20 to 22
  This is the list of variables to configure the skin style:

Name
(url param) 		Values Description Default
Changed:
<
<
SKINSTYLE (style) %KNOWNSTYLES% select a predefined style Clean
| STYLEVARIATION (stylevariation) | %KNOWNVARIATIONS%
>
>
NATSKIN_STYLE (style) %KNOWNSTYLES% select a predefined style jazzynote
| NATSKIN_VARIATION (skinvariation) | %KNOWNVARIATIONS%
 
select a style variation none
Changed:
<
<
STYLEBORDER (styleborder) on, off, thin change the border decoration; thin enables a blog-like page layout off
STYLEBUTTONS (stylebuttons) on, off switch on/of the tab buttons above the topic area off
STYLESIDEBAR (stylesidebar) left, right, both, off configure where the sidebar is to be displayed left
>
>
NATSKIN_LAYOUT (skinlayout) fixed, fluid, bordered select a page layout fixed
NATSKIN_MENU (skinmenu) on, off switch on/of the horizontal menu above the topic area on
NATSKIN_SIDEBAR (skinsidebar) left, right, both, off configure where to display the sidebar right
 

There are a couple of special url parameters:
  • togglesidebar: disable the sidebar for this request only.
Deleted:
<
<
  • style=off: switch off any styles (simulating a non-css browser)
 
  • style=reset: switch back to the user and server settings by reverting any session preferences
Deleted:
<
<
  • switchstyle=next/prev: switch to the next/previous known style
  • switchvariation=next/prev: switch to the next/previous known style variation

Example: To emulate the Kubrick style on the old BinaryBonsai (not the new K2 style) use 
  * Set SKINSTYLE = Kubrick
  * Set STYLEBORDER = thin
  * Set STYLEBUTTONS = on
  * Set STYLESIDEBAR = right
  * Set STYLEVARIATION = none
  * Set STYLESEARCHBOX = pos1

There are some constraints build into the NatSkin templates that try guarantee a pleasant appearance when combining the different skin states:
  • If the styleborder is "thin" the sidebar will be disabled for the edit, manage, rdiff, natsearch, changes and search topic actions.
  • The web buttons will alternate with the sidebar so that they will not be displayed on the same side.
  • If the web buttons are enabled the default SiteSideBar will disable the redundant navigation to other webs.

Defining new Themes

The NatSkin can be themed using cascading styles attached to the System.NatSkin or any other topic defined in the STYLEPATH preference variable. This variable is a list of topics that are consulted for css attachments. The default value is 
  * Set STYLEPATH = %SYSTEMWEB%.NatSkin

Styles are collected in the order specified. This allows to insert style contributions that are not part of the NatSkin. For example given you uploaded NatSkin css definitions to a topic Main.NatSkinThemesContrib you can activate them by setting the STYLEPATH to
 
Added:
>
>		 Example:
 
Changed:
<
<		 * Set STYLEPATH = NatSkinThemesContrib?, NatSkin
>
>		 * Set NATSKIN_STYLE = jazzynote * Set NATSKIN_LAYOUT = fixed * Set NATSKIN_MENU = on * Set NATSKIN_SIDEBAR = right * Set NATSKIN_VARIATAION = red
 
Changed:
<
<		 Css files must obey the following naming scheme to be recognized
  • <name>Style.css: basic style definitions for style <name>
  • <name>Buttons.css: WebButton definitions for style <name>
  • <name>Border.css: definitions for style <name> displayed using STYLEBORDER = on
  • <name>Thin.css: definitions for style <name> displayed using STYLEBORDER = thin
  • <name>Thin.css: definitions for style <name> displayed using STYLEBORDER = thin
  • <name>Variation.css: style variations that can be applied to any base style; this can be used to vary a base style, e.g. to add header art or change some fonts and colours

Email Obfuscation

The standard Foswiki engine tries to obfuscate email addresses by adding a phrase to the email url (like NOSPAM) to fool collecting web crawlers. But that is not adequate enough today as crawlers are aware of that. The solution to that is to remove every trace of a pattern that could be an email address from the html source code and regenerate them using javascript. Most likely, web crawlers will only parse the html and don't run a javascript interpreter beforehand. Nevertheless the obfuscation feature can be switched on and off by adding the OBFUSCATEEMAIL variable to your DefaultPreferences or SitePreferences like 

  * Set OBFUSCATEEMAIL = on

Misc preference variables

>
>

Preference variables

  There is a set of variables that can be used influence how NatSkin behaves or renders pages.

Name Description
Added:
>
>
CONTENT_LANGUAGE the language of the current topic; this is used by search engines like SolrPlugin to run different stemming procedures while indexing the topic (defaults to auto-detect)
 
HTMLTITLE the <title>... of the html page; if no HTMLTITLE is defined the NatSkin will check for some formfields (Headlines, TopicDescription) to be used as a html page title and back off to the topic name
Added:
>
>
HTMLTITLESEP the separator of items in the HTMLTITLE (defaults to a dash ('-'))
 
METAAUTHOR the value of this variable will be used to construct <meta name="author" ... /> in the html head
METADESCRIPTION the value of this variable will be used to construct <meta name="description" ... /> in the html head
METAKEYWORDS the value of this variable will be used to construct <meta name="keywords" ... /> in the html head
Changed:
<
<
WHITEBOARD possible values: on, off; if WHITEBOARD is set to only the topic form will be edited when clicking on "Edit"; note, that the textarea is still accessible and not hidden completely; this is flag is only there for convenience
>
>
TOPICTITLE the title to be used displaying a WikiWord link to the current page; this is set automatically using NatEditPlugin
 

Hint: Assign default meta data per web by adding
Added:
>
>
  
  * Set DEFAULT_METAKEYWORDS = keyword1, keyword2, keyword3
  * Set METAKEYWORDS = %DEFAULT_METAKEYWORDS%
Line: 124 to 78
  other meta data preferences.
Deleted:
<
<		 -- Foswiki:Main.MichaelDaum - 25 Aug 2006
 
META TOPICMOVED by="MichaelDaum" date="1156530555" from="%25SYSTEMWEB%25.NatSkinCustomization" to="%25SYSTEMWEB%25.NatSkinConfiguration"
Revision 2
12 Oct 2010 - Main.AdminUser
Line: 1 to 1
 
META TOPICPARENT name="NatSkin"

NatSkinConfiguration

Line: 126 to 126
 

-- Foswiki:Main.MichaelDaum - 25 Aug 2006
Changed:
<
<
META TOPICMOVED by="MichaelDaum" date="1156530555" from="System.NatSkinCustomization" to="System.NatSkinConfiguration"
>
>
META TOPICMOVED by="MichaelDaum" date="1156530555" from="%25SYSTEMWEB%25.NatSkinCustomization" to="%25SYSTEMWEB%25.NatSkinConfiguration"
View topic | History: r4 < r3 < r2 < r1 | More topic actions...
 
This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback