 |  |
 |  |  |  |
 | Always set the default template on your page; it defines all tags for you.
The markup used on the site is an ad-hoc cook-up vaguely similar to XHTML,
but without most of its many attributes. On some dynamic pages we also have a
bit of RXML spliced in, but most of those things have been hidden away in the
site XSLT templates responsible for converting the markup to HTML. Try not to
mess with anything that isn't documented on this page unless you really know
your way around RXML, the sites cache setup and SiteBuilder. Sticking
to the basics and using static content is both nicer on the server, and mostly
also what the user would expect.
|
 |  |  |  |
 | Encase your entire page with a <column
charwidth="60">...</column> tag if you want a single column
layout. For a twin column layout, put two column tags after one another and
use a charwidth of 40 for both.
|
 |  |  |  |
 | <p>...</p> tags surround all paragraphs. Losing
paragraph tags and putting text just inside the column ends in confusion and
brokenness.
|
 |  |  |  |
 |  | <p><ol>...</ol></p> encapsulates an
unordered list, and |  | <li>...</li> is used for each of its elements.
The list item tag here works like paragraph tags do on the top level, but
don't try making lists inside lists; it won't work. If you wanted ordered
lists instead of bullet lists, either use common paragraph tags and start
them with a bolded number, or use the same kludge with unordered lists.
To break up a list item in multiple paragraphs, put two
<br /> tags where you want the break. |
|
 | | |  |
 |  |  |  |
 | There are three different levels of headlines but be sparing and use them
consistently in accordance with the guidelines outlined here. Try not to stack
headlines onto eachother without content in-between; it looks plain ugly. The
special case where you have a page title immediately followed by an h1 sub
title might work but make sure that it does before committing - ensure that
the page ends up the way you intended it to look; what you think is not
always what you get.
|
 |  | Page titles are specified in the file title metadata entry.
For further usage details and conventions about that, see the section on file
and directory titles in the Structure page. |  | <h1>...</h1> are the headlines used for the
primary sections when you have two levels of in-page headlines on a page, or
when you want bigger headlines (like the root page). The template will style
these in lowercase (to follow the site graphic profile), so don't tear your
hair trying to figure out what is wrong; nothing is. |  | <h2>...</h2> are the common headlines most
widely used on the site. The Headlines headline above
is one, for instance.
Both h1 and h2 can have an optional attribute "name", which will make an
anchor on the page you can link to. The Headlines
headline above has one that reads name="headlines", so we can link to
it with an <a href="#headlines"> tag. |
|
 |  |  |  |
 | Within paragraph or list item tags, basic HTML like  | <b>...</b> for bold, |  | <i>...</i> for italics, |  | <img src="..." /> for images and |  | <a href="...">...</a> for links work
just as they do in common HTML. |
|
 | | |  |