<quickbutton> does a lot of things at once, but basically it's
meaning that if the link points to the page you're on, it will not show a link
(because you're already on the page), and it will optionally display another
image you defined. (the "selected" image) This is especially handy when used in
navigation bars containing links to the major sections of your site.
- off: The default image to display. Required attribute.
- href: The page to link to. If this page is the current page, no link is generated. (why would you — you're already there!) Required attribute.
- on: The image to display when the mouse is on the image.
- selected: The image to display when the link this button is pointing to, is the current page.
- height: Height of the image.
- width: Width of the image.
- alt: Alternate text for the image. Note that this is not a required attribute, but your page won't validate if you don't include it.
Perhaps image width and heights could be automatically figured out
using PIL. Same goes for regular
Here's an example of a quickbutton:
<quickbutton off="g/contact.png" on="g/contact-over.png" href="contact/" selected="g/contact-selected.png" height="60" width="120" alt="Contact Page" />
When this page is not on the contact page, Corbon will generate an image with a link:
When this page is the contact page, Corbon will use the "selected" image and remove the link: