Useful XHTML Tags

OpenOffice.org Developer's Guide

IDL Documentation Guidelines

< Previous Section

Next Section >

• File structure
• Element Documentation
• Special Markups
• Special Documentation Tags
• Useful XHTML Tags

< Previous Page

Next Page >

Only a few XHTML tags are required for writing the documentation in idl files. The most important ones are listed in this section.

Paragraph: <p> ... </p>

This tag marks a normal paragraph. Consider that line breaks and empty lines in the idl file do not cause a line break or a paragraph break in the layout version. Explicit paragraph break markups, are necessary.

Do not use <br/> or CR/LF for marking paragraphs. CR and LF are ignored, except within <pre>...</pre> and <listing>...</listing> areas. The <br/> tag is only for rare cases of explicit linebreaks. /** does this and that.   This sentence should start with a "&lt;p&gt;". If not, it still belongs to the previous paragraph!   This still belongs to the first paragraph. <nowiki><br/></nowiki> As this sentence is as well! */ Consider using &lt; for < and &gt; for >, as shown in the example above.

Line Break: <br/>

This tag marks up a line break within the same paragraph. Consider line breaks and empty lines in the idl file do not cause a line break or a paragraph break when presented by the HTML browser. Explicit paragraph break markups are necessary.

Unordered List: <ul><li> ... </li>... </ul>

These tags mark the beginning and end of an unordered list, as list items.

Example:

<ul>
    <li>the first item </li>
    <li>the second item </li>
    <li>the third item </li>
 </ul>

results in a list similar to:

• the first item
• the second item
• the third item

Ordered List: <ol><li> ... </li>... </ol>

These tags mark the beginning and end of an ordered list, as list items.

Example:

<ol>
    <li>the first item </li>
    <li>the second item </li>
    <li>the third item </li>
 </ol>

results in a list similar to:

1.the first item

2.the second item

3.the third item

Definition List: <dl><dt> ... </dt><dd> ... </dd>... </dl>

These tags mark the beginning and end of a definition list, the definition tags and the definition data.

Example:

<dl>
    <dt>the first item</dt>
    <dd>asfd asdf asdf asdf asdf</dd>
 
    <dt>the second item</dt>
    <dd>asfd asdf asdf asdf asdf</dd>
 
    <dt>the third item</dt>
    <dd>asfd asdf asdf asdf asdf</dd>
 </dl>

results in a list similar to:

the first item

asfd asdf asdf asdf asdf

the second item

asfd asdf asdf asdf asdf

the third item

asfd asdf asdf asdf asdf

Table: <table><tr><td>...</td>...</tr>...</table>

Defines a table with rows (tr) and columns (td).

Strong Emphasis: <strong> ... </strong>

These tags present a piece of text that is emphasized. In most cases this is bold, but the HTML-client defines what it actually is.

Slight Emphasis: <em> ... </em>

These tags present a piece of text emphasized slightly. In most cases this is italic, but the HTML-client defines what it actually is .

Anchor: <a href="..."> ... </a>

These tags specify a link to external documentation. The first "..." specifies the URL.

Content on this page is licensed under the Public Documentation License (PDL).