DITA XML.org is the official community gathering place and information resource for the DITA OASIS Standard, an XML architecture for designing, writing, managing, and publishing information. We encourage you to contribute content to this site.

Increase Publishing Efficiency from Author to Customer - Presented by Mark Poston

Location: 
http://www.x-pubs.com/site/news/1625/
Date: 
2 Apr 2009 - 15:00
Event Type: 
Conference

Michael Priestley

DITA doclet - generate DITA API format docs from Java source

This article got published on developerWorks last month:

http://www.ibm.com/developerworks/xml/library/x-DITAdoclet/

This should be of interest to anyone who has generated Javadoc in the past but wished they could get a more semantic, reprocessable format output instead. The doclet produces content using the DITA API specialization, which can be processed with the DITA Open Toolkit. Note that it includes the actual doclet code in the resources section, so you can try this yourself at home.

Read more

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

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