Coding a page of Weblinks

[barleytwist]

I have a Joomla! site and the Weblinks page (a page listing external sites and a short description of that site) uses a table structure. I am not convinced this is the best way as all we need is say a heading (h2) and then a decsriptive para. The heading is the link to the external site.

Would anyone comment on the best accessible way to show these (i.e. is there an accepted way of doing this as I think tables are for data)?

[Dan Schulz]

It sounds like a definition list may be in order. The "defining" term could be the link, and then the "definition" could be the description. Well, it would be if you were using HTML 5.

With HTML 4.01 and XHTML 1.0, you'll be best off with an unordered list that contains a heading and a paragraph for the link and description.

[barleytwist]

I did wonder about the list but where would the h2 go?

Are you suggesting ul, li <a> for each link and then <p> for the description?

Surely h2 <a> (or would it be <a> h2), p repeated each time is more realistic?

[Dan Schulz]

This.

<li>
    <h2><a href="#">Link text</a></h2>
    <p>Descriptive text.</p>
</li>

[C. Ankerstjerne]

Semantically, there is nothing wrong with using a definition list in HTML 4.01 either. The HTML 4.01 specification allows the use of definition lists for other purposes that just defining terms.

[AlexDawson]

I agree with the definition list syntax, It makes a lot more semantic sense.

<dl>
    <dt><a href="#">Link text</a></dt>
    <dd>Descriptive text.</dd>
</dl>