[publican-list] RFC: XSLT Enhancements for <task>

[Jared Morgan]

Up until now, I've been using <procedure> with <para> tags containing an overview of the procedure, and any prerequisites the reader needs to complete before continuing.

A colleague recently told me that there was a <task> element that provides better structure for procedure metadata (see Task_RFC_Structure).  

I've tried it out, and it works pretty well in publican now (see Task_RFC_Output_Current, tested on the Publican-JBoss brand).  

To bring it in line with how Procedures, Figures, and Tables are formatted, I propose the following enhancements:

* Prefix the task title with "Task cc.n" (where "cc" is the chapter number the procedure is contained in, and "n" is the number of the task).
* If <tasksummary> is used, auto-generate a "Summary" title, unless the <title> tag is explicitly used.
* If <taskprerequisites> is used, auto-generate a "Prerequisites" title, unless the <title> tag is explicitly used.
* Indent the <task> similar to how <example> is indented with a solid line down the left margin (for a visual reference that the content block is all part of the one <task>) 

Task_RFC_Output_Desired shows an example of how this would look (minus the Indent and solid line).

Thoughts?

Jared Morgan
Content Author
Red Hat Asia Pacific
1/193 North Quay
BRISBANE QLD 4000

P: +61 7 3514 8242
M: +61 413 005 479

-------------- next part --------------
A non-text attachment was scrubbed...
Name: Task_RFC_Structure.png
Type: image/png
Size: 17349 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/publican-list/attachments/20110201/c4b1fdf4/attachment.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Task_RFC_Output_Current.png
Type: image/png
Size: 61097 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/publican-list/attachments/20110201/c4b1fdf4/attachment-0001.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Task_RFC_Output_Desired.png
Type: image/png
Size: 63402 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/publican-list/attachments/20110201/c4b1fdf4/attachment-0002.png>