X-Git-Url: https://git.openafs.org/?p=openafs-wiki.git;a=blobdiff_plain;f=TWiki%2FTWikiSkins.mdwn;h=da95a701ba860501000ab59052735b3c666e60c2;hp=cf3d6d06c1209485eed8c154e1b7e911f3ef4254;hb=9b36eb5f332f7827a007cfb27b8de8b7040b5436;hpb=6ed22979a0401938bfd0110220ce128056fb8d21
diff --git a/TWiki/TWikiSkins.mdwn b/TWiki/TWikiSkins.mdwn
index cf3d6d0..da95a70 100644
--- a/TWiki/TWikiSkins.mdwn
+++ b/TWiki/TWikiSkins.mdwn
@@ -8,7 +8,9 @@
Using Cascading Style Sheets
+ Attachment Tables
Packaging and Publishing Skins
+ Browsing Installed Skins
Activating Skins
@@ -143,7 +145,7 @@ Here is an example form that has a select box and the "Go" box for illustration
## Using Cascading Style Sheets
-The regular templates files currently do not use style sheets. Many skin developers choose to use them, it helps in separating style from content.
+Although work is underway at TWiki:Codev.CssClassNames, the regular templates files currently do not use style sheets. Many skin developers, however, choose to use them; it helps in separating style from content.
Example: To use a style sheet for the broadcast message, add this to `view.myskin.tmpl`:
@@ -159,10 +161,119 @@ Then add a div tag to the `%BROADCASTMESSAGE%` variable located after the `#Page
%BROADCASTMESSAGE%
+## Attachment Tables
+
+Controlling the look and feel of attachment tables is a little bit more complex than for the rest of a skin. By default the attachment table is a standard TWiki table, and the look is controlled in the same ay as other tables. In a very few cases you may want to change the _content_ of the table as well.
+
+The format of standard attachment tables is defined through the use of special _TWiki template macros_ which by default are defined in the `templates/twiki.tmpl` template using the `%TMPL:DEF` macro syntax described in [[TWikiTemplates]]. These macros are:
+
+
+
+ Macro |
+ Description |
+
+
+ ATTACH:files:header |
+ Standard title bar |
+
+
+ ATTACH:files:row |
+ Standard row |
+
+
+ ATTACH:files:footer |
+ Footer for all screens |
+
+
+ ATTACH:files:header:A |
+ Title bar for upload screens, with attributes column |
+
+
+ ATTACH:files:row:A |
+ Row for upload screen |
+
+
+ ATTACH:files:footer:A |
+ Footer for all screens |
+
+
+
+The format of tables of file versions in the Upload screen are also formattable, using the macros:
+
+
+
+ Macro |
+ Description |
+
+
+ ATTACH:versions:header |
+ Header for versions table on upload screen |
+
+
+ ATTACH:versions:row |
+ Row format for versions table on upload screen |
+
+
+ ATTACH:versions:footer |
+ Footer for versions table on upload screen |
+
+
+
+The `ATTACH:row` macros are expanded for each file in the attachment table, using the following special tags:
+
+
+
+ Tag |
+ Description |
+
+
+ %A_URL% |
+ URL that will recover the file |
+
+
+ %A_REV% |
+ Revision of this file e.g. "1.1" |
+
+
+ %A_ICON% |
+ A file icon suitable for representing the attachment content |
+
+
+ %A_FILE% |
+ The name of the file |
+
+
+ %A_SIZE% |
+ The size of the file |
+
+
+ %A_DATE% |
+ The date the file was uploaded |
+
+
+ %A_USER% |
+ The user who uploaded it |
+
+
+ %A_COMMENT% |
+ The comment they put in when uploading it |
+
+
+ %A_ATTRS% |
+ The attributes of the file as seen on the upload screen e.g "h" for a hidden file |
+
+
+
+Note: it is easy to change the look and feel for an entire site by editing the `twiki.tmpl` template file. However, to simplify upgrading, you should avoid doing this. Instead, write a skin-specific template file e.g. `attach.myskin.tmpl` and use `%TMPL:INCLUDE{attach.myskin.tmpl}%` to include it in each of your skin files. As long as it it included _after_ twiki.tmpl, your macro definitions will override the defaults defined there.
+
## Packaging and Publishing Skins
See TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
+## Browsing Installed Skins
+
+You can try all installed skins in [[TWikiSkinBrowser]].
+
## Activating Skins
A skin can be activated in two ways:
@@ -176,4 +287,4 @@ A skin can be activated in two ways:
The **?skin=name**
URL parameter overrides the SKIN Preference value.
--- [[PeterThoeny]] - 05 Jan 2003
+-- TWiki:Main.PeterThoeny - 25 Jul 2004 %BR% -- TWiki:Main.CrawfordCurrie - 30 Jun 2004 %BR%