Useful XHTML Tags

From Apache OpenOffice Wiki
< Documentation‎ | DevGuide
Revision as of 00:09, 15 June 2014 by JZA (Talk | contribs)

Jump to: navigation, search



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.

Documentation caution.png 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).
Personal tools
In other languages