Common Tags

These common tags are very general tags that are used on almost every page. They are split into four groups: sectioning, lists, links and miscellaneous.

The tag definitions can be found in debian/women/tags/common.wml.

Sectioning tags

The <pagetitle> tag is used to create a page title that is displayed on top of the page. The title displayed in the browser window is defined in the .wmlrc file in the directory of a .wml file.

The <section> tag uses the title attribute to produce a heading that separates the new section from the remaining text. Content belonging to the given section should, but does not have to, go into the body of the tag. While the title attribute is technically optional, it doesn't make very much sense to use the tag without it.

Paragraphs should be defined using the <paragraph> tag. Optionally, a title attribute can be specified, in which case a heading is produced that gives a title to this (and following) paragraph(s).

Making lists

Use <list> to create either an ordered or unordered list. By default, the list will be unordered, but the type attribute can be set to ordered to change this default behaviour.

List items are defined via the <item> tag.

<list type="ordered">
    <item>First Item</item>
    <item<Second Item</item>
</list>

Will render as:

  1. First Item
  2. Second Item

Creating links

The <url> tag is used to insert links into documents. The body of the tag contains the text which will be converted into a link, while the href attribute is used to specify the link target.

<url href="http://example.org">
    Example link
</url>

Will render as: Example link.

Miscellaneous

The <example> tag is used to provide examples, as seen above. When using this, you have to bear in mind that whitespace is not collapsed. That means that every space and newline (and every other character, with the exception of HTML special characters and entities) you have inside a <example> tag-pair will be interpreted as-is.

<example>#include <stdio.h>

int main(int argc, char **argv)
{
    printf("Hello, World!\n");
    return 1;
}</example>

Will render as:

#include <stdio.h>

int main(int argc, char **argv)
{
    printf("Hello, World!\n");
    return 1;
}