Archive - Mar 2009

Date

attribution/source/byline

Some of the definitions in a definition-list have clearly-defined attributions, for example ISO. It seems logical, if the goal is to produced a set of structured and searchable files, to use something like

[dlentry]

[dt]name of term goes here[/dt]

[dd]definition of term goes here

[source]attribution goes here[/source]

[/dd]

[/dlentry]

[source] is clearly not the element to use here, though; nor is [author].

Any suggestions?

lists and their introductions

Typographically, a paragraph is one thing and a list is another - even if the content of the paragraph is nothing than more the lead-in to the list. That would suggest something like [paragraph] [/paragraph] [ul] [/ul]

Logically, the introductory paragraph and the list form a unit of information. That would suggest something like [paragraph] [ul] [/ul] [/paragraph].

The 1.1 language spec. I have to hand appears to allow both. What do you experienced users think?

xhtml customization re <pre class="codeblock">

What do I have  to do to change

<pre class="codeblock"> 

in xhtml output to be:

<pre class="prettyprint">  ?

I want to do this in order to use the Javascript code prettifier to format code. I have args.hdf set to write the script call in, and the args.css set for the style sheet, but I am not sure which template I need to copy into my custom .xsl to change the actual tag in the xhtml.

Fast solutions appreciated. ;-)

Julia

Does DITA work well for technical support documents?

Hello group, forgive me if I'm posting in the wrong location. Not sure where this would belong.

I am a student enrolled in the Technical and Professional Writing program at San Francisco State and am writing a white paper about DITA.

The goal of my paper is to determine whether using DITA to create technical support documents is a successful solution and to what degree (i.e. some content works better than other content, pros vs. cons, etc.).

Read more

DITA Open Toolkit Workshop: Making it Work for You (Vancouver)

Location: 
Vancouver, Canada
Date: 
21 Apr 2009 - 09:00 - 23 Apr 2009 - 16:30
Event Type: 
Training Class
XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I