Foswiki Notes

Page Titles

It is useful for the page title to appear in the HTML header. Many web browsers will display it in the window title and in the icon for minimised windows. The default is the WikiName of the page, but you can supply a more human-readable title like this:

<!--
   * Set TITLE = Foswiki Notes
-->

Shopfront pages

Most of the more public-facing pages have a graphic title bar and a wide landscape picture below it. These images are controlled by some page settings:

<!--
   * Set TITLE = Welcome
   * Set BANNER = welcome.jpg
   * Set IMAGE = sunsetbeach.jpg
   * Set IMAGETEXT = A good picture from some club member
-->

• TITLE - this is the actual text. It is used by browsers that are not displaying graphics.
• BANNER - this is the name of the file containing the page title image. You need to attach the file to the page.
• IMAGE - this is the name of the file containing the picture to display below the title. You need to attach the file to the page.
• IMAGETEXT - This is the text that appears as a tooltip when the mouse cursor hovers over the image.

The banner image must be 800x200 pixels. It has a background colour of #505050 and the leftmost 10 pixels are additionally darkened with a gradient from 50% black on the left to transparent at 10 pixels from the left. The blank image is attached to this page for reference. I use Image Magick with a script to add the text so that it is always in exactly the same position:

#!/bin/sh
#
# Make a heading image for the MCC website
#
# Source image is in header.png - it is blank grey with a dark left-edge
# Text goes at 62,115 from top left 

TEXT="$@"
convert -fill white -font DejaVu-Sans-Book -draw "scale 2,2 text 31,57 '$TEXT'" blank-header.jpg new.jpg

Images

The main picture must be 800x350 pixels. It also has the left hand side darkened by the same amount as the banner text image.

The same settings and layout can also be used in other parts of the site (TITLE is particularly useful, as it sets the browser's titlebar and tab text).

-- AndrewFindlay - 05 Sep 2009