01.12.2012 Views

7 Components: the Function Pages - Developers

7 Components: the Function Pages - Developers

7 Components: the Function Pages - Developers

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

FlexibleSkin is based on an HTML table that divides each page into<br />

several areas, as well as a style sheet with which <strong>the</strong> layout of <strong>the</strong> areas<br />

is controlled. All relevant information is stored in TWiki itself.<br />

This means that <strong>the</strong>re is a separate, special topic for each area surrounding<br />

<strong>the</strong> content. They are illustrated in Fig. 16.2:<br />

FlexibleSkin<br />

LeftBar<br />

FlexibleSkinTopBar / FlexibleSkinPrintingHeader<br />

FlexibleSkinTopicHeader<br />

Actual content<br />

FlexibleSkinTopicFooter<br />

FlexibleSkinBottomBar / FlexibleSkinPrintingFooter<br />

FlexibleSkin<br />

RightBar<br />

The Printing pages are relevant for <strong>the</strong> print view. For example, an<br />

edit link would make little sense on a hard copy of a wiki article, and<br />

can thus be left out. The individual special topic areas are integrated<br />

when <strong>the</strong> pages are assembled. This means you have complete artistic<br />

freedom in <strong>the</strong>ir design. The standard version of FlexibleSkin is<br />

basically an imitation of <strong>the</strong> Classic skin, meaning that <strong>the</strong> TopBar<br />

and BottomBar pages and <strong>the</strong> print pages have already been assigned<br />

default values.<br />

You should make it a habit of defining which sections of pages<br />

that are to be integrated into o<strong>the</strong>r topics can and should be included.<br />

In doing this, you will create <strong>the</strong> opportunity to add comments or descriptions<br />

in <strong>the</strong> template outside of <strong>the</strong> respective section. You can<br />

also prevent remarks (such as <strong>the</strong> user stamp when <strong>the</strong> page is generated)<br />

from being displayed by mistake. You can mark <strong>the</strong> source<br />

text to be embedded by inserting %STARTINCLUDE% at <strong>the</strong> beginning<br />

and %STOPINCLUDE% at <strong>the</strong> end.<br />

In addition to <strong>the</strong> respective special topics, <strong>the</strong>re is yet ano<strong>the</strong>r<br />

topic that contains a style sheet: FlexibleSkinStyleSheet. Here, you<br />

can perform general settings that pertain to <strong>the</strong> overall appearance,<br />

or target specific areas. The classes corresponding to <strong>the</strong> special topics<br />

are listed in Tab. 16.2.<br />

Principle<br />

Fig. 16.2<br />

Define Include<br />

area<br />

Style sheet<br />

16.1 Designing <strong>the</strong> Look �<br />

�<br />

�<br />

241

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!