Difference: NatSkinConfiguration (r4 vs. r3)

NatSkinConfiguration

Theme configuration

The different NatSkin styles are controlled using preference variables and can be set

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 persistent.

This is the list of variables to configure the skin style:

Name
(url param)
ValuesDescriptionDefault
NATSKIN_STYLE (style) %KNOWNSTYLES% select a predefined style jazzynote
NATSKIN_VARIATION (skinvariation) %KNOWNVARIATIONS% select a style variation none
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.
  • style=reset: switch back to the user and server settings by reverting any session preferences

Example:

  * Set NATSKIN_STYLE = jazzynote
  * Set NATSKIN_LAYOUT = fixed
  * Set NATSKIN_MENU = on
  * Set NATSKIN_SIDEBAR = right
  * Set NATSKIN_VARIATAION = red

Preference variables

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

NameDescription
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 ... of the html page; if no HTMLTITLE is defined the <a href="/foswiki/bin/view/System/NatSkin">NatSkin</a> will check for some formfields (Headlines, TopicDescription) to be used as a html page title and back off to the topic name </td></tr><tr class="foswikiTableEven foswikiTableRowdataBgSorted0 foswikiTableRowdataBg0"><td class="foswikiTableCol0 foswikiFirstCol"><code>HTMLTITLESEP</code></td><td class="foswikiTableCol1 foswikiLastCol"> the separator of items in the HTMLTITLE (defaults to a dash ('-')) </td></tr><tr class="foswikiTableOdd foswikiTableRowdataBgSorted1 foswikiTableRowdataBg1"><td class="foswikiTableCol0 foswikiFirstCol"><code>METAAUTHOR</code></td><td class="foswikiTableCol1 foswikiLastCol"> the value of this variable will be used to construct <meta name="author" ... /> in the html head </td></tr><tr class="foswikiTableEven foswikiTableRowdataBgSorted0 foswikiTableRowdataBg0"><td class="foswikiTableCol0 foswikiFirstCol"><code>METADESCRIPTION</code></td><td class="foswikiTableCol1 foswikiLastCol"> the value of this variable will be used to construct <meta name="description" ... /> in the html head </td></tr><tr class="foswikiTableOdd foswikiTableRowdataBgSorted1 foswikiTableRowdataBg1"><td class="foswikiTableCol0 foswikiFirstCol"><code>METAKEYWORDS</code></td><td class="foswikiTableCol1 foswikiLastCol"> the value of this variable will be used to construct <meta name="keywords" ... /> in the html head </td></tr><tr class="foswikiTableEven foswikiTableRowdataBgSorted0 foswikiTableRowdataBg0"><td class="foswikiTableCol0 foswikiFirstCol foswikiLast"><code>TOPICTITLE</code></td><td class="foswikiTableCol1 foswikiLastCol foswikiLast"> the title to be used displaying a WikiWord link to the current page; this is set automatically using NatEditPlugin </td></tr></tbody></table> <p> Hint: Assign default meta data <em>per web</em> by adding </p> <pre> * Set DEFAULT_METAKEYWORDS = keyword1, keyword2, keyword3 * Set METAKEYWORDS = %DEFAULT_METAKEYWORDS% </pre> <p> to the <a href="/foswiki/bin/view/System/WebPreferences">WebPreferences</a> and add extra keyword data <em>per topic</em> like this </p> <pre> * Set METAKEYWORDS = %DEFAULT_METAKEYWORDS%, keyword4, keyword5, keyword6 </pre> <p> Caution: don't add meta data to your <a href="/foswiki/bin/view/Main/WikiGuest">home topic</a> because it will override all other meta data preferences. </p> </div> <p /> <div class="foswikiFormSteps"><a name="topic-actions"></a><div class="patternTopicActions foswikiFormStep"><span class="patternActionButtons"><span><a href='https://nkwiki.de/foswiki/bin/view/System/NatSkinConfiguration' rel='nofollow' title='View topic' accesskey='v'><span class='foswikiAccessKey'>V</span>iew topic</a></span><span class='foswikiSeparator'> | </span>View difference <span><a href='/foswiki/bin/compare/System/NatSkinConfiguration?rev1=3&rev2=4&render=sidebyside&context=&skin=' rel='nofollow' title='Side by side' accesskey='s'><span class='foswikiAccessKey'>s</span>ide by side</a></span><span class='foswikiSeparator'> | </span><span><span class="foswikiRequiresChangePermission"><a href='/foswiki/bin/oops/System/NatSkinConfiguration?template=oopshistory' rel='nofollow' title='View total topic history' accesskey='h'><span class='foswikiAccessKey'>H</span>istory</a></span>: <a href="/foswiki/bin/view/System/NatSkinConfiguration?rev=4">r4</a> < <a href="/foswiki/bin/view/System/NatSkinConfiguration?rev=3">r3</a> <a href="/foswiki/bin/compare/System/NatSkinConfiguration?rev1=3&rev2=2&render=interweave"><</a> <a href="/foswiki/bin/view/System/NatSkinConfiguration?rev=2">r2</a> <a href="/foswiki/bin/compare/System/NatSkinConfiguration?rev1=2&rev2=1&render=interweave"><</a> <a href="/foswiki/bin/view/System/NatSkinConfiguration?rev=1">r1</a></span><span class='foswikiSeparator'> | </span><span><a href='/foswiki/bin/view/System/NatSkinConfiguration?template=more&maxrev=4&currrev=3' rel='nofollow' title='Delete or rename this topic; set parent topic; view and compare revisions' accesskey='m'><span class='foswikiAccessKey'>M</span>ore topic actions</a></span></span></div></div></div> </div> </div> </div> <div class="clear"> </div> </div><div id="patternBottomBar"><div id="patternBottomBarContents"><div id="patternWebBottomBar"><span class="foswikiRight"> <a href="http://foswiki.org/"><img src="/foswiki/pub/System/ProjectLogos/foswiki-badge.gif" alt="This site is powered by Foswiki" title="This site is powered by Foswiki" border="0" /></a></span>Copyright © by the contributing authors. All material on this site is the property of the contributing authors. <br /> Ideas, requests, problems regarding Foswiki? <a href='mailto:wiki@historische-projekte.de?subject=Foswiki%20Feedback%20on%20System.NatSkinConfiguration'>Send feedback</a> </div></div></div> </div> </div> </div> </div></body></html>