pike.ida.liu.se
Home>Projects>Pike Site

Default template
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.

Content Encapsulation
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.

Paragraphs
<p>...</p> tags surround all paragraphs. Losing paragraph tags and putting text just inside the column ends in confusion and brokenness.

Lists
*<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.


                                                                                
Headlines
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.


Basic HTML
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.