Category Archives: Uncategorized

Presentation at the Dokumentinfo Conference

I held a presentation on addresses and naming of resources in document management at the Teknisk Dokumentation 2010 conference (Swedish-laguage link; sorry) last week. The conference now stands out among the ones I’ve attended lately due to the fact that there was a power outage during the afternoon of the first conference day (leading to some rather different presentations).

I also learned a lot. Olaf Drummer’s presentation about the PDF/A format, especially the coming PDF/A-3 standard, gave me a few ideas that I intend to implement.

DITA Lists, Part Two

Today it occurred me to have a look at the DITA Architecture Specification source to see how the people behind the spec would tag a list; as some of you know, this was the subject of my recent blog entry. There are a number of lists in that spec, many with introductory paragraphs, so it’s a pretty obvious way to find out, right? Well, after the examples in that spec, maybe.

Anyway, this is how they do it:

<p>Introductory para:
<ul>
<li>Item</li>
<li>Item</li>
</ul>
</p>

This was one of my guesses, and I have to say that it’s better than any of the alternatives I could come up with. It’s not good markup, though, in my opinion, as it says that semantically, a paragraph is sort of a block-level superclass, a do-it-all and one that you must use if you need that introduction.

But then, why limit yourself to lists? Why aren’t notes tagged like that? Or definition lists, or images, or tables? Think about it. Doesn’t this feel just a little bit like a cop-out to you? It does to me. It feels like the author realised that he needed that wrapper but there was nothing he could cling to, other than this construction.

I’m not saying that my way is the only way (obviously it’s not) but this bothers me because it muddies the semantic waters.