none
[openafs-wiki.git] / TWiki / TWikiSkins.mdwn
index 94a0a81..cf3d6d0 100644 (file)
@@ -7,6 +7,7 @@
             <li><a href="#The "Go" Box and Navigation Box"> The "Go" Box and Navigation Box</a></li>
           </ul>
         </li>
+        <li><a href="#Using Cascading Style Sheets"> Using Cascading Style Sheets</a></li>
         <li><a href="#Packaging and Publishing Skins"> Packaging and Publishing Skins</a></li>
         <li><a href="#Activating Skins"> Activating Skins</a></li>
       </ul>
@@ -67,11 +68,11 @@ You can use [[template variables|Main/TWikiTemplates#TemplateVariables]], [[TWik
   </tr>
   <tr>
     <td><code>%WEB%</code></td>
-    <td> The name of the current web. <strong><em>Note:</em></strong> It is recommended to URL-encode the variable in form actions with <code>%URLENCODE{"%WEB%"}%</code> for proper handling in an internationalized environment </td>
+    <td> The name of the current web. <strong><em>Note:</em></strong> It is recommended to URL-encode the variable in form actions with <code>%INTURLENCODE{"%WEB%"}%</code> for proper handling in an internationalized environment </td>
   </tr>
   <tr>
     <td><code>%TOPIC%</code></td>
-    <td> The name of the current topic. <strong><em>Note:</em></strong> It is recommended to URL-encode the variable in form actions with <code>%URLENCODE{"%TOPIC%"}%</code> for proper handling in an internationalized environment </td>
+    <td> The name of the current topic. <strong><em>Note:</em></strong> It is recommended to URL-encode the variable in form actions with <code>%INTURLENCODE{"%TOPIC%"}%</code> for proper handling in an internationalized environment </td>
   </tr>
   <tr>
     <td><code>%WEBTOPICLIST%</code></td>
@@ -109,6 +110,10 @@ You can use [[template variables|Main/TWikiTemplates#TemplateVariables]], [[TWik
     <td><code>%WEBCOPYRIGHT%</code></td>
     <td> Copyright notice, defined in the [[Main/WebPreferences]]</td>
   </tr>
+  <tr>
+    <td><code>%BROADCASTMESSAGE%</code></td>
+    <td> Broadcast message at the beginning of your view template, can be used to alert users of scheduled downtimes; is set in [[Main/TWikiPreferences]]</td>
+  </tr>
 </table>
 
 <a name="GoBox"></a>
@@ -136,9 +141,27 @@ Here is an example form that has a select box and the "Go" box for illustration
   </table>
 </form>
 
+## <a name="Using Cascading Style Sheets"></a> 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.
+
+Example: To use a style sheet for the broadcast message, add this to `view.myskin.tmpl`:
+
+    <style type="text/css">
+    .broadcastmessage {
+        background: yellow; display:block;
+        border-style:solid;border-width: 2px;border-color:red;
+    }
+    .broadcastmessage strong {color: red}
+    </style>
+
+Then add a div tag to the `%BROADCASTMESSAGE%` variable located after the `#PageTop` anchor or after the opening form tag:
+
+    <div class="broadcastmessage"> %BROADCASTMESSAGE% </div>
+
 ## <a name="Packaging and Publishing Skins"></a> Packaging and Publishing Skins
 
-See TWiki:Plugins/SkinPackagingHowTo
+See TWiki:Plugins/SkinPackagingHowTo and TWiki:Plugins/SkinDeveloperFAQ
 
 ## <a name="Activating Skins"></a> Activating Skins