Increase Publishing Efficiency from Author to Customer - Presented by Mark Poston
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.
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