Menu
▾
▴
Re: [TWiki-Dev] [SVN] PeterThoeny r12155 - twiki/branches/MAIN/data/TWiki
|
From: Arthur C. <acl...@xs...> - 2006-12-04 20:44:05
|
In my opinion TWikiSkins provides an overview of general skin topics,
such as skin variables and default elements like the attachment table.
The Jump box paragraph is a sudden step into detail, and I would move
it to a practical "How to" topic with different kinds of elements/
building blocks that may be useful to the skin developer.
TWikiSkinsCookbook.
Arthur
On Dec 4, 2006, at 9:25 PM, Peter Thoeny wrote:
> Arthur,
>
> The reason I put it in there originally was for skin
> authors who want to add a navigation box in their skin.
> What better place can you suggest?
>
> Regards,
> Peter
>
>
> Arthur Clemens wrote:
>> The information about the GoBox does not belong to this topic, and
>> offers skin writers no help.
>>
>> Arthur
>>
>>
>>
>> On Dec 4, 2006, at 8:31 PM, de...@de... wrote:
>>
>>> Author: PeterThoeny
>>> Date: 2006-12-04 13:31:38 -0600 (Mon, 04 Dec 2006)
>>> New Revision: 12155
>>>
>>> Modified:
>>> twiki/branches/MAIN/data/TWiki/TWikiSkins.txt
>>> Log:
>>> Item2553: Fix doc to style guidelines; restored go-box with
>>> navigation
>>>
>>> Modified: twiki/branches/MAIN/data/TWiki/TWikiSkins.txt
>>> ===================================================================
>>> --- twiki/branches/MAIN/data/TWiki/TWikiSkins.txt 2006-12-04
>>> 19:25:45 UTC (rev 12154)
>>> +++ twiki/branches/MAIN/data/TWiki/TWikiSkins.txt 2006-12-04
>>> 19:31:38 UTC (rev 12155)
>>> @@ -1,9 +1,9 @@
>>> -%META:TOPICINFO{author="TWikiContributor" date="1154970081"
>>> format="1.0" version="$Rev$"}%
>>> +%META:TOPICINFO{author="TWikiContributor" date="1165260368"
>>> format="1.0" version="$Rev$"}%
>>> %TOC%
>>> %STARTINCLUDE%
>>> ---# TWiki Skins
>>>
>>> -*Skins overlay regular templates to give different looks and feels
>>> to TWiki screens.*
>>> +_Skins overlay regular templates to give different looks and feels
>>> to TWiki screens._
>>>
>>> ---++ Overview
>>>
>>> @@ -13,7 +13,7 @@
>>>
>>> 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.
>>>
>>> -*%T% Tip:* TWiki:TWiki.TWikiSkinsSupplement on TWiki.org has
>>> supplemental documentation on TWiki Skins.
>>> +__%T% Tip:__ TWiki:TWiki.TWikiSkinsSupplement on TWiki.org has
>>> supplemental documentation on TWiki Skins.
>>>
>>> ---++ Changing the default TWiki skin
>>>
>>> @@ -33,7 +33,7 @@
>>>
>>> The standard TWiki skins show the logo in the =%<nop>WEBCOPYRIGHT%
>>> = variable.
>>>
>>> -*%X% Note:* Two skin names have _reserved_ meanings; =text= skin,
>>> and skin names starting with =rss= have [[#HardCodedSkins][hard-
>>> coded meanings]].
>>> +__%X% Note:__ Two skin names have _reserved_ meanings; =text=
>>> skin, and skin names starting with =rss= have [[#HardCodedSkins]
>>> [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.
>>>
>>> @@ -80,7 +80,7 @@
>>>
>>> =twiki.tmpl= is a master template conventionally used by other
>>> templates, but not used directly by code.
>>>
>>> -*%X% 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.
>>> +__%X% 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.
>>>
>>> ---++ Variables in Skins
>>>
>>> @@ -111,7 +111,38 @@
>>> | =%<nop>REVINFO%= | Revision info, ex: =r1.6 - 24 Dec 2002 -
>>> 08:12 GMT - %WIKIUSERNAME%= |
>>> | =%<nop>WEBCOPYRIGHT%= | Copyright notice, defined in the
>>> WebPreferences |
>>> | =%<nop>BROADCASTMESSAGE%= | Broadcast message at the beginning
>>> of your view template, can be used to alert users of scheduled
>>> downtimes; can be set in %LOCALSITEPREFS% |
>>> -
>>> +
>>> +#GoBox
>>> +---++ The "Go" Box and Navigation Box
>>> +
>>> +The default skins include a [[GoBox]["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 <nop>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 <nop>JavaScript enabled for
>>> this to work:
>>> +
>>> +<form name="sample" action="%SCRIPTURLPATH{"view"}%/%WEB%/%TOPIC%">
>>> +<table border="0" cellpadding="5" bgcolor="#DDDDDD"><tr><td
>>> colspan="2">
>>> +Bare bones header, for demo only
>>> +</td></tr><tr><td>
>>> +Navigate:
>>> +</td><td>
>>> +<select name="sel" onchange="this.form.topic.value=this.options
>>> [this.selectedIndex].value; this.form.submit()">
>>> +<option selected="selected" value="">...</option>
>>> +<option value="http://www.twiki.org/">Intranet home</option>
>>> +<option value="%MAINWEB%.%WIKIUSERSTOPIC%">Employee index</option>
>>> +<option value="%MAINWEB%.%HOMETOPIC%">%MAINWEB% web</option>
>>> +<option value="%TWIKIWEB%.%HOMETOPIC%">%TWIKIWEB% web</option>
>>> +<option value="http://www.google.com/">Google</option>
>>> +<option value="http://www.yahoo.com/">Yahoo!</option>
>>> +</select>
>>> +</td></tr><tr><td>
>>> +Jump:
>>> +</td><td>
>>> +<input type="text" name="topic" size="16" />
>>> +</td></tr></table>
>>> +</form>
>>> +
>>> ---++ 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 =styles.pattern.tmpl=.
>>>
>>>
>>> --------------------------------------------------------------------
>>> --
>>> ---
>>> Take Surveys. Earn Cash. Influence the Future of IT
>>> Join SourceForge.net's Techsay panel and you'll get the chance to
>>> share your
>>> opinions on IT & business topics through brief surveys - and earn
>>> cash
>>> http://www.techsay.com/default.php?
>>> page=join.php&p=sourceforge&CID=DEVDEV
>>> _______________________________________________
>>> TWiki-Dev mailing list
>>> TWi...@li...
>>> https://lists.sourceforge.net/lists/listinfo/twiki-dev
>>>
>>
>>
>> ---------------------------------------------------------------------
>> ----
>> Take Surveys. Earn Cash. Influence the Future of IT
>> Join SourceForge.net's Techsay panel and you'll get the chance to
>> share your
>> opinions on IT & business topics through brief surveys - and earn
>> cash
>> http://www.techsay.com/default.php?
>> page=join.php&p=sourceforge&CID=DEVDEV
>> _______________________________________________
>> TWiki-Dev mailing list
>> TWi...@li...
>> https://lists.sourceforge.net/lists/listinfo/twiki-dev
>>
>
> --
> * Peter Thoeny Peter@StructuredWikis.com
> * http://StructuredWikis.com - bringing wikis to the workplace
> * http://TWiki.org - is your team already TWiki enabled?
> * Knowledge cannot be managed, it can be discovered and shared
> * This e-mail is: (_) private (x) ask first (_) public
>
> ----------------------------------------------------------------------
> ---
> Take Surveys. Earn Cash. Influence the Future of IT
> Join SourceForge.net's Techsay panel and you'll get the chance to
> share your
> opinions on IT & business topics through brief surveys - and earn cash
> http://www.techsay.com/default.php?
> page=join.php&p=sourceforge&CID=DEVDEV
> _______________________________________________
> TWiki-Dev mailing list
> TWi...@li...
> https://lists.sourceforge.net/lists/listinfo/twiki-dev
>
|