[NeXus-committee] Introduction in Docbook format

Peterson, Peter F. petersonpf at ornl.gov
Thu Oct 28 20:30:12 BST 2010


Ray,

All of docbook is done through stylesheets (xslt) to generate most
everything. In addition you can add a stylesheet assuming that Freddie
configures the wiki to pick it up correctly. I think the better thing to
do is work out a stylesheet for the html generated from docbook that way
all of the pages get the improved formatting.

P^2

On 10/28/10 11:58 AM, "Ray Osborn" <rosborn at anl.gov> wrote:

>I got no response to my rant last week about how unreadable the new
>Docbook version of the introduction is - not illegible, just very
>unpleasant to look at. I see that some of the non-printing characters
>seem to be okay now, but my complaint still remains.
>
>Unless I hear any objections, I will revert the introduction back to old
>wiki form, which is much more attractive to read. I will try to update it
>with any changes in the text in the Docbook version.
>
>I am not suggesting that we abandon Docbook for the main documentation,
>but style matters. People who are coming to NeXus for the first time will
>want to see an introduction that is reasonably attractively formatted and
>pleasant to read. In the long term, does anyone who knows more about
>Docbook than me know if it is possible to attach stylesheets to the HTML
>output (and to the printed form), because that might be a longer term
>solution? Manuals don't have to look boring.
>
>Best regards,
>Ray
>-- 
>Ray Osborn
>Materials Science Division
>Argonne National Laboratory
>Argonne, IL 60439, USA
>Phone: +1 (630) 252-9011
>Email: ROsborn at anl.gov
>
>
>
>
>_______________________________________________
>NeXus-committee mailing list
>NeXus-committee at nexusformat.org
>http://lists.nexusformat.org/mailman/listinfo/nexus-committee




More information about the NeXus-committee mailing list