Experienced skin creators: What were the things which caused you the most grief? How did you get around them? Or if you are still blocked, what doesn't work? |
Skin Developer FAQ
Why TMPL:INCLUDE
does not "take"
The twiki templating system uses an inheritance model. There needs to be a file named
twiki.askin.tmpl
which defines the constructs to be used in common across the template files. The
%TMPL:INCLUDE{"twiki"}%
statement actually looks for
twiki.askin.tmpl
, and only goes to
twiki.tmpl
if that file is not found.
adapted from TemplateIncludesInAmbarSkin
--
MattWilkie - 05 Aug 2003
Make sure your
edit
link is generated via EDITTOPIC TWiki variable. Most likely it is in your
view.skinname.tmpl
file. If you use script name instead, you can get strange caching errors. See
BugInHttpEquiv for a horror story.
--
PeterMasiar - 01 Jul 2003
If you
really need to build your own edit link, you need to signify that the resulting page isn't cacheable to any cache that might exist. The trivial way of doing this is to add a question mark into the topic. An even better way is to make the URL change eg:
Which is generated from this:
-
%SCRIPTURL%/edit%SCRIPTSUFFIX%/%WEB%/%TOPIC%?%GMTIME{"$year$mo$day$hours$minutes$seconds"}%
The sort of thing can be necessary if you want to apply a specific CSS class just to your edit links, also it's useful to have this control in
DistributedTWiki systems. Note however that the "edit" text will not be correct for all views - specifically the "create" link will say edit instead.
--
MichaelSparks - 01 Jul 2003
Generating Edit links that include the time of day fixes the
RefreshEditPage bug - as long as you use either
%EDITTOPIC%
or the equivalent your skin will work fine.
--
RichardDonkin - 01 Jul 2003
How do I enable international character support for my skin?
See
InternationalisingYourSkin.
--
RichardDonkin - 01 Jul 2003
How to set font size?
You can
check how fonts (and font families) look in different sizes, and you
have to read this and this about how to set font sizes in flexible way which works accross (non-ancient) browsers.
also see FontSize at the css-discuss wiki
--
PeterMasiar - 12 Sep 2003 (Thank you
ColasNahaboo for the links)
How to set a broadcast message visible to all users?
Add a
%BROADCASTMESSAGE%
to the top of your view template and define the message in your
TWikiPreferences topic. See details in
BroadcastMessageHandling.
It is advisory to retrofit the
existing skins. The default
view.tmpl
template has the
%BROADCASTMESSAGE%
variable, new skins based on it will inherit it. In addition, it is documented in
TWikiSkins.
--
PeterThoeny - 12 Oct 2003
What about using CSS?
CssResources is the best place to start.
Why is my skin not listed in the Skin Browser?
The
TWiki.TWikiSkinBrowser is a new feature of the
TWikiRelease01Sep2004. You need to change your skin topic so that the skin browser can pick up your skin. For instructions see
Codev.TWikiSkinBrowser.
Only installed skins are listed. That is, on TWiki.org you will see only a few skins in the
TWiki.TWikiSkinBrowser.
--
PeterThoeny - 26 Jul 2004