A question was raised recently on the Yahoo! DITA Users mailing list relating to linking via a URL to a specific page in a collection of HTML. The requirement was for the target page to open within the "tri-pane" frameset so that the table of contents was visible.

A number of solutions were mooted, but Martin Polley eventually came up with a solution to fitted the particular requirement (but not necessarily all requirements).

Martin added a function to the top-level frameset of the collection. The function contained the following code:

Read more

The DITA Help Subcommittee is discussing a proposal to create a new <help-context> element to hold metadata required for context-sensitive Help. The proposal would see the new element fit under the <topicmeta> element in the ditamap, and/or in the <prolog> element in the topic. The element would hold context numbers and/or context strings, and/or a reference to a window description. (There would need to be a separate element in the ditamap that would store the characteristics of a window named in the context-help element.)

Read more

Last week at the WritersUA Conference in Portland, I chaired a "Developing Help with DITA" forum alongside Alan Houser, Matthew Ellison and Scott Prentice (all on the DITA Help Sub Committee). There was a lot of interest from delegates (the majority of whom are Help authors) in using DITA, although most are only 'testing the water'.

Read more

Until a few weeks ago, I was unaware that there was a company employing some 200 technical writers just two kilometres from where I teach technical communication in Melbourne, Australia.  Likewise, a manager at the company was unaware that my university provided post-graduate education in technical communication. We were operating in two parallel universes. The company involved operates in the "engineering technical publications" field, which seems to be quite separate (and isolated) from the "IT and corporate technical communication" field.

Read more

"Airplane Help" describes a technique whereby locally installed Help and server-based Help are integrated, so that a software application user is presented with server Help if he or she has an Internet connection, or local Help if not. The advantage of this approach is that the most current version of the Help is displayed if possible, but at least some form of Help is displayed when the user is "offline". Can DITA play a role in delivering Airplane Help?

Read more